@indexnetwork/protocol 4.3.2 → 4.3.4-rc.309.1

package/dist/premise/premise.graph.d.ts

@@ -1,3 +1,4 @@
+import type { PremiseAnalyzerOutput } from "./premise.analyzer.js";
 import { PremiseIndexer } from "./premise.indexer.js";
 import type { PremiseGraphDatabase, PremiseAnalysis } from "../shared/interfaces/database.interface.js";
 import type { Embedder } from "../shared/interfaces/embedder.interface.js";
@@ -9,7 +10,10 @@ export declare class PremiseGraphFactory {
     private database;
     private embedder;
     private premiseIndexer;
-    constructor(database: PremiseGraphDatabase, embedder: Embedder, premiseIndexer?: PremiseIndexer);
+    private premiseAnalyzer;
+    constructor(database: PremiseGraphDatabase, embedder: Embedder, premiseIndexer?: PremiseIndexer, premiseAnalyzer?: {
+        invoke(premiseText: string, profileContext?: string): Promise<PremiseAnalyzerOutput>;
+    });
     /**
      * Compiles and returns the premise lifecycle graph.
      *
@@ -26,6 +30,8 @@ export declare class PremiseGraphFactory {
         provenanceSourceId: string | undefined;
         provenanceConfidence: number | undefined;
         operationMode: "query" | "update" | "create";
+        scopeType: "network" | undefined;
+        scopeId: string | undefined;
         networkScopeId: string | undefined;
         targetPremiseId: string | undefined;
         analysis: PremiseAnalysis | undefined;
@@ -58,6 +64,8 @@ export declare class PremiseGraphFactory {
         provenanceSourceId?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
         provenanceConfidence?: number | import("@langchain/langgraph").OverwriteValue<number | undefined> | undefined;
         operationMode?: "query" | "update" | "create" | import("@langchain/langgraph").OverwriteValue<"query" | "update" | "create"> | undefined;
+        scopeType?: "network" | import("@langchain/langgraph").OverwriteValue<"network" | undefined> | undefined;
+        scopeId?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
         networkScopeId?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
         targetPremiseId?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
         analysis?: PremiseAnalysis | import("@langchain/langgraph").OverwriteValue<PremiseAnalysis | undefined> | undefined;
@@ -105,6 +113,8 @@ export declare class PremiseGraphFactory {
         provenanceSourceId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         provenanceConfidence: import("@langchain/langgraph").BaseChannel<number | undefined, number | import("@langchain/langgraph").OverwriteValue<number | undefined> | undefined, unknown>;
         operationMode: import("@langchain/langgraph").BaseChannel<"query" | "update" | "create", "query" | "update" | "create" | import("@langchain/langgraph").OverwriteValue<"query" | "update" | "create">, unknown>;
+        scopeType: import("@langchain/langgraph").BaseChannel<"network" | undefined, "network" | import("@langchain/langgraph").OverwriteValue<"network" | undefined> | undefined, unknown>;
+        scopeId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         networkScopeId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         targetPremiseId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         analysis: import("@langchain/langgraph").BaseChannel<PremiseAnalysis | undefined, PremiseAnalysis | import("@langchain/langgraph").OverwriteValue<PremiseAnalysis | undefined> | undefined, unknown>;
@@ -163,6 +173,8 @@ export declare class PremiseGraphFactory {
         provenanceSourceId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         provenanceConfidence: import("@langchain/langgraph").BaseChannel<number | undefined, number | import("@langchain/langgraph").OverwriteValue<number | undefined> | undefined, unknown>;
         operationMode: import("@langchain/langgraph").BaseChannel<"query" | "update" | "create", "query" | "update" | "create" | import("@langchain/langgraph").OverwriteValue<"query" | "update" | "create">, unknown>;
+        scopeType: import("@langchain/langgraph").BaseChannel<"network" | undefined, "network" | import("@langchain/langgraph").OverwriteValue<"network" | undefined> | undefined, unknown>;
+        scopeId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         networkScopeId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         targetPremiseId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         analysis: import("@langchain/langgraph").BaseChannel<PremiseAnalysis | undefined, PremiseAnalysis | import("@langchain/langgraph").OverwriteValue<PremiseAnalysis | undefined> | undefined, unknown>;

package/dist/premise/premise.graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"premise.graph.d.ts","sourceRoot":"/","sources":["premise/premise.graph.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAItD,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AACxG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4CAA4C,CAAC;AAG3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AA6BtE;;GAEG;AACH,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,cAAc;gBAFd,QAAQ,EAAE,oBAAoB,EAC9B,QAAQ,EAAE,QAAQ,EAClB,cAAc,GAAE,cAAqC;IAG/D;;;;OAIG;IACI,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAgK0B,MAAM;gCAAkB,MAAM;;;;;CA6F3E"}
+{"version":3,"file":"premise.graph.d.ts","sourceRoot":"/","sources":["premise/premise.graph.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAKtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AACxG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4CAA4C,CAAC;AAG3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AA6BtE;;GAEG;AACH,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,eAAe;gBAHf,QAAQ,EAAE,oBAAoB,EAC9B,QAAQ,EAAE,QAAQ,EAClB,cAAc,GAAE,cAAqC,EACrD,eAAe,GAAE;QAAE,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAA;KAA0B;IAG3I;;;;OAIG;IACI,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAmK0B,MAAM;gCAAkB,MAAM;;;;;CA6F3E"}

package/dist/premise/premise.graph.js

@@ -4,6 +4,7 @@ import { PremiseAnalyzer } from "./premise.analyzer.js";
 import { PremiseIndexer } from "./premise.indexer.js";
 import { buildNetworkAssignmentDecision, resolveAssignmentNetworkScope } from "../shared/assignment/network-assignment.policy.js";
 import { getAbortSignalConfig } from "../shared/agent/model-signal.js";
+import { scopeFromNetworkId } from "../shared/agent/tool.scope.js";
 import { protocolLogger } from "../shared/observability/protocol.logger.js";
 import { timed } from "../shared/observability/performance.js";
 const logger = protocolLogger("PremiseGraphFactory");
@@ -36,10 +37,11 @@ function deriveProvenanceConfidence(analysis) {
  * Graph factory for premise lifecycle: create, update, and query modes.
  */
 export class PremiseGraphFactory {
-    constructor(database, embedder, premiseIndexer = new PremiseIndexer()) {
+    constructor(database, embedder, premiseIndexer = new PremiseIndexer(), premiseAnalyzer = new PremiseAnalyzer()) {
         this.database = database;
         this.embedder = embedder;
         this.premiseIndexer = premiseIndexer;
+        this.premiseAnalyzer = premiseAnalyzer;
     }
     /**
      * Compiles and returns the premise lifecycle graph.
@@ -47,7 +49,7 @@ export class PremiseGraphFactory {
      * @returns A compiled LangGraph graph handling create, update, and query modes.
      */
     createGraph() {
-        const analyzer = new PremiseAnalyzer();
+        const analyzer = this.premiseAnalyzer;
         const indexer = this.premiseIndexer;
         const queryNode = async (state) => {
             return timed("PremiseGraph.query", async () => {
@@ -183,12 +185,15 @@ export class PremiseGraphFactory {
                 if (!state.premise)
                     return {};
                 logger.verbose(`[PremiseGraph.index] Scoring premise against user networks`);
-                const membershipNetworkIds = await this.database.getAssignmentNetworkIdsForUser(state.userId);
+                const assignmentMemberships = await this.database.getAssignmentNetworkMembershipsForUser(state.userId);
+                const requestScope = state.scopeType && state.scopeId
+                    ? { scopeType: state.scopeType, scopeId: state.scopeId }
+                    : scopeFromNetworkId(state.networkScopeId);
                 const indexIds = resolveAssignmentNetworkScope({
-                    memberships: membershipNetworkIds,
-                    networkScopeId: state.networkScopeId,
+                    memberships: assignmentMemberships,
+                    ...requestScope,
                 });
-                const scope = state.networkScopeId ? "network" : "global";
+                const scope = requestScope.scopeType ? "network" : "global";
                 const assignments = [];
                 const agentTimings = [];
                 for (const networkId of indexIds) {

package/dist/premise/premise.graph.js.map

@@ -1 +1 @@
-{"version":3,"file":"premise.graph.js","sourceRoot":"/","sources":["premise/premise.graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,8BAA8B,EAAE,6BAA6B,EAAE,MAAM,mDAAmD,CAAC;AAClI,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAGvE,OAAO,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAC5E,OAAO,EAAE,KAAK,EAAE,MAAM,wCAAwC,CAAC;AAG/D,MAAM,MAAM,GAAG,cAAc,CAAC,qBAAqB,CAAC,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,0BAA0B,GAAG,CAAC,GAAG,EAAE;IACvC,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IACzD,OAAO,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAClE,CAAC,CAAC,EAAE,CAAC;AAEL;;;;GAIG;AACH,SAAS,0BAA0B,CAAC,QAAqC;IACvE,IAAI,CAAC,QAAQ;QAAE,OAAO,GAAG,CAAC;IAC1B,MAAM,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,GAAG,QAAQ,CAAC;IAC3E,MAAM,IAAI,GAAG,CAAC,iBAAiB,GAAG,iBAAiB,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAC3E,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC;IACvC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,mBAAmB;IAC9B,YACU,QAA8B,EAC9B,QAAkB,EAClB,iBAAiC,IAAI,cAAc,EAAE;QAFrD,aAAQ,GAAR,QAAQ,CAAsB;QAC9B,aAAQ,GAAR,QAAQ,CAAU;QAClB,mBAAc,GAAd,cAAc,CAAuC;IAC5D,CAAC;IAEJ;;;;OAIG;IACI,WAAW;QAChB,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC;QAEpC,MAAM,SAAS,GAAG,KAAK,EAAE,KAAqC,EAAE,EAAE;YAChE,OAAO,KAAK,CAAC,oBAAoB,EAAE,KAAK,IAAI,EAAE;gBAC5C,MAAM,CAAC,OAAO,CAAC,mDAAmD,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;gBAClF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;gBAChF,OAAO;oBACL,UAAU,EAAE;wBACV,QAAQ;wBACR,KAAK,EAAE,QAAQ,CAAC,MAAM;qBACvB;iBACF,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,MAAM,WAAW,GAAG,KAAK,EAAE,KAAqC,EAAE,EAAE;YAClE,OAAO,KAAK,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;gBAC9C,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;oBACzB,OAAO,EAAE,KAAK,EAAE,kDAAkD,EAAE,CAAC;gBACvE,CAAC;gBAED,MAAM,CAAC,OAAO,CAAC,sCAAsC,KAAK,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;gBAEjG,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBACzB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;gBAC1D,MAAM,MAAM,GAAmB;oBAC7B,IAAI,EAAE,kBAAkB;oBACxB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;iBAC/B,CAAC;gBAEF,MAAM,QAAQ,GAAoB;oBAChC,aAAa,EAAE,MAAM,CAAC,aAAa;oBACnC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;oBAC3C,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;oBAC3C,eAAe,EAAE,MAAM,CAAC,eAAe;oBACvC,eAAe,EAAE,MAAM,CAAC,eAAe;iBACxC,CAAC;gBAEF,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9C,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,MAAM,SAAS,GAAG,KAAK,EAAE,KAAqC,EAAE,EAAE;YAChE,OAAO,KAAK,CAAC,oBAAoB,EAAE,KAAK,IAAI,EAAE;gBAC5C,IAAI,KAAK,CAAC,KAAK;oBAAE,OAAO,EAAE,CAAC;gBAE3B,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;oBACzB,OAAO,EAAE,KAAK,EAAE,yCAAyC,EAAE,CAAC;gBAC9D,CAAC;gBAED,MAAM,CAAC,OAAO,CAAC,uDAAuD,CAAC,CAAC;gBAExE,gFAAgF;gBAChF,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,aAAa,EAAE,SAAS,EAAE,oBAAoB,EAAE,CAAa,CAAC;gBACnH,OAAO,EAAE,SAAS,EAAE,CAAC;YACvB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,4DAA4D;QAC5D,kCAAkC;QAClC,+EAA+E;QAC/E,+EAA+E;QAC/E,+EAA+E;QAC/E,iFAAiF;QACjF,4DAA4D;QAC5D,MAAM,UAAU,GAAG,KAAK,EAAE,KAAqC,EAAE,EAAE;YACjE,OAAO,KAAK,CAAC,qBAAqB,EAAE,KAAK,IAAI,EAAE;gBAC7C,IAAI,KAAK,CAAC,KAAK;oBAAE,OAAO,EAAE,CAAC;gBAC3B,IAAI,KAAK,CAAC,aAAa,KAAK,QAAQ;oBAAE,OAAO,EAAE,CAAC;gBAChD,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO,EAAE,CAAC;gBAChE,IAAI,OAAO,IAAI,CAAC,QAAQ,CAAC,wBAAwB,KAAK,UAAU;oBAAE,OAAO,EAAE,CAAC;gBAE5E,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,wBAAwB,CAAC;oBACzD,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,SAAS,EAAE,KAAK,CAAC,SAAS;oBAC1B,SAAS,EAAE,0BAA0B;iBACtC,CAAC,CAAC;gBAEH,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,CAAC,OAAO,CACZ,6DAA6D,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,0BAA0B,gBAAgB,KAAK,CAAC,SAAS,EAAE,CAC3J,CAAC;oBACF,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;gBAChC,CAAC;gBACD,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,MAAM,WAAW,GAAG,KAAK,EAAE,KAAqC,EAAE,EAAE;YAClE,OAAO,KAAK,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;gBAC9C,IAAI,KAAK,CAAC,KAAK;oBAAE,OAAO,EAAE,CAAC;gBAE3B,IAAI,KAAK,CAAC,aAAa,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC;oBAC/D,OAAO,EAAE,KAAK,EAAE,6CAA6C,EAAE,CAAC;gBAClE,CAAC;gBAED,IAAI,KAAK,CAAC,aAAa,KAAK,QAAQ,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;oBAC9D,MAAM,CAAC,OAAO,CAAC,2CAA2C,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC;oBAEnF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,eAAe,EAAE;wBACvE,SAAS,EAAE;4BACT,IAAI,EAAE,KAAK,CAAC,aAAc;4BAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;yBACjB;wBACD,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,SAAS;wBACrC,QAAQ,EAAE;4BACR,SAAS,EAAE,KAAK,CAAC,SAAS;4BAC1B,UAAU,EAAE,KAAK,CAAC,UAAU;4BAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;yBACzB;wBACD,SAAS,EAAE,KAAK,CAAC,SAAS;qBAC3B,CAAC,CAAC;oBACH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;gBAC9B,CAAC;gBAED,MAAM,CAAC,OAAO,CAAC,wDAAwD,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;gBAEvF,6EAA6E;gBAC7E,6EAA6E;gBAC7E,uEAAuE;gBACvE,kDAAkD;gBAClD,MAAM,iBAAiB,GAAG,0BAA0B,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBACrE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;oBAChD,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,SAAS,EAAE;wBACT,IAAI,EAAE,KAAK,CAAC,aAAc;wBAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;qBACjB;oBACD,UAAU,EAAE;wBACV,MAAM,EAAE,KAAK,CAAC,gBAAgB,IAAI,UAAU;wBAC5C,QAAQ,EAAE,KAAK,CAAC,kBAAkB;wBAClC,UAAU,EAAE,KAAK,CAAC,oBAAoB,IAAI,iBAAiB;wBAC3D,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;qBACpC;oBACD,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,SAAS;oBACrC,QAAQ,EAAE;wBACR,SAAS,EAAE,KAAK,CAAC,SAAS;wBAC1B,UAAU,EAAE,KAAK,CAAC,UAAU;wBAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;qBACzB;oBACD,SAAS,EAAE,KAAK,CAAC,SAAS;iBAC3B,CAAC,CAAC;gBACH,OAAO,EAAE,OAAO,EAAE,CAAC;YACrB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,MAAM,SAAS,GAAG,KAAK,EAAE,KAAqC,EAAE,EAAE;YAChE,OAAO,KAAK,CAAC,oBAAoB,EAAE,KAAK,IAAI,EAAE;gBAC5C,IAAI,CAAC,KAAK,CAAC,OAAO;oBAAE,OAAO,EAAE,CAAC;gBAE9B,MAAM,CAAC,OAAO,CAAC,4DAA4D,CAAC,CAAC;gBAE7E,MAAM,oBAAoB,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,8BAA8B,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBAC9F,MAAM,QAAQ,GAAG,6BAA6B,CAAC;oBAC7C,WAAW,EAAE,oBAAoB;oBACjC,cAAc,EAAE,KAAK,CAAC,cAAc;iBACrC,CAAC,CAAC;gBACH,MAAM,KAAK,GAAG,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;gBAC1D,MAAM,WAAW,GAAyD,EAAE,CAAC;gBAC7E,MAAM,YAAY,GAAqB,EAAE,CAAC;gBAE1C,KAAK,MAAM,SAAS,IAAI,QAAQ,EAAE,CAAC;oBACjC,IAAI,CAAC;wBACH,MAAM,iBAAiB,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,2BAA2B,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;wBACnG,IAAI,CAAC,iBAAiB;4BAAE,SAAS;wBACjC,MAAM,WAAW,GAAG,iBAAiB,CAAC,WAAW,CAAC;wBAClD,MAAM,YAAY,GAAG,iBAAiB,CAAC,YAAY,CAAC;wBACpD,MAAM,UAAU,GAAG,CAAC,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC;wBACnE,IAAI,SAAoE,CAAC;wBACzE,IAAI,MAA0B,CAAC;wBAE/B,IAAI,UAAU,EAAE,CAAC;4BACf,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;4BACzB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC;gCAClC,WAAW,EAAE,KAAK,CAAC,aAAc;gCACjC,WAAW,EAAE,WAAW,IAAI,EAAE;gCAC9B,YAAY,EAAE,YAAY,IAAI,SAAS;6BACxC,CAAC,CAAC;4BACH,MAAM,MAAM,GAAmB;gCAC7B,IAAI,EAAE,iBAAiB;gCACvB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;6BAC/B,CAAC;4BACF,SAAS,GAAG,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;4BAC/E,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC;4BAC1B,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;wBAC5B,CAAC;wBAED,MAAM,QAAQ,GAAG,8BAA8B,CAAC;4BAC9C,YAAY,EAAE,SAAS;4BACvB,IAAI,EAAE,WAAW;4BACjB,KAAK;4BACL,WAAW;4BACX,YAAY;4BACZ,SAAS;4BACT,SAAS,EAAE,iBAAiB;4BAC5B,MAAM,EAAE,eAAe;4BACvB,MAAM;4BACN,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;yBACpC,CAAC,CAAC;wBAEH,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;4BACtB,MAAM,IAAI,CAAC,QAAQ,CAAC,sBAAsB,CACxC,KAAK,CAAC,OAAO,CAAC,EAAE,EAChB,SAAS,EACT,QAAQ,CAAC,UAAU,EACnB,QAAQ,CAAC,QAAQ,CAClB,CAAC;4BACF,WAAW,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,cAAc,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;wBACvE,CAAC;oBACH,CAAC;oBAAC,OAAO,GAAG,EAAE,CAAC;wBACb,MAAM,CAAC,OAAO,CAAC,gDAAgD,SAAS,eAAe,GAAG,EAAE,CAAC,CAAC;oBAChG,CAAC;gBACH,CAAC;gBAED,MAAM,CAAC,OAAO,CAAC,oCAAoC,WAAW,CAAC,MAAM,WAAW,CAAC,CAAC;gBAElF,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC;YAC3D,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,MAAM,WAAW,GAAG,CAAC,KAAqC,EAAE,EAAE;YAC5D,IAAI,KAAK,CAAC,KAAK;gBAAE,OAAO,KAAK,CAAC;YAC9B,IAAI,KAAK,CAAC,aAAa,KAAK,OAAO;gBAAE,OAAO,OAAO,CAAC;YACpD,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC;QAEF,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,iBAAiB,CAAC;aAC5C,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC;aAC3B,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC;aAC/B,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC;aAC3B,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC;aAC7B,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC;aAC/B,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC;aAC3B,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE;YACvC,KAAK,EAAE,OAAO;YACd,OAAO,EAAE,SAAS;YAClB,GAAG,EAAE,GAAG;SACT,CAAC;aACD,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;aACrB,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC;aAC3B,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC;YAC3B,0EAA0E;aACzE,mBAAmB,CAAC,QAAQ,EAAE,CAAC,KAAqC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;YACjH,OAAO,EAAE,SAAS;YAClB,GAAG,EAAE,GAAG;SACT,CAAC;aACD,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC;aAC3B,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAEzB,OAAO,KAAK,CAAC,OAAO,EAAE,CAAC;IACzB,CAAC;CACF","sourcesContent":["import { StateGraph, START, END } from \"@langchain/langgraph\";\n\nimport { PremiseGraphState } from \"./premise.state.js\";\nimport { PremiseAnalyzer } from \"./premise.analyzer.js\";\nimport { PremiseIndexer } from \"./premise.indexer.js\";\n\nimport { buildNetworkAssignmentDecision, resolveAssignmentNetworkScope } from \"../shared/assignment/network-assignment.policy.js\";\nimport { getAbortSignalConfig } from \"../shared/agent/model-signal.js\";\nimport type { PremiseGraphDatabase, PremiseAnalysis } from \"../shared/interfaces/database.interface.js\";\nimport type { Embedder } from \"../shared/interfaces/embedder.interface.js\";\nimport { protocolLogger } from \"../shared/observability/protocol.logger.js\";\nimport { timed } from \"../shared/observability/performance.js\";\nimport type { DebugMetaAgent } from \"../chat/chat-streaming.types.js\";\n\nconst logger = protocolLogger(\"PremiseGraphFactory\");\n\n/**\n * Minimum cosine similarity (0-1) at which a freshly-decomposed premise is treated\n * as a near-duplicate of an existing ACTIVE premise for the same user and skipped\n * on create. Tuned high so genuine paraphrases collapse while distinct facts (e.g.\n * \"I work at Google\" vs \"I worked at Google\") still persist. Override with\n * PREMISE_DEDUP_SIMILARITY.\n */\nconst DEDUP_SIMILARITY_THRESHOLD = (() => {\n  const raw = Number(process.env.PREMISE_DEDUP_SIMILARITY);\n  return Number.isFinite(raw) && raw > 0 && raw <= 1 ? raw : 0.93;\n})();\n\n/**\n * Derive a premise provenance confidence (0-1) from the analyzer's felicity scores.\n * Averages authority, sincerity, and clarity — the dimensions that speak to how\n * trustworthy the self-assertion is. Falls back to 1.0 when no analysis is present.\n */\nfunction deriveProvenanceConfidence(analysis: PremiseAnalysis | undefined): number {\n  if (!analysis) return 1.0;\n  const { felicityAuthority, felicitySincerity, felicityClarity } = analysis;\n  const mean = (felicityAuthority + felicitySincerity + felicityClarity) / 3;\n  if (!Number.isFinite(mean)) return 1.0;\n  return Math.min(1, Math.max(0, mean));\n}\n\n/**\n * Graph factory for premise lifecycle: create, update, and query modes.\n */\nexport class PremiseGraphFactory {\n  constructor(\n    private database: PremiseGraphDatabase,\n    private embedder: Embedder,\n    private premiseIndexer: PremiseIndexer = new PremiseIndexer(),\n  ) {}\n\n  /**\n   * Compiles and returns the premise lifecycle graph.\n   *\n   * @returns A compiled LangGraph graph handling create, update, and query modes.\n   */\n  public createGraph() {\n    const analyzer = new PremiseAnalyzer();\n    const indexer = this.premiseIndexer;\n\n    const queryNode = async (state: typeof PremiseGraphState.State) => {\n      return timed(\"PremiseGraph.query\", async () => {\n        logger.verbose(`[PremiseGraph.query] Fetching premises for user ${state.userId}`);\n        const premises = await this.database.getPremisesForUser(state.userId, 'ACTIVE');\n        return {\n          readResult: {\n            premises,\n            count: premises.length,\n          },\n        };\n      });\n    };\n\n    const analyzeNode = async (state: typeof PremiseGraphState.State) => {\n      return timed(\"PremiseGraph.analyze\", async () => {\n        if (!state.assertionText) {\n          return { error: \"assertionText is required for create/update mode\" };\n        }\n\n        logger.verbose(`[PremiseGraph.analyze] Analyzing: \"${state.assertionText.substring(0, 50)}...\"`);\n\n        const start = Date.now();\n        const result = await analyzer.invoke(state.assertionText);\n        const timing: DebugMetaAgent = {\n          name: \"premise-analyzer\",\n          durationMs: Date.now() - start,\n        };\n\n        const analysis: PremiseAnalysis = {\n          speechActType: result.speechActType,\n          felicityAuthority: result.felicityAuthority,\n          felicitySincerity: result.felicitySincerity,\n          felicityClarity: result.felicityClarity,\n          semanticEntropy: result.semanticEntropy,\n        };\n\n        return { analysis, agentTimings: [timing] };\n      });\n    };\n\n    const embedNode = async (state: typeof PremiseGraphState.State) => {\n      return timed(\"PremiseGraph.embed\", async () => {\n        if (state.error) return {};\n\n        if (!state.assertionText) {\n          return { error: \"assertionText is required for embedding\" };\n        }\n\n        logger.verbose(`[PremiseGraph.embed] Generating embedding for premise`);\n\n        // Embedder.generate returns number[] | number[][], cast for single string input\n        const embedding = await this.embedder.generate(state.assertionText, undefined, getAbortSignalConfig()) as number[];\n        return { embedding };\n      });\n    };\n\n    // ─────────────────────────────────────────────────────────\n    // NODE: Dedupe (create mode only)\n    // Skips persisting a near-duplicate of an existing ACTIVE premise for the same\n    // user. Re-running similar input (e.g. repeated enrichment) therefore does not\n    // accumulate near-identical premises. No-op for update mode, when no embedding\n    // is available, or when the adapter does not implement findSimilarActivePremise.\n    // ─────────────────────────────────────────────────────────\n    const dedupeNode = async (state: typeof PremiseGraphState.State) => {\n      return timed(\"PremiseGraph.dedupe\", async () => {\n        if (state.error) return {};\n        if (state.operationMode === 'update') return {};\n        if (!state.embedding || state.embedding.length === 0) return {};\n        if (typeof this.database.findSimilarActivePremise !== 'function') return {};\n\n        const match = await this.database.findSimilarActivePremise({\n          userId: state.userId,\n          embedding: state.embedding,\n          threshold: DEDUP_SIMILARITY_THRESHOLD,\n        });\n\n        if (match) {\n          logger.verbose(\n            `[PremiseGraph.dedupe] Skipping near-duplicate (similarity=${match.similarity.toFixed(3)} >= ${DEDUP_SIMILARITY_THRESHOLD}) of premise ${match.premiseId}`,\n          );\n          return { duplicateOf: match };\n        }\n        return {};\n      });\n    };\n\n    const persistNode = async (state: typeof PremiseGraphState.State) => {\n      return timed(\"PremiseGraph.persist\", async () => {\n        if (state.error) return {};\n\n        if (state.operationMode === 'update' && !state.targetPremiseId) {\n          return { error: \"targetPremiseId is required for update mode\" };\n        }\n\n        if (state.operationMode === 'update' && state.targetPremiseId) {\n          logger.verbose(`[PremiseGraph.persist] Updating premise ${state.targetPremiseId}`);\n\n          const updated = await this.database.updatePremise(state.targetPremiseId, {\n            assertion: {\n              text: state.assertionText!,\n              tier: state.tier,\n            },\n            analysis: state.analysis ?? undefined,\n            validity: {\n              validFrom: state.validFrom,\n              validUntil: state.validUntil,\n              volatile: state.volatile,\n            },\n            embedding: state.embedding,\n          });\n          return { premise: updated };\n        }\n\n        logger.verbose(`[PremiseGraph.persist] Creating new premise for user ${state.userId}`);\n\n        // Provenance confidence: prefer an explicit caller-supplied value; otherwise\n        // derive it from the analyzer's felicity scores (how authoritative, sincere,\n        // and clear the assertion is) rather than a blanket 1.0, so the stored\n        // provenance reflects per-premise signal quality.\n        const derivedConfidence = deriveProvenanceConfidence(state.analysis);\n        const premise = await this.database.createPremise({\n          userId: state.userId,\n          assertion: {\n            text: state.assertionText!,\n            tier: state.tier,\n          },\n          provenance: {\n            source: state.provenanceSource ?? 'explicit',\n            sourceId: state.provenanceSourceId,\n            confidence: state.provenanceConfidence ?? derivedConfidence,\n            timestamp: new Date().toISOString(),\n          },\n          analysis: state.analysis ?? undefined,\n          validity: {\n            validFrom: state.validFrom,\n            validUntil: state.validUntil,\n            volatile: state.volatile,\n          },\n          embedding: state.embedding,\n        });\n        return { premise };\n      });\n    };\n\n    const indexNode = async (state: typeof PremiseGraphState.State) => {\n      return timed(\"PremiseGraph.index\", async () => {\n        if (!state.premise) return {};\n\n        logger.verbose(`[PremiseGraph.index] Scoring premise against user networks`);\n\n        const membershipNetworkIds = await this.database.getAssignmentNetworkIdsForUser(state.userId);\n        const indexIds = resolveAssignmentNetworkScope({\n          memberships: membershipNetworkIds,\n          networkScopeId: state.networkScopeId,\n        });\n        const scope = state.networkScopeId ? \"network\" : \"global\";\n        const assignments: Array<{ networkId: string; relevancyScore: number }> = [];\n        const agentTimings: DebugMetaAgent[] = [];\n\n        for (const networkId of indexIds) {\n          try {\n            const assignmentContext = await this.database.getNetworkAssignmentContext(networkId, state.userId);\n            if (!assignmentContext) continue;\n            const indexPrompt = assignmentContext.indexPrompt;\n            const memberPrompt = assignmentContext.memberPrompt;\n            const hasPrompts = !!indexPrompt?.trim() || !!memberPrompt?.trim();\n            let rawScores: { indexScore?: number; memberScore?: number } | undefined;\n            let reason: string | undefined;\n\n            if (hasPrompts) {\n              const start = Date.now();\n              const result = await indexer.invoke({\n                premiseText: state.assertionText!,\n                indexPrompt: indexPrompt ?? \"\",\n                memberPrompt: memberPrompt ?? undefined,\n              });\n              const timing: DebugMetaAgent = {\n                name: \"premise-indexer\",\n                durationMs: Date.now() - start,\n              };\n              rawScores = { indexScore: result.indexScore, memberScore: result.memberScore };\n              reason = result.reasoning;\n              agentTimings.push(timing);\n            }\n\n            const decision = buildNetworkAssignmentDecision({\n              resourceType: \"premise\",\n              mode: \"automatic\",\n              scope,\n              indexPrompt,\n              memberPrompt,\n              rawScores,\n              evaluator: \"premise-indexer\",\n              source: \"premise-graph\",\n              reason,\n              createdAt: new Date().toISOString(),\n            });\n\n            if (decision.assigned) {\n              await this.database.assignPremiseToNetwork(\n                state.premise.id,\n                networkId,\n                decision.finalScore,\n                decision.metadata,\n              );\n              assignments.push({ networkId, relevancyScore: decision.finalScore });\n            }\n          } catch (err) {\n            logger.verbose(`[PremiseGraph.index] Failed to score network ${networkId}, skipping: ${err}`);\n          }\n        }\n\n        logger.verbose(`[PremiseGraph.index] Assigned to ${assignments.length} networks`);\n\n        return { networkAssignments: assignments, agentTimings };\n      });\n    };\n\n    const routeByMode = (state: typeof PremiseGraphState.State) => {\n      if (state.error) return \"end\";\n      if (state.operationMode === 'query') return \"query\";\n      return \"analyze\";\n    };\n\n    const graph = new StateGraph(PremiseGraphState)\n      .addNode(\"query\", queryNode)\n      .addNode(\"analyze\", analyzeNode)\n      .addNode(\"embed\", embedNode)\n      .addNode(\"dedupe\", dedupeNode)\n      .addNode(\"persist\", persistNode)\n      .addNode(\"index\", indexNode)\n      .addConditionalEdges(START, routeByMode, {\n        query: \"query\",\n        analyze: \"analyze\",\n        end: END,\n      })\n      .addEdge(\"query\", END)\n      .addEdge(\"analyze\", \"embed\")\n      .addEdge(\"embed\", \"dedupe\")\n      // A near-duplicate short-circuits straight to END (no persist, no index).\n      .addConditionalEdges(\"dedupe\", (state: typeof PremiseGraphState.State) => (state.duplicateOf ? \"end\" : \"persist\"), {\n        persist: \"persist\",\n        end: END,\n      })\n      .addEdge(\"persist\", \"index\")\n      .addEdge(\"index\", END);\n\n    return graph.compile();\n  }\n}\n"]}
+{"version":3,"file":"premise.graph.js","sourceRoot":"/","sources":["premise/premise.graph.ts"],"names":[],"mappings":"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","sourcesContent":["import { StateGraph, START, END } from \"@langchain/langgraph\";\n\nimport { PremiseGraphState } from \"./premise.state.js\";\nimport { PremiseAnalyzer } from \"./premise.analyzer.js\";\nimport type { PremiseAnalyzerOutput } from \"./premise.analyzer.js\";\nimport { PremiseIndexer } from \"./premise.indexer.js\";\n\nimport { buildNetworkAssignmentDecision, resolveAssignmentNetworkScope } from \"../shared/assignment/network-assignment.policy.js\";\nimport { getAbortSignalConfig } from \"../shared/agent/model-signal.js\";\nimport { scopeFromNetworkId } from \"../shared/agent/tool.scope.js\";\nimport type { PremiseGraphDatabase, PremiseAnalysis } from \"../shared/interfaces/database.interface.js\";\nimport type { Embedder } from \"../shared/interfaces/embedder.interface.js\";\nimport { protocolLogger } from \"../shared/observability/protocol.logger.js\";\nimport { timed } from \"../shared/observability/performance.js\";\nimport type { DebugMetaAgent } from \"../chat/chat-streaming.types.js\";\n\nconst logger = protocolLogger(\"PremiseGraphFactory\");\n\n/**\n * Minimum cosine similarity (0-1) at which a freshly-decomposed premise is treated\n * as a near-duplicate of an existing ACTIVE premise for the same user and skipped\n * on create. Tuned high so genuine paraphrases collapse while distinct facts (e.g.\n * \"I work at Google\" vs \"I worked at Google\") still persist. Override with\n * PREMISE_DEDUP_SIMILARITY.\n */\nconst DEDUP_SIMILARITY_THRESHOLD = (() => {\n  const raw = Number(process.env.PREMISE_DEDUP_SIMILARITY);\n  return Number.isFinite(raw) && raw > 0 && raw <= 1 ? raw : 0.93;\n})();\n\n/**\n * Derive a premise provenance confidence (0-1) from the analyzer's felicity scores.\n * Averages authority, sincerity, and clarity — the dimensions that speak to how\n * trustworthy the self-assertion is. Falls back to 1.0 when no analysis is present.\n */\nfunction deriveProvenanceConfidence(analysis: PremiseAnalysis | undefined): number {\n  if (!analysis) return 1.0;\n  const { felicityAuthority, felicitySincerity, felicityClarity } = analysis;\n  const mean = (felicityAuthority + felicitySincerity + felicityClarity) / 3;\n  if (!Number.isFinite(mean)) return 1.0;\n  return Math.min(1, Math.max(0, mean));\n}\n\n/**\n * Graph factory for premise lifecycle: create, update, and query modes.\n */\nexport class PremiseGraphFactory {\n  constructor(\n    private database: PremiseGraphDatabase,\n    private embedder: Embedder,\n    private premiseIndexer: PremiseIndexer = new PremiseIndexer(),\n    private premiseAnalyzer: { invoke(premiseText: string, profileContext?: string): Promise<PremiseAnalyzerOutput> } = new PremiseAnalyzer(),\n  ) {}\n\n  /**\n   * Compiles and returns the premise lifecycle graph.\n   *\n   * @returns A compiled LangGraph graph handling create, update, and query modes.\n   */\n  public createGraph() {\n    const analyzer = this.premiseAnalyzer;\n    const indexer = this.premiseIndexer;\n\n    const queryNode = async (state: typeof PremiseGraphState.State) => {\n      return timed(\"PremiseGraph.query\", async () => {\n        logger.verbose(`[PremiseGraph.query] Fetching premises for user ${state.userId}`);\n        const premises = await this.database.getPremisesForUser(state.userId, 'ACTIVE');\n        return {\n          readResult: {\n            premises,\n            count: premises.length,\n          },\n        };\n      });\n    };\n\n    const analyzeNode = async (state: typeof PremiseGraphState.State) => {\n      return timed(\"PremiseGraph.analyze\", async () => {\n        if (!state.assertionText) {\n          return { error: \"assertionText is required for create/update mode\" };\n        }\n\n        logger.verbose(`[PremiseGraph.analyze] Analyzing: \"${state.assertionText.substring(0, 50)}...\"`);\n\n        const start = Date.now();\n        const result = await analyzer.invoke(state.assertionText);\n        const timing: DebugMetaAgent = {\n          name: \"premise-analyzer\",\n          durationMs: Date.now() - start,\n        };\n\n        const analysis: PremiseAnalysis = {\n          speechActType: result.speechActType,\n          felicityAuthority: result.felicityAuthority,\n          felicitySincerity: result.felicitySincerity,\n          felicityClarity: result.felicityClarity,\n          semanticEntropy: result.semanticEntropy,\n        };\n\n        return { analysis, agentTimings: [timing] };\n      });\n    };\n\n    const embedNode = async (state: typeof PremiseGraphState.State) => {\n      return timed(\"PremiseGraph.embed\", async () => {\n        if (state.error) return {};\n\n        if (!state.assertionText) {\n          return { error: \"assertionText is required for embedding\" };\n        }\n\n        logger.verbose(`[PremiseGraph.embed] Generating embedding for premise`);\n\n        // Embedder.generate returns number[] | number[][], cast for single string input\n        const embedding = await this.embedder.generate(state.assertionText, undefined, getAbortSignalConfig()) as number[];\n        return { embedding };\n      });\n    };\n\n    // ─────────────────────────────────────────────────────────\n    // NODE: Dedupe (create mode only)\n    // Skips persisting a near-duplicate of an existing ACTIVE premise for the same\n    // user. Re-running similar input (e.g. repeated enrichment) therefore does not\n    // accumulate near-identical premises. No-op for update mode, when no embedding\n    // is available, or when the adapter does not implement findSimilarActivePremise.\n    // ─────────────────────────────────────────────────────────\n    const dedupeNode = async (state: typeof PremiseGraphState.State) => {\n      return timed(\"PremiseGraph.dedupe\", async () => {\n        if (state.error) return {};\n        if (state.operationMode === 'update') return {};\n        if (!state.embedding || state.embedding.length === 0) return {};\n        if (typeof this.database.findSimilarActivePremise !== 'function') return {};\n\n        const match = await this.database.findSimilarActivePremise({\n          userId: state.userId,\n          embedding: state.embedding,\n          threshold: DEDUP_SIMILARITY_THRESHOLD,\n        });\n\n        if (match) {\n          logger.verbose(\n            `[PremiseGraph.dedupe] Skipping near-duplicate (similarity=${match.similarity.toFixed(3)} >= ${DEDUP_SIMILARITY_THRESHOLD}) of premise ${match.premiseId}`,\n          );\n          return { duplicateOf: match };\n        }\n        return {};\n      });\n    };\n\n    const persistNode = async (state: typeof PremiseGraphState.State) => {\n      return timed(\"PremiseGraph.persist\", async () => {\n        if (state.error) return {};\n\n        if (state.operationMode === 'update' && !state.targetPremiseId) {\n          return { error: \"targetPremiseId is required for update mode\" };\n        }\n\n        if (state.operationMode === 'update' && state.targetPremiseId) {\n          logger.verbose(`[PremiseGraph.persist] Updating premise ${state.targetPremiseId}`);\n\n          const updated = await this.database.updatePremise(state.targetPremiseId, {\n            assertion: {\n              text: state.assertionText!,\n              tier: state.tier,\n            },\n            analysis: state.analysis ?? undefined,\n            validity: {\n              validFrom: state.validFrom,\n              validUntil: state.validUntil,\n              volatile: state.volatile,\n            },\n            embedding: state.embedding,\n          });\n          return { premise: updated };\n        }\n\n        logger.verbose(`[PremiseGraph.persist] Creating new premise for user ${state.userId}`);\n\n        // Provenance confidence: prefer an explicit caller-supplied value; otherwise\n        // derive it from the analyzer's felicity scores (how authoritative, sincere,\n        // and clear the assertion is) rather than a blanket 1.0, so the stored\n        // provenance reflects per-premise signal quality.\n        const derivedConfidence = deriveProvenanceConfidence(state.analysis);\n        const premise = await this.database.createPremise({\n          userId: state.userId,\n          assertion: {\n            text: state.assertionText!,\n            tier: state.tier,\n          },\n          provenance: {\n            source: state.provenanceSource ?? 'explicit',\n            sourceId: state.provenanceSourceId,\n            confidence: state.provenanceConfidence ?? derivedConfidence,\n            timestamp: new Date().toISOString(),\n          },\n          analysis: state.analysis ?? undefined,\n          validity: {\n            validFrom: state.validFrom,\n            validUntil: state.validUntil,\n            volatile: state.volatile,\n          },\n          embedding: state.embedding,\n        });\n        return { premise };\n      });\n    };\n\n    const indexNode = async (state: typeof PremiseGraphState.State) => {\n      return timed(\"PremiseGraph.index\", async () => {\n        if (!state.premise) return {};\n\n        logger.verbose(`[PremiseGraph.index] Scoring premise against user networks`);\n\n        const assignmentMemberships = await this.database.getAssignmentNetworkMembershipsForUser(state.userId);\n        const requestScope = state.scopeType && state.scopeId\n          ? { scopeType: state.scopeType, scopeId: state.scopeId }\n          : scopeFromNetworkId(state.networkScopeId);\n        const indexIds = resolveAssignmentNetworkScope({\n          memberships: assignmentMemberships,\n          ...requestScope,\n        });\n        const scope = requestScope.scopeType ? \"network\" : \"global\";\n        const assignments: Array<{ networkId: string; relevancyScore: number }> = [];\n        const agentTimings: DebugMetaAgent[] = [];\n\n        for (const networkId of indexIds) {\n          try {\n            const assignmentContext = await this.database.getNetworkAssignmentContext(networkId, state.userId);\n            if (!assignmentContext) continue;\n            const indexPrompt = assignmentContext.indexPrompt;\n            const memberPrompt = assignmentContext.memberPrompt;\n            const hasPrompts = !!indexPrompt?.trim() || !!memberPrompt?.trim();\n            let rawScores: { indexScore?: number; memberScore?: number } | undefined;\n            let reason: string | undefined;\n\n            if (hasPrompts) {\n              const start = Date.now();\n              const result = await indexer.invoke({\n                premiseText: state.assertionText!,\n                indexPrompt: indexPrompt ?? \"\",\n                memberPrompt: memberPrompt ?? undefined,\n              });\n              const timing: DebugMetaAgent = {\n                name: \"premise-indexer\",\n                durationMs: Date.now() - start,\n              };\n              rawScores = { indexScore: result.indexScore, memberScore: result.memberScore };\n              reason = result.reasoning;\n              agentTimings.push(timing);\n            }\n\n            const decision = buildNetworkAssignmentDecision({\n              resourceType: \"premise\",\n              mode: \"automatic\",\n              scope,\n              indexPrompt,\n              memberPrompt,\n              rawScores,\n              evaluator: \"premise-indexer\",\n              source: \"premise-graph\",\n              reason,\n              createdAt: new Date().toISOString(),\n            });\n\n            if (decision.assigned) {\n              await this.database.assignPremiseToNetwork(\n                state.premise.id,\n                networkId,\n                decision.finalScore,\n                decision.metadata,\n              );\n              assignments.push({ networkId, relevancyScore: decision.finalScore });\n            }\n          } catch (err) {\n            logger.verbose(`[PremiseGraph.index] Failed to score network ${networkId}, skipping: ${err}`);\n          }\n        }\n\n        logger.verbose(`[PremiseGraph.index] Assigned to ${assignments.length} networks`);\n\n        return { networkAssignments: assignments, agentTimings };\n      });\n    };\n\n    const routeByMode = (state: typeof PremiseGraphState.State) => {\n      if (state.error) return \"end\";\n      if (state.operationMode === 'query') return \"query\";\n      return \"analyze\";\n    };\n\n    const graph = new StateGraph(PremiseGraphState)\n      .addNode(\"query\", queryNode)\n      .addNode(\"analyze\", analyzeNode)\n      .addNode(\"embed\", embedNode)\n      .addNode(\"dedupe\", dedupeNode)\n      .addNode(\"persist\", persistNode)\n      .addNode(\"index\", indexNode)\n      .addConditionalEdges(START, routeByMode, {\n        query: \"query\",\n        analyze: \"analyze\",\n        end: END,\n      })\n      .addEdge(\"query\", END)\n      .addEdge(\"analyze\", \"embed\")\n      .addEdge(\"embed\", \"dedupe\")\n      // A near-duplicate short-circuits straight to END (no persist, no index).\n      .addConditionalEdges(\"dedupe\", (state: typeof PremiseGraphState.State) => (state.duplicateOf ? \"end\" : \"persist\"), {\n        persist: \"persist\",\n        end: END,\n      })\n      .addEdge(\"persist\", \"index\")\n      .addEdge(\"index\", END);\n\n    return graph.compile();\n  }\n}\n"]}

package/dist/premise/premise.state.d.ts

@@ -15,6 +15,11 @@ export declare const PremiseGraphState: import("@langchain/langgraph").Annotatio
     provenanceSourceId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
     provenanceConfidence: import("@langchain/langgraph").BaseChannel<number | undefined, number | import("@langchain/langgraph").OverwriteValue<number | undefined> | undefined, unknown>;
     operationMode: import("@langchain/langgraph").BaseChannel<"query" | "update" | "create", "query" | "update" | "create" | import("@langchain/langgraph").OverwriteValue<"query" | "update" | "create">, unknown>;
+    /** Focused request scope type for assignment writes. */
+    scopeType: import("@langchain/langgraph").BaseChannel<"network" | undefined, "network" | import("@langchain/langgraph").OverwriteValue<"network" | undefined> | undefined, unknown>;
+    /** Focused request scope id. When scopeType is `network`, this is the focused network id. */
+    scopeId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+    /** @deprecated Use scopeType/scopeId. Retained temporarily for older enqueue handlers. */
     networkScopeId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
     targetPremiseId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
     analysis: import("@langchain/langgraph").BaseChannel<PremiseAnalysis | undefined, PremiseAnalysis | import("@langchain/langgraph").OverwriteValue<PremiseAnalysis | undefined> | undefined, unknown>;

package/dist/premise/premise.state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"premise.state.d.ts","sourceRoot":"/","sources":["premise/premise.state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAqB,aAAa,EAAE,MAAM,4CAA4C,CAAC;AACpH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;mBA4ES,MAAM;uBAAiB,MAAM;oBAAc,MAAM;;mBAAjD,MAAM;uBAAiB,MAAM;oBAAc,MAAM;;mBAAjD,MAAM;uBAAiB,MAAM;oBAAc,MAAM;;;mBAKpC,MAAM;wBAAkB,MAAM;;mBAA9B,MAAM;wBAAkB,MAAM;;mBAA9B,MAAM;wBAAkB,MAAM;;;;kBAWpE,aAAa,EAAE;eAClB,MAAM;kBACH,MAAM;;kBAFN,aAAa,EAAE;eAClB,MAAM;kBACH,MAAM;;kBAFN,aAAa,EAAE;eAClB,MAAM;kBACH,MAAM;;;EAUlB,CAAC"}
+{"version":3,"file":"premise.state.d.ts","sourceRoot":"/","sources":["premise/premise.state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAqB,aAAa,EAAE,MAAM,4CAA4C,CAAC;AACpH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGtE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;IAgD5B,wDAAwD;;IAMxD,6FAA6F;;IAM7F,0FAA0F;;;;;;;mBA6BrD,MAAM;uBAAiB,MAAM;oBAAc,MAAM;;mBAAjD,MAAM;uBAAiB,MAAM;oBAAc,MAAM;;mBAAjD,MAAM;uBAAiB,MAAM;oBAAc,MAAM;;;mBAKpC,MAAM;wBAAkB,MAAM;;mBAA9B,MAAM;wBAAkB,MAAM;;mBAA9B,MAAM;wBAAkB,MAAM;;;;kBAWpE,aAAa,EAAE;eAClB,MAAM;kBACH,MAAM;;kBAFN,aAAa,EAAE;eAClB,MAAM;kBACH,MAAM;;kBAFN,aAAa,EAAE;eAClB,MAAM;kBACH,MAAM;;;EAUlB,CAAC"}

package/dist/premise/premise.state.js

@@ -37,6 +37,17 @@ export const PremiseGraphState = Annotation.Root({
         reducer: (curr, next) => next ?? curr,
         default: () => 'create',
     }),
+    /** Focused request scope type for assignment writes. */
+    scopeType: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => undefined,
+    }),
+    /** Focused request scope id. When scopeType is `network`, this is the focused network id. */
+    scopeId: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => undefined,
+    }),
+    /** @deprecated Use scopeType/scopeId. Retained temporarily for older enqueue handlers. */
     networkScopeId: Annotation({
         reducer: (curr, next) => next ?? curr,
         default: () => undefined,

package/dist/premise/premise.state.js.map

@@ -1 +1 @@
-{"version":3,"file":"premise.state.js","sourceRoot":"/","sources":["premise/premise.state.ts"],"names":[],"mappings":"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","sourcesContent":["import { Annotation } from \"@langchain/langgraph\";\nimport type { PremiseAnalysis, PremiseProvenance, PremiseRecord } from \"../shared/interfaces/database.interface.js\";\nimport type { DebugMetaAgent } from '../chat/chat-streaming.types.js';\n\nexport const PremiseGraphState = Annotation.Root({\n  userId: Annotation<string>,\n\n  assertionText: Annotation<string | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  tier: Annotation<'assertive' | 'contextual'>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => 'assertive',\n  }),\n\n  validFrom: Annotation<string | undefined>({\n    reducer: (curr, next) => next,\n    default: () => undefined,\n  }),\n\n  validUntil: Annotation<string | undefined>({\n    reducer: (curr, next) => next,\n    default: () => undefined,\n  }),\n\n  volatile: Annotation<boolean>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => false,\n  }),\n\n  provenanceSource: Annotation<PremiseProvenance['source'] | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  provenanceSourceId: Annotation<string | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  provenanceConfidence: Annotation<number | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  operationMode: Annotation<'create' | 'update' | 'query'>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => 'create',\n  }),\n\n  networkScopeId: Annotation<string | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  targetPremiseId: Annotation<string | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  analysis: Annotation<PremiseAnalysis | undefined>({\n    reducer: (curr, next) => next,\n    default: () => undefined,\n  }),\n\n  embedding: Annotation<number[] | undefined>({\n    reducer: (curr, next) => next,\n    default: () => undefined,\n  }),\n\n  premise: Annotation<PremiseRecord | undefined>({\n    reducer: (curr, next) => next,\n    default: () => undefined,\n  }),\n\n  // Set by the dedupe node when a near-duplicate ACTIVE premise already exists for\n  // the user (create mode only). When present, persist/index are skipped — the\n  // candidate is treated as already represented by `duplicateOf`.\n  duplicateOf: Annotation<{ premiseId: string; assertionText: string; similarity: number } | undefined>({\n    reducer: (curr, next) => next,\n    default: () => undefined,\n  }),\n\n  networkAssignments: Annotation<Array<{ networkId: string; relevancyScore: number }>>({\n    reducer: (curr, next) => next,\n    default: () => [],\n  }),\n\n  error: Annotation<string | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  readResult: Annotation<{\n    premises: PremiseRecord[];\n    count: number;\n    message?: string;\n  } | undefined>({\n    reducer: (curr, next) => next,\n    default: () => undefined,\n  }),\n\n  agentTimings: Annotation<DebugMetaAgent[]>({\n    reducer: (acc, val) => [...acc, ...val],\n    default: () => [],\n  }),\n});\n"]}
+{"version":3,"file":"premise.state.js","sourceRoot":"/","sources":["premise/premise.state.ts"],"names":[],"mappings":"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","sourcesContent":["import { Annotation } from \"@langchain/langgraph\";\nimport type { PremiseAnalysis, PremiseProvenance, PremiseRecord } from \"../shared/interfaces/database.interface.js\";\nimport type { DebugMetaAgent } from '../chat/chat-streaming.types.js';\nimport type { ToolScopeType } from '../shared/agent/tool.scope.js';\n\nexport const PremiseGraphState = Annotation.Root({\n  userId: Annotation<string>,\n\n  assertionText: Annotation<string | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  tier: Annotation<'assertive' | 'contextual'>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => 'assertive',\n  }),\n\n  validFrom: Annotation<string | undefined>({\n    reducer: (curr, next) => next,\n    default: () => undefined,\n  }),\n\n  validUntil: Annotation<string | undefined>({\n    reducer: (curr, next) => next,\n    default: () => undefined,\n  }),\n\n  volatile: Annotation<boolean>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => false,\n  }),\n\n  provenanceSource: Annotation<PremiseProvenance['source'] | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  provenanceSourceId: Annotation<string | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  provenanceConfidence: Annotation<number | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  operationMode: Annotation<'create' | 'update' | 'query'>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => 'create',\n  }),\n\n  /** Focused request scope type for assignment writes. */\n  scopeType: Annotation<ToolScopeType | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /** Focused request scope id. When scopeType is `network`, this is the focused network id. */\n  scopeId: Annotation<string | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /** @deprecated Use scopeType/scopeId. Retained temporarily for older enqueue handlers. */\n  networkScopeId: Annotation<string | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  targetPremiseId: Annotation<string | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  analysis: Annotation<PremiseAnalysis | undefined>({\n    reducer: (curr, next) => next,\n    default: () => undefined,\n  }),\n\n  embedding: Annotation<number[] | undefined>({\n    reducer: (curr, next) => next,\n    default: () => undefined,\n  }),\n\n  premise: Annotation<PremiseRecord | undefined>({\n    reducer: (curr, next) => next,\n    default: () => undefined,\n  }),\n\n  // Set by the dedupe node when a near-duplicate ACTIVE premise already exists for\n  // the user (create mode only). When present, persist/index are skipped — the\n  // candidate is treated as already represented by `duplicateOf`.\n  duplicateOf: Annotation<{ premiseId: string; assertionText: string; similarity: number } | undefined>({\n    reducer: (curr, next) => next,\n    default: () => undefined,\n  }),\n\n  networkAssignments: Annotation<Array<{ networkId: string; relevancyScore: number }>>({\n    reducer: (curr, next) => next,\n    default: () => [],\n  }),\n\n  error: Annotation<string | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  readResult: Annotation<{\n    premises: PremiseRecord[];\n    count: number;\n    message?: string;\n  } | undefined>({\n    reducer: (curr, next) => next,\n    default: () => undefined,\n  }),\n\n  agentTimings: Annotation<DebugMetaAgent[]>({\n    reducer: (acc, val) => [...acc, ...val],\n    default: () => [],\n  }),\n});\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"premise.tools.d.ts","sourceRoot":"/","sources":["premise/premise.tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAQ5E,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,SA0RxE"}
+{"version":3,"file":"premise.tools.d.ts","sourceRoot":"/","sources":["premise/premise.tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAQ5E,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,SA+RxE"}

package/dist/premise/premise.tools.js

@@ -35,6 +35,9 @@ export function createPremiseTools(defineTool, deps) {
                 return error("Premise graph not available.");
             }
             const effectiveVolatile = query.volatile ?? (query.tier === "contextual" ? true : false);
+            const scopeEnvelope = context.scopeType && context.scopeId
+                ? { scopeType: context.scopeType, scopeId: context.scopeId }
+                : {};
             logger.verbose(`[createPremise] Creating premise for user ${context.userId}: "${query.text.substring(0, 60)}..."`);
             const result = await invokeWithAbortSignal(premiseGraph, {
                 userId: context.userId,
@@ -44,6 +47,7 @@ export function createPremiseTools(defineTool, deps) {
                 validUntil: query.validUntil,
                 volatile: effectiveVolatile,
                 operationMode: "create",
+                ...scopeEnvelope,
             });
             if (result.error) {
                 return error(result.error);
@@ -193,6 +197,7 @@ export function createPremiseTools(defineTool, deps) {
                 volatile: query.volatile ?? existing.validity.volatile,
                 operationMode: "update",
                 targetPremiseId: query.premiseId,
+                ...(context.scopeType && context.scopeId ? { scopeType: context.scopeType, scopeId: context.scopeId } : {}),
             });
             if (result.error) {
                 return error(result.error);

package/dist/premise/premise.tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"premise.tools.js","sourceRoot":"/","sources":["premise/premise.tools.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\n\nimport type { DefineTool, ToolDeps } from \"../shared/agent/tool.helpers.js\";\nimport { success, error, UUID_REGEX } from \"../shared/agent/tool.helpers.js\";\nimport { protocolLogger } from \"../shared/observability/protocol.logger.js\";\nimport type { PremiseRecord, PremiseValidity } from \"../shared/interfaces/database.interface.js\";\nimport { invokeWithAbortSignal } from \"../shared/agent/model-signal.js\";\n\nconst logger = protocolLogger(\"ChatTools:Premise\");\n\nexport function createPremiseTools(defineTool: DefineTool, deps: ToolDeps) {\n  const database = deps.database;\n  const premiseGraph = deps.graphs.premise;\n\n  // ─────────────────────────────────────────────────────────────────────────────\n  // PREMISE CRUD\n  // ─────────────────────────────────────────────────────────────────────────────\n\n  const createPremise = defineTool({\n    name: \"create_premise\",\n    description:\n      \"Creates a premise — a self-descriptive proposition the user asserts about themselves. \" +\n      \"Premises are the foundational facts that shape how the system understands who you are \" +\n      \"and what contexts you inhabit.\\n\\n\" +\n      \"**Tiers:**\\n\" +\n      \"- `assertive` (default): stable identity facts (e.g. 'I am a software engineer', 'I live in Berlin'). \" +\n      \"Use for things that are durably true and not time-bound.\\n\" +\n      \"- `contextual`: temporal or situational facts (e.g. 'I am attending DevCon this week', \" +\n      \"'I am fundraising for my Series A right now'). Use when the user shares something time-bound \" +\n      \"or context-specific. These default to `volatile: true`.\\n\\n\" +\n      \"**When to use:** Call this whenever the user shares a fact about themselves in first person \" +\n      \"('I am', 'I work at', 'I just joined', 'I am currently'). Do not infer premises from vague \" +\n      \"statements — only create them when the user is clearly asserting something about themselves.\",\n    querySchema: z.object({\n      text: z.string().trim().min(1).describe(\"The premise text — a self-descriptive proposition in first person, e.g. 'I am a machine learning researcher at MIT'.\"),\n      tier: z.enum([\"assertive\", \"contextual\"]).default(\"assertive\").describe(\"Tier of the premise. 'assertive' = stable identity fact. 'contextual' = temporal/situational. Defaults to 'assertive'.\"),\n      validFrom: z.string().datetime().optional().describe(\"ISO 8601 date-time string for when this premise becomes valid. Omit for immediate.\"),\n      validUntil: z.string().datetime().optional().describe(\"ISO 8601 date-time string for when this premise expires. Recommended for contextual premises with a known end date; omit if open-ended.\"),\n      volatile: z.boolean().optional().describe(\"Whether this premise should be automatically retracted when it expires. Defaults to true for contextual tier, false for assertive.\"),\n    }),\n    handler: async ({ context, query }) => {\n      if (!premiseGraph) {\n        return error(\"Premise graph not available.\");\n      }\n\n      const effectiveVolatile = query.volatile ?? (query.tier === \"contextual\" ? true : false);\n\n      logger.verbose(`[createPremise] Creating premise for user ${context.userId}: \"${query.text.substring(0, 60)}...\"`);\n\n      const result = await invokeWithAbortSignal(premiseGraph, {\n        userId: context.userId,\n        assertionText: query.text,\n        tier: query.tier,\n        validFrom: query.validFrom,\n        validUntil: query.validUntil,\n        volatile: effectiveVolatile,\n        operationMode: \"create\",\n      });\n\n      if (result.error) {\n        return error(result.error);\n      }\n\n      if (!result.premise) {\n        return error(\"Premise creation failed — no premise returned.\");\n      }\n\n      const premise = result.premise;\n      const indexesAssigned = result.networkAssignments?.length ?? 0;\n      const analysisSummary = premise.analysis\n        ? `speechActType: ${premise.analysis.speechActType}, clarity: ${premise.analysis.felicityClarity?.toFixed(2) ?? \"n/a\"}`\n        : \"no analysis\";\n\n      const createResult = success({\n        id: premise.id,\n        assertion: premise.assertion.text,\n        tier: premise.assertion.tier,\n        analysisSummary,\n        indexesAssigned,\n        message: `Premise created and assigned to ${indexesAssigned} index${indexesAssigned === 1 ? \"\" : \"es\"}.`,\n      });\n      try { deps.premiseEvents?.onCreated?.(premise.id, context.userId); }\n      catch (e) { logger.error('[createPremise] premiseEvents.onCreated failed', { error: e }); }\n      return createResult;\n    },\n  });\n\n  const readPremises = defineTool({\n    name: \"read_premises\",\n    description:\n      \"Retrieves premises — the self-descriptive propositions a user has asserted about themselves. \" +\n      \"Premises represent stable identity facts (assertive) and temporal context (contextual).\\n\\n\" +\n      \"**Usage modes:**\\n\" +\n      \"- No parameters: returns the caller's own active premises.\\n\" +\n      \"- With `userId`: returns that user's premises (use when reviewing another member's context).\\n\" +\n      \"- With `includeRetracted: true`: returns all premises regardless of status (active, retracted, expired) for history review.\\n\\n\" +\n      \"**When to use:** Call before creating a premise to check if it already exists. \" +\n      \"Call when the user asks what they have shared about themselves, or to review their current context. \" +\n      \"Each premise includes: id, text, tier, status, analysis summary, and validity range.\",\n    querySchema: z.object({\n      userId: z.string().optional().describe(\"User ID to fetch premises for. Omit to fetch the current user's own premises.\"),\n      includeRetracted: z.boolean().default(false).describe(\"When true, returns all premises regardless of status (active, retracted, expired). Defaults to false (active only).\"),\n    }),\n    handler: async ({ context, query }) => {\n      const targetUserId = query.userId?.trim() || context.userId;\n\n      if (query.userId?.trim() && !UUID_REGEX.test(query.userId.trim())) {\n        return error(\"Invalid userId format.\");\n      }\n\n      logger.verbose(`[readPremises] Fetching premises for user ${targetUserId}`);\n\n      // Query DB directly (bypassing graph) to support status filtering.\n      // The graph's query node hardcodes ACTIVE status, so includeRetracted\n      // would be dead code if we routed through it.\n      const statusFilter = query.includeRetracted ? undefined : \"ACTIVE\" as const;\n      const premises = await database.getPremisesForUser(targetUserId, statusFilter);\n\n      const mapped = premises.map((p: PremiseRecord) => ({\n        id: p.id,\n        text: p.assertion.text,\n        tier: p.assertion.tier,\n        status: p.status,\n        analysisSummary: p.analysis\n          ? `speechActType: ${p.analysis.speechActType ?? \"n/a\"}, clarity: ${p.analysis.felicityClarity?.toFixed(2) ?? \"n/a\"}`\n          : \"no analysis\",\n        validFrom: p.validity.validFrom ?? null,\n        validUntil: p.validity.validUntil ?? null,\n        volatile: p.validity.volatile ?? false,\n      }));\n\n      return success({\n        premises: mapped,\n        count: mapped.length,\n      });\n    },\n  });\n\n  const updatePremise = defineTool({\n    name: \"update_premise\",\n    description:\n      \"Modifies an existing premise. Updating the text triggers re-analysis and re-embedding, \" +\n      \"which may change how it influences opportunity discovery. \" +\n      \"Use when the user corrects or refines something they previously stated about themselves, \" +\n      \"or when validity dates need adjustment.\\n\\n\" +\n      \"**When to use:** When the user says 'actually, I meant...', 'update my premise about...', \" +\n      \"or provides a corrected version of a previously stated fact. \" +\n      \"Requires the premise ID — call read_premises first if you don't have it.\",\n    querySchema: z.object({\n      premiseId: z.string().describe(\"UUID of the premise to update. Get from read_premises.\"),\n      text: z.string().trim().min(1).optional().describe(\"New assertion text. Triggers re-analysis and re-embedding when provided.\"),\n      validFrom: z.string().datetime().optional().describe(\"New ISO 8601 valid-from date-time.\"),\n      validUntil: z.string().datetime().optional().describe(\"New ISO 8601 valid-until date-time.\"),\n      volatile: z.boolean().optional().describe(\"Update the volatile flag.\"),\n    }),\n    handler: async ({ context, query }) => {\n      if (!UUID_REGEX.test(query.premiseId)) {\n        return error(\"Invalid premiseId format.\");\n      }\n\n      const existing = await database.getPremise(query.premiseId);\n      if (!existing) {\n        return error(\"Premise not found.\");\n      }\n      if (existing.userId !== context.userId) {\n        return error(\"You can only update your own premises.\");\n      }\n      if (existing.status === \"RETRACTED\") {\n        return error(\"Cannot update a retracted premise. Retracted premises are immutable.\");\n      }\n\n      logger.verbose(`[updatePremise] Updating premise ${query.premiseId} for user ${context.userId}`);\n\n      // When text is unchanged, skip the graph (avoids unnecessary LLM\n      // re-analysis and non-deterministic re-embedding). Only route through\n      // the graph when the assertion text actually changes.\n      if (query.text === undefined) {\n        const hasValidityChange =\n          query.validFrom !== undefined ||\n          query.validUntil !== undefined ||\n          query.volatile !== undefined;\n\n        if (!hasValidityChange) {\n          return error(\"No fields to update. Provide text, validFrom, validUntil, or volatile.\");\n        }\n\n        const mergedValidity: PremiseValidity = {\n          ...existing.validity,\n          ...(query.validFrom !== undefined && { validFrom: query.validFrom }),\n          ...(query.validUntil !== undefined && { validUntil: query.validUntil }),\n          ...(query.volatile !== undefined && { volatile: query.volatile }),\n        };\n\n        const updated = await database.updatePremise(query.premiseId, { validity: mergedValidity });\n\n        const metadataResult = success({\n          id: updated.id,\n          assertion: updated.assertion.text,\n          tier: updated.assertion.tier,\n          status: updated.status,\n          message: \"Premise updated successfully (metadata only, no re-analysis).\",\n        });\n        try { deps.premiseEvents?.onUpdated?.(query.premiseId, context.userId); }\n        catch (e) { logger.error('[updatePremise] premiseEvents.onUpdated failed', { error: e }); }\n        return metadataResult;\n      }\n\n      // Text change requires the graph for re-analysis and re-embedding\n      if (!premiseGraph) {\n        return error(\"Premise graph not available.\");\n      }\n\n      const result = await invokeWithAbortSignal(premiseGraph, {\n        userId: context.userId,\n        assertionText: query.text,\n        tier: existing.assertion.tier,\n        validFrom: query.validFrom ?? existing.validity.validFrom ?? undefined,\n        validUntil: query.validUntil ?? existing.validity.validUntil ?? undefined,\n        volatile: query.volatile ?? existing.validity.volatile,\n        operationMode: \"update\",\n        targetPremiseId: query.premiseId,\n      });\n\n      if (result.error) {\n        return error(result.error);\n      }\n\n      if (!result.premise) {\n        return error(\"Premise update failed — no updated premise returned.\");\n      }\n\n      const updated = result.premise;\n\n      const updateResult = success({\n        id: updated.id,\n        assertion: updated.assertion.text,\n        tier: updated.assertion.tier,\n        status: updated.status,\n        message: \"Premise updated successfully.\",\n      });\n      try { deps.premiseEvents?.onUpdated?.(query.premiseId, context.userId); }\n      catch (e) { logger.error('[updatePremise] premiseEvents.onUpdated failed', { error: e }); }\n      return updateResult;\n    },\n  });\n\n  const retractPremise = defineTool({\n    name: \"retract_premise\",\n    description:\n      \"Retracts a premise — a soft delete that preserves the history of what was asserted. \" +\n      \"Retracted premises are no longer active but remain in the audit trail. \" +\n      \"Use when the user explicitly wants to remove something they previously stated about themselves, \" +\n      \"or when a contextual premise is no longer true.\\n\\n\" +\n      \"**When to use:** When the user says 'remove my premise about...', 'I no longer...', \" +\n      \"or 'that's not true anymore'. Do not retract premises proactively — only on explicit user instruction.\",\n    querySchema: z.object({\n      premiseId: z.string().describe(\"UUID of the premise to retract. Get from read_premises.\"),\n    }),\n    handler: async ({ context, query }) => {\n      if (!UUID_REGEX.test(query.premiseId)) {\n        return error(\"Invalid premiseId format.\");\n      }\n\n      const existing = await database.getPremise(query.premiseId);\n      if (!existing) {\n        return error(\"Premise not found.\");\n      }\n      if (existing.userId !== context.userId) {\n        return error(\"You can only retract your own premises.\");\n      }\n      if (existing.status === \"RETRACTED\") {\n        return error(\"Premise is already retracted.\");\n      }\n\n      logger.verbose(`[retractPremise] Retracting premise ${query.premiseId} for user ${context.userId}`);\n\n      await database.updatePremise(query.premiseId, {\n        status: \"RETRACTED\",\n        retractedAt: new Date(),\n      });\n\n      const retractResult = success({\n        id: query.premiseId,\n        message: \"Premise retracted successfully.\",\n      });\n      try { deps.premiseEvents?.onRetracted?.(query.premiseId, context.userId); }\n      catch (e) { logger.error('[retractPremise] premiseEvents.onRetracted failed', { error: e }); }\n      return retractResult;\n    },\n  });\n\n  return [createPremise, readPremises, updatePremise, retractPremise];\n}\n"]}
+{"version":3,"file":"premise.tools.js","sourceRoot":"/","sources":["premise/premise.tools.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\n\nimport type { DefineTool, ToolDeps } from \"../shared/agent/tool.helpers.js\";\nimport { success, error, UUID_REGEX } from \"../shared/agent/tool.helpers.js\";\nimport { protocolLogger } from \"../shared/observability/protocol.logger.js\";\nimport type { PremiseRecord, PremiseValidity } from \"../shared/interfaces/database.interface.js\";\nimport { invokeWithAbortSignal } from \"../shared/agent/model-signal.js\";\n\nconst logger = protocolLogger(\"ChatTools:Premise\");\n\nexport function createPremiseTools(defineTool: DefineTool, deps: ToolDeps) {\n  const database = deps.database;\n  const premiseGraph = deps.graphs.premise;\n\n  // ─────────────────────────────────────────────────────────────────────────────\n  // PREMISE CRUD\n  // ─────────────────────────────────────────────────────────────────────────────\n\n  const createPremise = defineTool({\n    name: \"create_premise\",\n    description:\n      \"Creates a premise — a self-descriptive proposition the user asserts about themselves. \" +\n      \"Premises are the foundational facts that shape how the system understands who you are \" +\n      \"and what contexts you inhabit.\\n\\n\" +\n      \"**Tiers:**\\n\" +\n      \"- `assertive` (default): stable identity facts (e.g. 'I am a software engineer', 'I live in Berlin'). \" +\n      \"Use for things that are durably true and not time-bound.\\n\" +\n      \"- `contextual`: temporal or situational facts (e.g. 'I am attending DevCon this week', \" +\n      \"'I am fundraising for my Series A right now'). Use when the user shares something time-bound \" +\n      \"or context-specific. These default to `volatile: true`.\\n\\n\" +\n      \"**When to use:** Call this whenever the user shares a fact about themselves in first person \" +\n      \"('I am', 'I work at', 'I just joined', 'I am currently'). Do not infer premises from vague \" +\n      \"statements — only create them when the user is clearly asserting something about themselves.\",\n    querySchema: z.object({\n      text: z.string().trim().min(1).describe(\"The premise text — a self-descriptive proposition in first person, e.g. 'I am a machine learning researcher at MIT'.\"),\n      tier: z.enum([\"assertive\", \"contextual\"]).default(\"assertive\").describe(\"Tier of the premise. 'assertive' = stable identity fact. 'contextual' = temporal/situational. Defaults to 'assertive'.\"),\n      validFrom: z.string().datetime().optional().describe(\"ISO 8601 date-time string for when this premise becomes valid. Omit for immediate.\"),\n      validUntil: z.string().datetime().optional().describe(\"ISO 8601 date-time string for when this premise expires. Recommended for contextual premises with a known end date; omit if open-ended.\"),\n      volatile: z.boolean().optional().describe(\"Whether this premise should be automatically retracted when it expires. Defaults to true for contextual tier, false for assertive.\"),\n    }),\n    handler: async ({ context, query }) => {\n      if (!premiseGraph) {\n        return error(\"Premise graph not available.\");\n      }\n\n      const effectiveVolatile = query.volatile ?? (query.tier === \"contextual\" ? true : false);\n      const scopeEnvelope = context.scopeType && context.scopeId\n        ? { scopeType: context.scopeType, scopeId: context.scopeId }\n        : {};\n\n      logger.verbose(`[createPremise] Creating premise for user ${context.userId}: \"${query.text.substring(0, 60)}...\"`);\n\n      const result = await invokeWithAbortSignal(premiseGraph, {\n        userId: context.userId,\n        assertionText: query.text,\n        tier: query.tier,\n        validFrom: query.validFrom,\n        validUntil: query.validUntil,\n        volatile: effectiveVolatile,\n        operationMode: \"create\",\n        ...scopeEnvelope,\n      });\n\n      if (result.error) {\n        return error(result.error);\n      }\n\n      if (!result.premise) {\n        return error(\"Premise creation failed — no premise returned.\");\n      }\n\n      const premise = result.premise;\n      const indexesAssigned = result.networkAssignments?.length ?? 0;\n      const analysisSummary = premise.analysis\n        ? `speechActType: ${premise.analysis.speechActType}, clarity: ${premise.analysis.felicityClarity?.toFixed(2) ?? \"n/a\"}`\n        : \"no analysis\";\n\n      const createResult = success({\n        id: premise.id,\n        assertion: premise.assertion.text,\n        tier: premise.assertion.tier,\n        analysisSummary,\n        indexesAssigned,\n        message: `Premise created and assigned to ${indexesAssigned} index${indexesAssigned === 1 ? \"\" : \"es\"}.`,\n      });\n      try { deps.premiseEvents?.onCreated?.(premise.id, context.userId); }\n      catch (e) { logger.error('[createPremise] premiseEvents.onCreated failed', { error: e }); }\n      return createResult;\n    },\n  });\n\n  const readPremises = defineTool({\n    name: \"read_premises\",\n    description:\n      \"Retrieves premises — the self-descriptive propositions a user has asserted about themselves. \" +\n      \"Premises represent stable identity facts (assertive) and temporal context (contextual).\\n\\n\" +\n      \"**Usage modes:**\\n\" +\n      \"- No parameters: returns the caller's own active premises.\\n\" +\n      \"- With `userId`: returns that user's premises (use when reviewing another member's context).\\n\" +\n      \"- With `includeRetracted: true`: returns all premises regardless of status (active, retracted, expired) for history review.\\n\\n\" +\n      \"**When to use:** Call before creating a premise to check if it already exists. \" +\n      \"Call when the user asks what they have shared about themselves, or to review their current context. \" +\n      \"Each premise includes: id, text, tier, status, analysis summary, and validity range.\",\n    querySchema: z.object({\n      userId: z.string().optional().describe(\"User ID to fetch premises for. Omit to fetch the current user's own premises.\"),\n      includeRetracted: z.boolean().default(false).describe(\"When true, returns all premises regardless of status (active, retracted, expired). Defaults to false (active only).\"),\n    }),\n    handler: async ({ context, query }) => {\n      const targetUserId = query.userId?.trim() || context.userId;\n\n      if (query.userId?.trim() && !UUID_REGEX.test(query.userId.trim())) {\n        return error(\"Invalid userId format.\");\n      }\n\n      logger.verbose(`[readPremises] Fetching premises for user ${targetUserId}`);\n\n      // Query DB directly (bypassing graph) to support status filtering.\n      // The graph's query node hardcodes ACTIVE status, so includeRetracted\n      // would be dead code if we routed through it.\n      const statusFilter = query.includeRetracted ? undefined : \"ACTIVE\" as const;\n      const premises = await database.getPremisesForUser(targetUserId, statusFilter);\n\n      const mapped = premises.map((p: PremiseRecord) => ({\n        id: p.id,\n        text: p.assertion.text,\n        tier: p.assertion.tier,\n        status: p.status,\n        analysisSummary: p.analysis\n          ? `speechActType: ${p.analysis.speechActType ?? \"n/a\"}, clarity: ${p.analysis.felicityClarity?.toFixed(2) ?? \"n/a\"}`\n          : \"no analysis\",\n        validFrom: p.validity.validFrom ?? null,\n        validUntil: p.validity.validUntil ?? null,\n        volatile: p.validity.volatile ?? false,\n      }));\n\n      return success({\n        premises: mapped,\n        count: mapped.length,\n      });\n    },\n  });\n\n  const updatePremise = defineTool({\n    name: \"update_premise\",\n    description:\n      \"Modifies an existing premise. Updating the text triggers re-analysis and re-embedding, \" +\n      \"which may change how it influences opportunity discovery. \" +\n      \"Use when the user corrects or refines something they previously stated about themselves, \" +\n      \"or when validity dates need adjustment.\\n\\n\" +\n      \"**When to use:** When the user says 'actually, I meant...', 'update my premise about...', \" +\n      \"or provides a corrected version of a previously stated fact. \" +\n      \"Requires the premise ID — call read_premises first if you don't have it.\",\n    querySchema: z.object({\n      premiseId: z.string().describe(\"UUID of the premise to update. Get from read_premises.\"),\n      text: z.string().trim().min(1).optional().describe(\"New assertion text. Triggers re-analysis and re-embedding when provided.\"),\n      validFrom: z.string().datetime().optional().describe(\"New ISO 8601 valid-from date-time.\"),\n      validUntil: z.string().datetime().optional().describe(\"New ISO 8601 valid-until date-time.\"),\n      volatile: z.boolean().optional().describe(\"Update the volatile flag.\"),\n    }),\n    handler: async ({ context, query }) => {\n      if (!UUID_REGEX.test(query.premiseId)) {\n        return error(\"Invalid premiseId format.\");\n      }\n\n      const existing = await database.getPremise(query.premiseId);\n      if (!existing) {\n        return error(\"Premise not found.\");\n      }\n      if (existing.userId !== context.userId) {\n        return error(\"You can only update your own premises.\");\n      }\n      if (existing.status === \"RETRACTED\") {\n        return error(\"Cannot update a retracted premise. Retracted premises are immutable.\");\n      }\n\n      logger.verbose(`[updatePremise] Updating premise ${query.premiseId} for user ${context.userId}`);\n\n      // When text is unchanged, skip the graph (avoids unnecessary LLM\n      // re-analysis and non-deterministic re-embedding). Only route through\n      // the graph when the assertion text actually changes.\n      if (query.text === undefined) {\n        const hasValidityChange =\n          query.validFrom !== undefined ||\n          query.validUntil !== undefined ||\n          query.volatile !== undefined;\n\n        if (!hasValidityChange) {\n          return error(\"No fields to update. Provide text, validFrom, validUntil, or volatile.\");\n        }\n\n        const mergedValidity: PremiseValidity = {\n          ...existing.validity,\n          ...(query.validFrom !== undefined && { validFrom: query.validFrom }),\n          ...(query.validUntil !== undefined && { validUntil: query.validUntil }),\n          ...(query.volatile !== undefined && { volatile: query.volatile }),\n        };\n\n        const updated = await database.updatePremise(query.premiseId, { validity: mergedValidity });\n\n        const metadataResult = success({\n          id: updated.id,\n          assertion: updated.assertion.text,\n          tier: updated.assertion.tier,\n          status: updated.status,\n          message: \"Premise updated successfully (metadata only, no re-analysis).\",\n        });\n        try { deps.premiseEvents?.onUpdated?.(query.premiseId, context.userId); }\n        catch (e) { logger.error('[updatePremise] premiseEvents.onUpdated failed', { error: e }); }\n        return metadataResult;\n      }\n\n      // Text change requires the graph for re-analysis and re-embedding\n      if (!premiseGraph) {\n        return error(\"Premise graph not available.\");\n      }\n\n      const result = await invokeWithAbortSignal(premiseGraph, {\n        userId: context.userId,\n        assertionText: query.text,\n        tier: existing.assertion.tier,\n        validFrom: query.validFrom ?? existing.validity.validFrom ?? undefined,\n        validUntil: query.validUntil ?? existing.validity.validUntil ?? undefined,\n        volatile: query.volatile ?? existing.validity.volatile,\n        operationMode: \"update\",\n        targetPremiseId: query.premiseId,\n        ...(context.scopeType && context.scopeId ? { scopeType: context.scopeType, scopeId: context.scopeId } : {}),\n      });\n\n      if (result.error) {\n        return error(result.error);\n      }\n\n      if (!result.premise) {\n        return error(\"Premise update failed — no updated premise returned.\");\n      }\n\n      const updated = result.premise;\n\n      const updateResult = success({\n        id: updated.id,\n        assertion: updated.assertion.text,\n        tier: updated.assertion.tier,\n        status: updated.status,\n        message: \"Premise updated successfully.\",\n      });\n      try { deps.premiseEvents?.onUpdated?.(query.premiseId, context.userId); }\n      catch (e) { logger.error('[updatePremise] premiseEvents.onUpdated failed', { error: e }); }\n      return updateResult;\n    },\n  });\n\n  const retractPremise = defineTool({\n    name: \"retract_premise\",\n    description:\n      \"Retracts a premise — a soft delete that preserves the history of what was asserted. \" +\n      \"Retracted premises are no longer active but remain in the audit trail. \" +\n      \"Use when the user explicitly wants to remove something they previously stated about themselves, \" +\n      \"or when a contextual premise is no longer true.\\n\\n\" +\n      \"**When to use:** When the user says 'remove my premise about...', 'I no longer...', \" +\n      \"or 'that's not true anymore'. Do not retract premises proactively — only on explicit user instruction.\",\n    querySchema: z.object({\n      premiseId: z.string().describe(\"UUID of the premise to retract. Get from read_premises.\"),\n    }),\n    handler: async ({ context, query }) => {\n      if (!UUID_REGEX.test(query.premiseId)) {\n        return error(\"Invalid premiseId format.\");\n      }\n\n      const existing = await database.getPremise(query.premiseId);\n      if (!existing) {\n        return error(\"Premise not found.\");\n      }\n      if (existing.userId !== context.userId) {\n        return error(\"You can only retract your own premises.\");\n      }\n      if (existing.status === \"RETRACTED\") {\n        return error(\"Premise is already retracted.\");\n      }\n\n      logger.verbose(`[retractPremise] Retracting premise ${query.premiseId} for user ${context.userId}`);\n\n      await database.updatePremise(query.premiseId, {\n        status: \"RETRACTED\",\n        retractedAt: new Date(),\n      });\n\n      const retractResult = success({\n        id: query.premiseId,\n        message: \"Premise retracted successfully.\",\n      });\n      try { deps.premiseEvents?.onRetracted?.(query.premiseId, context.userId); }\n      catch (e) { logger.error('[retractPremise] premiseEvents.onRetracted failed', { error: e }); }\n      return retractResult;\n    },\n  });\n\n  return [createPremise, readPremises, updatePremise, retractPremise];\n}\n"]}

package/dist/questioner/questioner.tools.d.ts

@@ -4,7 +4,7 @@ import type { DefineTool, ToolDeps } from "../shared/agent/tool.helpers.js";
  * Exposes `read_pending_questions` for retrieving the caller's pending
  * questions generated by QuestionerAgent (enrichment, intent, negotiation, discovery modes).
  *
- * Network-scoped agent keys (context.networkId set via applyNetworkScopeToContext)
+ * Network-scoped agent keys (context.scopeType/scopeId set via applyNetworkScopeToContext)
  * are clamped to self-owned modes; the result then carries a `scopeRestriction`
  * block mirroring the network-tools convention.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"questioner.tools.d.ts","sourceRoot":"/","sources":["questioner/questioner.tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAa5E;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,kBAuE3E"}
+{"version":3,"file":"questioner.tools.d.ts","sourceRoot":"/","sources":["questioner/questioner.tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAwB5E;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,kBA6E3E"}

package/dist/questioner/questioner.tools.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { error, success } from "../shared/agent/tool.helpers.js";
+import { focusedNetworkId, focusedNetworkLabel } from "../shared/agent/tool.scope.js";
 /**
  * Detection modes whose questions derive solely from the caller's own data
  * (profile gaps, own intents, own discovery sessions). Negotiation-mode
@@ -8,12 +9,19 @@ import { error, success } from "../shared/agent/tool.helpers.js";
  * other users' content (same leak class as the getOpportunitiesForUser fix).
  */
 const SELF_OWNED_MODES = ["enrichment", "intent", "discovery"];
+function isVisibleInScopedNetwork(question, userId, networkId) {
+    return question.actors?.some((actor) => actor.userId === userId && actor.networkId === networkId) === true;
+}
+function stripInternalActors(question) {
+    const { actors: _actors, ...publicQuestion } = question;
+    return publicQuestion;
+}
 /**
  * Creates MCP tool definitions for the questioner domain.
  * Exposes `read_pending_questions` for retrieving the caller's pending
  * questions generated by QuestionerAgent (enrichment, intent, negotiation, discovery modes).
  *
- * Network-scoped agent keys (context.networkId set via applyNetworkScopeToContext)
+ * Network-scoped agent keys (context.scopeType/scopeId set via applyNetworkScopeToContext)
  * are clamped to self-owned modes; the result then carries a `scopeRestriction`
  * block mirroring the network-tools convention.
  *
@@ -29,7 +37,7 @@ export function createQuestionerTools(defineTool, deps) {
             "system to help surface missing signals, refine intents, or capture engagement context.\n\n" +
             "**Returns:** List of pending questions, each with `id`, `title`, `prompt`, `options`, " +
             "`multiSelect`, `mode`, `sourceType`, `sourceId`, `createdAt`, and optional `expiresAt`. " +
-            "Network-scoped agents receive only profile/intent/discovery questions plus a " +
+            "Network-scoped agents receive only profile/intent/discovery questions for the scoped network plus a " +
             "`scopeRestriction` note.\n\n" +
             "**Use:** Call with no arguments to get all pending questions, or pass `limit` to cap the " +
             "count. For the daily brief the script calls with a small `limit` and renders the first " +
@@ -48,28 +56,31 @@ export function createQuestionerTools(defineTool, deps) {
                 return error("Question lookup is not available.");
             }
             const limit = query.limit ?? 10;
-            // Scoped-key discriminator: applyNetworkScopeToContext sets networkId
-            // only for network-scoped agent keys (mcp.server.ts:558).
-            const isScoped = Boolean(context.networkId);
+            // Scoped-key discriminator: scoped contexts carry a network scope envelope.
+            const scopedNetworkId = focusedNetworkId(context);
+            const isScoped = Boolean(scopedNetworkId);
             try {
                 const fetched = await deps.findPendingQuestions(context.userId, {
-                    ...(isScoped ? { modes: SELF_OWNED_MODES } : {}),
+                    ...(isScoped ? { modes: SELF_OWNED_MODES, networkId: scopedNetworkId } : {}),
                     limit,
                 });
-                // Defense-in-depth: hosts apply `modes`/`limit` SQL-side; re-apply both
-                // here so the clamp holds even when a custom dep ignores the filters.
+                // Defense-in-depth: hosts apply `modes`/`networkId`/`limit` SQL-side;
+                // re-apply all three here so the clamp holds even when a custom dep
+                // ignores the filters. Scoped rows without actor network metadata are
+                // hidden fail-closed because they cannot prove membership in this scope.
                 const visible = isScoped
-                    ? fetched.filter((q) => SELF_OWNED_MODES.includes(q.mode))
+                    ? fetched.filter((q) => SELF_OWNED_MODES.includes(q.mode) &&
+                        isVisibleInScopedNetwork(q, context.userId, scopedNetworkId))
                     : fetched;
-                const limited = visible.slice(0, limit);
+                const limited = visible.slice(0, limit).map(stripInternalActors);
                 if (isScoped) {
                     return success({
                         questions: limited,
                         scopeRestriction: {
                             isScoped: true,
-                            scopedToIndex: context.indexName ?? context.networkId,
-                            message: `Results exclude negotiation questions because this agent is scoped to ` +
-                                `"${context.indexName ?? "this index"}".`,
+                            scopedToIndex: focusedNetworkLabel(context),
+                            message: `Results are restricted to "${context.indexName ?? "this index"}" and ` +
+                                `exclude negotiation questions because this agent is scoped to that index.`,
                         },
                     });
                 }

package/dist/questioner/questioner.tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"questioner.tools.js","sourceRoot":"/","sources":["questioner/questioner.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAGjE;;;;;;GAMG;AACH,MAAM,gBAAgB,GAAmB,CAAC,YAAY,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AAE/E;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAsB,EAAE,IAAc;IAC1E,MAAM,oBAAoB,GAAG,UAAU,CAAC;QACtC,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EACT,kFAAkF;YAClF,kFAAkF;YAClF,4FAA4F;YAC5F,wFAAwF;YACxF,0FAA0F;YAC1F,+EAA+E;YAC/E,8BAA8B;YAC9B,2FAA2F;YAC3F,yFAAyF;YACzF,2CAA2C;QAC7C,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,EAAE,CAAC;iBACP,QAAQ,EAAE;iBACV,QAAQ,CAAC,2DAA2D,CAAC;SACzE,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;YACpC,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC;gBAC/B,OAAO,KAAK,CAAC,mCAAmC,CAAC,CAAC;YACpD,CAAC;YAED,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;YAChC,sEAAsE;YACtE,0DAA0D;YAC1D,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAE5C,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,MAAM,EAAE;oBAC9D,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAChD,KAAK;iBACN,CAAC,CAAC;gBACH,wEAAwE;gBACxE,sEAAsE;gBACtE,MAAM,OAAO,GAAG,QAAQ;oBACtB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAE,gBAA6B,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;oBACxE,CAAC,CAAC,OAAO,CAAC;gBACZ,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;gBAExC,IAAI,QAAQ,EAAE,CAAC;oBACb,OAAO,OAAO,CAAC;wBACb,SAAS,EAAE,OAAO;wBAClB,gBAAgB,EAAE;4BAChB,QAAQ,EAAE,IAAI;4BACd,aAAa,EAAE,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS;4BACrD,OAAO,EACL,wEAAwE;gCACxE,IAAI,OAAO,CAAC,SAAS,IAAI,YAAY,IAAI;yBAC5C;qBACF,CAAC,CAAC;gBACL,CAAC;gBAED,OAAO,OAAO,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;YACzC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,eAAe,EAAE,CAAC,GAAG,EAAE;oBAC1B,SAAS,EAAE,wBAAwB;oBACnC,QAAQ,EAAE,wBAAwB;oBAClC,MAAM,EAAE,OAAO,CAAC,MAAM;iBACvB,CAAC,CAAC;gBACH,OAAO,KAAK,CAAC,mCAAmC,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,CAAC,oBAAoB,CAAU,CAAC;AACzC,CAAC","sourcesContent":["import { z } from \"zod\";\n\nimport type { DefineTool, ToolDeps } from \"../shared/agent/tool.helpers.js\";\nimport { error, success } from \"../shared/agent/tool.helpers.js\";\nimport type { QuestionMode } from \"../shared/schemas/question.schema.js\";\n\n/**\n * Detection modes whose questions derive solely from the caller's own data\n * (profile gaps, own intents, own discovery sessions). Negotiation-mode\n * questions are excluded for network-scoped agents: their prompts are seeded\n * from opportunity metadata that can reference out-of-scope networks and\n * other users' content (same leak class as the getOpportunitiesForUser fix).\n */\nconst SELF_OWNED_MODES: QuestionMode[] = [\"enrichment\", \"intent\", \"discovery\"];\n\n/**\n * Creates MCP tool definitions for the questioner domain.\n * Exposes `read_pending_questions` for retrieving the caller's pending\n * questions generated by QuestionerAgent (enrichment, intent, negotiation, discovery modes).\n *\n * Network-scoped agent keys (context.networkId set via applyNetworkScopeToContext)\n * are clamped to self-owned modes; the result then carries a `scopeRestriction`\n * block mirroring the network-tools convention.\n *\n * @param defineTool - Tool factory provided by the composition root.\n * @param deps       - Shared tool dependencies; `findPendingQuestions` is optional\n *                     and the tool fails gracefully when absent.\n */\nexport function createQuestionerTools(defineTool: DefineTool, deps: ToolDeps) {\n  const readPendingQuestions = defineTool({\n    name: \"read_pending_questions\",\n    description:\n      \"Returns pending questions generated for the authenticated user across all modes \" +\n      \"(profile, intent, negotiation, discovery). These are questions generated by the \" +\n      \"system to help surface missing signals, refine intents, or capture engagement context.\\n\\n\" +\n      \"**Returns:** List of pending questions, each with `id`, `title`, `prompt`, `options`, \" +\n      \"`multiSelect`, `mode`, `sourceType`, `sourceId`, `createdAt`, and optional `expiresAt`. \" +\n      \"Network-scoped agents receive only profile/intent/discovery questions plus a \" +\n      \"`scopeRestriction` note.\\n\\n\" +\n      \"**Use:** Call with no arguments to get all pending questions, or pass `limit` to cap the \" +\n      \"count. For the daily brief the script calls with a small `limit` and renders the first \" +\n      \"question that has not been delivered yet.\",\n    querySchema: z.object({\n      limit: z\n        .number()\n        .int()\n        .min(1)\n        .max(10)\n        .optional()\n        .describe(\"Maximum number of questions to return (1-10, default 10).\"),\n    }),\n    handler: async ({ context, query }) => {\n      if (!deps.findPendingQuestions) {\n        return error(\"Question lookup is not available.\");\n      }\n\n      const limit = query.limit ?? 10;\n      // Scoped-key discriminator: applyNetworkScopeToContext sets networkId\n      // only for network-scoped agent keys (mcp.server.ts:558).\n      const isScoped = Boolean(context.networkId);\n\n      try {\n        const fetched = await deps.findPendingQuestions(context.userId, {\n          ...(isScoped ? { modes: SELF_OWNED_MODES } : {}),\n          limit,\n        });\n        // Defense-in-depth: hosts apply `modes`/`limit` SQL-side; re-apply both\n        // here so the clamp holds even when a custom dep ignores the filters.\n        const visible = isScoped\n          ? fetched.filter((q) => (SELF_OWNED_MODES as string[]).includes(q.mode))\n          : fetched;\n        const limited = visible.slice(0, limit);\n\n        if (isScoped) {\n          return success({\n            questions: limited,\n            scopeRestriction: {\n              isScoped: true,\n              scopedToIndex: context.indexName ?? context.networkId,\n              message:\n                `Results exclude negotiation questions because this agent is scoped to ` +\n                `\"${context.indexName ?? \"this index\"}\".`,\n            },\n          });\n        }\n\n        return success({ questions: limited });\n      } catch (err) {\n        deps.reportToolError?.(err, {\n          operation: \"read-pending-questions\",\n          toolName: \"read_pending_questions\",\n          userId: context.userId,\n        });\n        return error(\"Failed to read pending questions.\");\n      }\n    },\n  });\n\n  return [readPendingQuestions] as const;\n}\n"]}
+{"version":3,"file":"questioner.tools.js","sourceRoot":"/","sources":["questioner/questioner.tools.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\n\nimport type { DefineTool, ToolDeps } from \"../shared/agent/tool.helpers.js\";\nimport { error, success } from \"../shared/agent/tool.helpers.js\";\nimport { focusedNetworkId, focusedNetworkLabel } from \"../shared/agent/tool.scope.js\";\nimport type { PendingQuestionSummary } from \"../shared/schemas/pending-question.schema.js\";\nimport type { QuestionMode } from \"../shared/schemas/question.schema.js\";\n\n/**\n * Detection modes whose questions derive solely from the caller's own data\n * (profile gaps, own intents, own discovery sessions). Negotiation-mode\n * questions are excluded for network-scoped agents: their prompts are seeded\n * from opportunity metadata that can reference out-of-scope networks and\n * other users' content (same leak class as the getOpportunitiesForUser fix).\n */\nconst SELF_OWNED_MODES: QuestionMode[] = [\"enrichment\", \"intent\", \"discovery\"];\n\nfunction isVisibleInScopedNetwork(question: PendingQuestionSummary, userId: string, networkId: string): boolean {\n  return question.actors?.some((actor) => actor.userId === userId && actor.networkId === networkId) === true;\n}\n\nfunction stripInternalActors(question: PendingQuestionSummary): Omit<PendingQuestionSummary, \"actors\"> {\n  const { actors: _actors, ...publicQuestion } = question;\n  return publicQuestion;\n}\n\n/**\n * Creates MCP tool definitions for the questioner domain.\n * Exposes `read_pending_questions` for retrieving the caller's pending\n * questions generated by QuestionerAgent (enrichment, intent, negotiation, discovery modes).\n *\n * Network-scoped agent keys (context.scopeType/scopeId set via applyNetworkScopeToContext)\n * are clamped to self-owned modes; the result then carries a `scopeRestriction`\n * block mirroring the network-tools convention.\n *\n * @param defineTool - Tool factory provided by the composition root.\n * @param deps       - Shared tool dependencies; `findPendingQuestions` is optional\n *                     and the tool fails gracefully when absent.\n */\nexport function createQuestionerTools(defineTool: DefineTool, deps: ToolDeps) {\n  const readPendingQuestions = defineTool({\n    name: \"read_pending_questions\",\n    description:\n      \"Returns pending questions generated for the authenticated user across all modes \" +\n      \"(profile, intent, negotiation, discovery). These are questions generated by the \" +\n      \"system to help surface missing signals, refine intents, or capture engagement context.\\n\\n\" +\n      \"**Returns:** List of pending questions, each with `id`, `title`, `prompt`, `options`, \" +\n      \"`multiSelect`, `mode`, `sourceType`, `sourceId`, `createdAt`, and optional `expiresAt`. \" +\n      \"Network-scoped agents receive only profile/intent/discovery questions for the scoped network plus a \" +\n      \"`scopeRestriction` note.\\n\\n\" +\n      \"**Use:** Call with no arguments to get all pending questions, or pass `limit` to cap the \" +\n      \"count. For the daily brief the script calls with a small `limit` and renders the first \" +\n      \"question that has not been delivered yet.\",\n    querySchema: z.object({\n      limit: z\n        .number()\n        .int()\n        .min(1)\n        .max(10)\n        .optional()\n        .describe(\"Maximum number of questions to return (1-10, default 10).\"),\n    }),\n    handler: async ({ context, query }) => {\n      if (!deps.findPendingQuestions) {\n        return error(\"Question lookup is not available.\");\n      }\n\n      const limit = query.limit ?? 10;\n      // Scoped-key discriminator: scoped contexts carry a network scope envelope.\n      const scopedNetworkId = focusedNetworkId(context);\n      const isScoped = Boolean(scopedNetworkId);\n\n      try {\n        const fetched = await deps.findPendingQuestions(context.userId, {\n          ...(isScoped ? { modes: SELF_OWNED_MODES, networkId: scopedNetworkId } : {}),\n          limit,\n        });\n        // Defense-in-depth: hosts apply `modes`/`networkId`/`limit` SQL-side;\n        // re-apply all three here so the clamp holds even when a custom dep\n        // ignores the filters. Scoped rows without actor network metadata are\n        // hidden fail-closed because they cannot prove membership in this scope.\n        const visible = isScoped\n          ? fetched.filter(\n              (q) =>\n                (SELF_OWNED_MODES as string[]).includes(q.mode) &&\n                isVisibleInScopedNetwork(q, context.userId, scopedNetworkId!),\n            )\n          : fetched;\n        const limited = visible.slice(0, limit).map(stripInternalActors);\n\n        if (isScoped) {\n          return success({\n            questions: limited,\n            scopeRestriction: {\n              isScoped: true,\n              scopedToIndex: focusedNetworkLabel(context),\n              message:\n                `Results are restricted to \"${context.indexName ?? \"this index\"}\" and ` +\n                `exclude negotiation questions because this agent is scoped to that index.`,\n            },\n          });\n        }\n\n        return success({ questions: limited });\n      } catch (err) {\n        deps.reportToolError?.(err, {\n          operation: \"read-pending-questions\",\n          toolName: \"read_pending_questions\",\n          userId: context.userId,\n        });\n        return error(\"Failed to read pending questions.\");\n      }\n    },\n  });\n\n  return [readPendingQuestions] as const;\n}\n"]}