@lucern/contracts 0.3.0-alpha.4 → 0.3.0-alpha.5

package/dist/function-registry/graph.d.ts

@@ -591,6 +591,84 @@ declare const graphContracts: readonly [{
         summary: string;
         tags: string[];
     };
+}, {
+    name: string;
+    kind: FunctionKind;
+    idempotent: FunctionIdempotency;
+    effects: readonly FunctionEffect[];
+    invariants: readonly string[] | undefined;
+    surfaceIntent: FunctionSurfaceIntent;
+    domain: string;
+    surfaceClass: SurfaceClass;
+    surfaces: FunctionSurfaceMap;
+    replacedBy: string | undefined;
+    rest: {
+        method: "GET" | "POST" | "PATCH" | "DELETE";
+        path: string;
+    };
+    sdk: {
+        namespace: string;
+        method: string;
+    };
+    mcp: {
+        exposed: boolean;
+        toolName: string;
+    } & McpToolContract & {
+        exposed: boolean;
+        toolName: string;
+    };
+    auth: {
+        scopes: string[];
+        allowedPrincipalTypes: ("user" | "service" | "agent")[];
+    };
+    convex: FunctionConvexTarget | undefined;
+    args: z.ZodTypeAny;
+    returns: z.ZodTypeAny;
+    input: z.ZodTypeAny;
+    output: z.ZodTypeAny;
+    openapi: {
+        summary: string;
+        tags: string[];
+    };
+}, {
+    name: string;
+    kind: FunctionKind;
+    idempotent: FunctionIdempotency;
+    effects: readonly FunctionEffect[];
+    invariants: readonly string[] | undefined;
+    surfaceIntent: FunctionSurfaceIntent;
+    domain: string;
+    surfaceClass: SurfaceClass;
+    surfaces: FunctionSurfaceMap;
+    replacedBy: string | undefined;
+    rest: {
+        method: "GET" | "POST" | "PATCH" | "DELETE";
+        path: string;
+    };
+    sdk: {
+        namespace: string;
+        method: string;
+    };
+    mcp: {
+        exposed: boolean;
+        toolName: string;
+    } & McpToolContract & {
+        exposed: boolean;
+        toolName: string;
+    };
+    auth: {
+        scopes: string[];
+        allowedPrincipalTypes: ("user" | "service" | "agent")[];
+    };
+    convex: FunctionConvexTarget | undefined;
+    args: z.ZodTypeAny;
+    returns: z.ZodTypeAny;
+    input: z.ZodTypeAny;
+    output: z.ZodTypeAny;
+    openapi: {
+        summary: string;
+        tags: string[];
+    };
 }];
 
 export { graphContracts };

package/dist/function-registry/graph.js

@@ -1146,6 +1146,74 @@ var GET_GRAPH_STRUCTURE_ANALYSIS = {
   ontologyPrimitive: "graph",
   tier: "showcase"
 };
+var LIST_GRAPH_INTELLIGENCE_QUERIES = {
+  name: "list_graph_intelligence_queries",
+  description: "List the Graph Intelligence query catalog that powers structural graph analysis experiences. Returns categories, query IDs, prompt templates, modes, and the public tool plan each query can use.",
+  parameters: {
+    categoryId: {
+      type: "string",
+      description: "Optional category filter, such as problems or strategic"
+    },
+    mode: {
+      type: "string",
+      description: "Optional mode filter: core, bias, stress, operational, alpha, semantic, or evidence"
+    }
+  },
+  required: [],
+  response: {
+    description: "Graph Intelligence query catalog and mode-to-tool mapping",
+    fields: {
+      categories: "array \u2014 query categories",
+      queries: "array \u2014 query definitions with prompt templates and tools",
+      quickQueries: "array \u2014 recommended one-click query presets",
+      publicToolNamesByMode: "object \u2014 public tool names available to each Graph Intelligence mode"
+    }
+  },
+  ownerModule: "graph-intelligence",
+  ontologyPrimitive: "graph",
+  tier: "showcase"
+};
+var RUN_GRAPH_INTELLIGENCE_QUERY = {
+  name: "run_graph_intelligence_query",
+  description: "Run a named Graph Intelligence query against a tenant topic graph. Returns the selected query, prompt, deterministic graph-analysis bundle, graph context, and public tool plan for model synthesis.",
+  parameters: {
+    topicId: { type: "string", description: "Topic to analyze" },
+    queryId: {
+      type: "string",
+      description: "Graph Intelligence query ID, such as confirmation-bias, pre-mortem, or thesis-summary"
+    },
+    prompt: {
+      type: "string",
+      description: "Optional custom prompt for custom analysis runs"
+    },
+    input: {
+      type: "string",
+      description: "Optional entity, theme, belief, company, or search text for input-driven queries"
+    },
+    mode: {
+      type: "string",
+      description: "Optional mode override: core, bias, stress, operational, alpha, semantic, or evidence"
+    },
+    limit: {
+      type: "number",
+      description: "Maximum graph context rows to return"
+    }
+  },
+  required: ["topicId"],
+  response: {
+    description: "Graph Intelligence query result bundle ready for model or prompt-library synthesis",
+    fields: {
+      query: "object \u2014 selected query definition",
+      prompt: "string \u2014 resolved prompt template",
+      toolPlan: "array \u2014 public tools and args the model can call next",
+      analysis: "object \u2014 structure, coverage, gap, and confirmation-bias analysis",
+      context: "object \u2014 sampled beliefs, questions, evidence, edges, and contradictions"
+    }
+  },
+  ownerModule: "graph-intelligence",
+  ontologyPrimitive: "graph",
+  tier: "showcase"
+};
 var GET_FALSIFICATION_QUESTIONS = {
   name: "get_falsification_questions",
   description: "Generate Popperian falsification questions for beliefs. Like `git test` \u2014 identifies the questions most likely to disprove current beliefs. Karl Popper as a tool: surfaces what would need to be true to invalidate each belief.",
@@ -3721,6 +3789,8 @@ var MCP_TOOL_CONTRACTS = {
   // Graph intelligence (showcase)
   detect_confirmation_bias: DETECT_CONFIRMATION_BIAS,
   get_graph_structure_analysis: GET_GRAPH_STRUCTURE_ANALYSIS,
+  list_graph_intelligence_queries: LIST_GRAPH_INTELLIGENCE_QUERIES,
+  run_graph_intelligence_query: RUN_GRAPH_INTELLIGENCE_QUERY,
   get_falsification_questions: GET_FALSIFICATION_QUESTIONS,
   // Evidence operations (workhorse)
   search_evidence: SEARCH_EVIDENCE,
@@ -3903,6 +3973,8 @@ var MCP_ANALYSIS_PLATFORM_OPERATION_NAMES = [
   "traverse_graph",
   "get_graph_neighborhood",
   "get_graph_structure_analysis",
+  "list_graph_intelligence_queries",
+  "run_graph_intelligence_query",
   "find_contradictions",
   "flag_contradiction",
   "detect_confirmation_bias",
@@ -4390,6 +4462,15 @@ function surfaceContract(args) {
     }
   });
 }
+var graphIntelligenceQueryModes = [
+  "core",
+  "bias",
+  "stress",
+  "operational",
+  "alpha",
+  "semantic",
+  "evidence"
+];
 var traversalLayerSchema = z.enum([
   "L4",
   "L3",
@@ -4423,6 +4504,22 @@ var graphNeighborhoodArgs = z.object({
   topicId: z.string().optional().describe("Topic scope for edge lookup."),
   limit: z.number().optional().describe("Maximum edges to return.")
 });
+var graphIntelligenceModeSchema = z.enum([
+  graphIntelligenceQueryModes[0],
+  ...graphIntelligenceQueryModes.slice(1)
+]);
+var graphIntelligenceCatalogArgs = z.object({
+  categoryId: z.string().optional().describe("Optional query category filter."),
+  mode: graphIntelligenceModeSchema.optional().describe("Optional Graph Intelligence query mode filter.")
+});
+var graphIntelligenceRunArgs = z.object({
+  topicId: z.string().describe("Topic to analyze."),
+  queryId: z.string().optional().describe("Catalog query ID to run, such as pre-mortem."),
+  prompt: z.string().optional().describe("Custom prompt when queryId is omitted or overridden."),
+  input: z.string().optional().describe("Optional entity, theme, belief, company, or search text."),
+  mode: graphIntelligenceModeSchema.optional().describe("Optional query mode override for custom prompts."),
+  limit: z.number().optional().describe("Maximum graph context rows to return.")
+});
 var flagContradictionArgs = z.object({
   beliefA: z.string().describe("First belief in tension."),
   beliefB: z.string().describe("Second belief in tension."),
@@ -4528,6 +4625,38 @@ var graphContracts = [
       kind: "query"
     }
   }),
+  surfaceContract({
+    name: "list_graph_intelligence_queries",
+    kind: "query",
+    domain: "graph",
+    surfaceClass: "platform_public",
+    path: "/graph-intelligence/queries",
+    sdkNamespace: "graphAnalysis",
+    sdkMethod: "listGraphIntelligenceQueries",
+    summary: "List Graph Intelligence query catalog entries.",
+    convex: {
+      module: "contextCompiler",
+      functionName: "listGraphIntelligenceQueries",
+      kind: "query"
+    },
+    args: graphIntelligenceCatalogArgs
+  }),
+  surfaceContract({
+    name: "run_graph_intelligence_query",
+    kind: "query",
+    domain: "graph",
+    surfaceClass: "platform_public",
+    path: "/graph-intelligence/run",
+    sdkNamespace: "graphAnalysis",
+    sdkMethod: "runGraphIntelligenceQuery",
+    summary: "Run a Graph Intelligence query against a topic graph.",
+    convex: {
+      module: "contextCompiler",
+      functionName: "runGraphIntelligenceQuery",
+      kind: "query"
+    },
+    args: graphIntelligenceRunArgs
+  }),
   surfaceContract({
     name: "find_contradictions",
     kind: "query",