@lucern/sdk 0.3.0-alpha.4 → 0.3.0-alpha.6

package/README.md

@@ -10,6 +10,31 @@ Lucern gives your agents a reasoning graph that accumulates understanding across
 npm install @lucern/sdk
 ```
 
+## Install Model
+
+`@lucern/sdk` is the primary TypeScript app dependency. Installing it also
+installs its internal runtime dependencies, including Lucern contracts and
+reasoning-kernel helpers, but a tenant should still list any `@lucern/*`
+package that its own code or scripts import or execute.
+
+Common direct installs:
+
+| Need | Install |
+| --- | --- |
+| Programmatic Lucern API calls | `@lucern/sdk` |
+| Tool access checks | `@lucern/access-control` |
+| React hooks/components | `@lucern/react @lucern/sdk` |
+| Convex component binding | `@lucern/identity @lucern/reasoning-kernel` |
+| Bootstrap, auth, doctor, and operator commands | `@lucern/cli` |
+| Agent-facing MCP server/runtime | `@lucern/mcp` |
+| Full design-partner/package-suite pin | all packages from `TENANT_CLIENT_INSTALLABLE_PACKAGES` in `@lucern/contracts` |
+
+The difference matters: `@lucern/cli` is a direct install because it provides
+the `lucern` binary, but tenant app source should not import it. The Convex
+component packages are direct installs for `convex.config.ts`, while application
+code should stay on `@lucern/sdk`, `@lucern/react`, `@lucern/mcp`,
+`@lucern/access-control`, `@lucern/contracts`, and `@lucern/types`.
+
 ## Canonical Interface
 
 `@lucern/sdk` is the canonical public interface for Lucern.
@@ -363,6 +388,28 @@ lucern.identity       // API keys and sessions
 
 The graph doesn't just store knowledge — it analyzes itself.
 
+### Query Suite
+
+```typescript
+// Discover the prompt-backed Graph Intelligence recipes tenants can expose in
+// their own UI or model workflows.
+const catalog = await lucern.graphAnalysis.listGraphIntelligenceQueries();
+
+// Run a named recipe. Lucern returns the resolved prompt, deterministic graph
+// analysis bundle, sampled graph context, and public tool plan for LLM synthesis.
+const preMortem = await lucern.graphAnalysis.runGraphIntelligenceQuery({
+  topicId,
+  queryId: "pre-mortem",
+  limit: 25,
+});
+
+await modelMachine.run({
+  prompt: preMortem.data.prompt,
+  context: preMortem.data.analysis,
+  tools: preMortem.data.toolPlan,
+});
+```
+
 ### Structural Analysis
 
 ```typescript

package/dist/beliefs/index.d.ts

@@ -1,7 +1,7 @@
 import { ModulateConfidenceOpinionInput, OpinionHistoryEntry } from '../beliefsClient.js';
 import { PlatformGatewaySuccess } from '../coreClient.js';
 import { JsonObject } from '../types.js';
-import { L as LucernClientConfig } from '../client-DOLqClbU.js';
+import { LucernClientConfig } from '../client.js';
 import * as v1 from '@lucern/contracts/beliefs/v1';
 export { v1 as beliefsContracts };
 import * as toolContracts from '@lucern/contracts/tool-contracts';
@@ -36,11 +36,13 @@ import '../ontologyLinksClient.js';
 import '../orgGraphSearchClient.js';
 import '../graphRecommendationsClient.js';
 import '../graphAnalysisClient.js';
+import '@lucern/contracts';
 import '../embeddingsClient.js';
 import '../policyClient.js';
 import '../ontologyClient.js';
 import '../contextTypes.js';
 import '../topicsClient.js';
+import '../functionSurface.js';
 import '../answersClient.js';
 import '../auditClient.js';
 import '../contextClient.js';

package/dist/beliefs/index.js

@@ -4122,9 +4122,33 @@ function graphAnalysisQuery(input) {
     cursor: input.cursor
   };
 }
+function normalizeRunQueryPayload(input) {
+  return {
+    ...input,
+    topicId: requireTopicId2(input),
+    projectId: void 0
+  };
+}
 function createGraphAnalysisClient(config = {}) {
   const gateway = createGatewayRequestClient(config);
   return {
+    listGraphIntelligenceQueries(input = {}) {
+      return gateway.request({
+        path: "/api/platform/v1/graph-intelligence/queries",
+        method: "POST",
+        body: {
+          categoryId: input.categoryId,
+          mode: input.mode
+        }
+      });
+    },
+    runGraphIntelligenceQuery(input) {
+      return gateway.request({
+        path: "/api/platform/v1/graph-intelligence/run",
+        method: "POST",
+        body: normalizeRunQueryPayload(input)
+      });
+    },
     saveAnalysis(input, idempotencyKey) {
       return gateway.request({
         path: "/api/platform/v1/graph-analysis/analyses",
@@ -5027,6 +5051,7 @@ var CONTRACTS = {
   "list_beliefs": { method: "GET", path: "/beliefs", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
   "list_campaigns": { method: "GET", path: "/worktrees/campaigns", kind: "query", idempotent: false, surfaceIntent: "mcp_workflow" },
   "list_evidence": { method: "GET", path: "/evidence", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
+  "list_graph_intelligence_queries": { method: "POST", path: "/graph-intelligence/queries", kind: "query", idempotent: false, surfaceIntent: "mcp_analysis" },
   "list_lenses": { method: "GET", path: "/lenses", kind: "query", idempotent: false, surfaceIntent: "mcp_workflow" },
   "list_ontologies": { method: "GET", path: "/ontologies", kind: "query", idempotent: false, surfaceIntent: "mcp_workflow" },
   "list_questions": { method: "GET", path: "/questions", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
@@ -5050,6 +5075,7 @@ var CONTRACTS = {
   "register_session": { method: "POST", path: "/coordination/register-session", kind: "mutation", idempotent: true, surfaceIntent: "system" },
   "remove_lens_from_topic": { method: "DELETE", path: "/lenses/apply", kind: "mutation", idempotent: true, surfaceIntent: "mcp_workflow" },
   "resolve_effective_ontology": { method: "POST", path: "/ontologies/effective", kind: "query", idempotent: false, surfaceIntent: "mcp_workflow" },
+  "run_graph_intelligence_query": { method: "POST", path: "/graph-intelligence/run", kind: "query", idempotent: false, surfaceIntent: "mcp_analysis" },
   "search_beliefs": { method: "POST", path: "/beliefs/search", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
   "search_evidence": { method: "POST", path: "/evidence/search", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
   "seed_belief_lattice": { method: "POST", path: "/scope/belief-lattice/seed", kind: "mutation", idempotent: true, surfaceIntent: "system" },
@@ -5325,6 +5351,9 @@ function createFunctionSurfaceClient(config = {}) {
     listEvidence(input = {}, idempotencyKey) {
       return execute("list_evidence", input, idempotencyKey);
     },
+    listGraphIntelligenceQueries(input = {}, idempotencyKey) {
+      return execute("list_graph_intelligence_queries", input, idempotencyKey);
+    },
     listLenses(input = {}, idempotencyKey) {
       return execute("list_lenses", input, idempotencyKey);
     },
@@ -5394,6 +5423,9 @@ function createFunctionSurfaceClient(config = {}) {
     resolveEffectiveOntology(input = {}, idempotencyKey) {
       return execute("resolve_effective_ontology", input, idempotencyKey);
     },
+    runGraphIntelligenceQuery(input = {}, idempotencyKey) {
+      return execute("run_graph_intelligence_query", input, idempotencyKey);
+    },
     searchBeliefs(input = {}, idempotencyKey) {
       return execute("search_beliefs", input, idempotencyKey);
     },