@lucern/mcp 0.3.0-alpha.7 → 0.3.0-alpha.9

package/dist/index.js

@@ -300,9 +300,14 @@ function loadProfile(options) {
   const profiles = readProfilesFile(profilesPath());
   const localEnv = options.readLocalEnv === false ? {} : readLocalEnvFiles(options.cwd);
   const mergedEnv = { ...localEnv, ...options.env };
-  const selected = options.profileName ?? mergedEnv.LUCERN_PROFILE ?? profiles.activeProfile ?? credentials.LUCERN_PROFILE ?? "default";
-  const savedProfile = profiles.profiles?.[selected] ?? {};
   const envProfile = profileFromEnvironment(mergedEnv);
+  const hasEnvCredentials = Boolean(
+    envProfile.apiKey || envProfile.userToken || envProfile.packKey
+  );
+  const explicitProfileSelected = options.profileName !== void 0 || mergedEnv.LUCERN_PROFILE !== void 0;
+  const selectedProfile = options.profileName ?? mergedEnv.LUCERN_PROFILE ?? profiles.activeProfile ?? credentials.LUCERN_PROFILE ?? "default";
+  const selected = hasEnvCredentials && !explicitProfileSelected ? "env" : selectedProfile;
+  const savedProfile = hasEnvCredentials && !explicitProfileSelected ? {} : profiles.profiles?.[selectedProfile] ?? {};
   const credentialsProfile = {
     apiKey: credentials.LUCERN_API_KEY,
     userToken: readFirst(credentials, ["LUCERN_SESSION_TOKEN", "LUCERN_USER_TOKEN"]),
@@ -5273,17 +5278,44 @@ z.object({
     message: "SL invariant b+d+u=1 violated at API boundary"
   }
 );
-var EpistemicNodeTypeSchema = z.enum([
+
+// ../contracts/src/schema-helpers/spine/tables/epistemicNodes.ts
+var NODE_TYPES = [
+  "decision",
   "belief",
-  "evidence",
   "question",
-  "answer",
+  "theme",
+  "deal",
   "topic",
+  "claim",
+  "evidence",
+  "synthesis",
+  "answer",
+  "atomic_fact",
+  "excerpt",
+  "source",
+  "company",
+  "person",
+  "investor",
+  "function",
+  "value_chain"
+];
+new Set(NODE_TYPES);
+
+// ../contracts/src/types/graph-ref.ts
+var GRAPH_REF_EXTRA_NODE_TYPES = [
   "edge",
   "ontology",
   "lens",
   "contradiction"
-]);
+];
+var GRAPH_REF_NODE_TYPES = [
+  ...NODE_TYPES,
+  ...GRAPH_REF_EXTRA_NODE_TYPES
+];
+var EpistemicNodeTypeSchema = z.enum(
+  GRAPH_REF_NODE_TYPES
+);
 var GraphRefSchema = z.discriminatedUnion("kind", [
   z.object({
     kind: z.literal("epistemic_node"),
@@ -5331,33 +5363,14 @@ function assertEdgePolicyAllowed(manifest, edgeType, from, to) {
 }
 
 // ../contracts/src/manifests/edge-policy-manifest.data.ts
+var publicEpistemicNodeEdgePolicy = (edgeType) => ({
+  edgeType,
+  fromKinds: ["epistemic_node"],
+  toKinds: ["epistemic_node"],
+  description: "Canonical public create_edge policy for graph-node relationships. The policy layer gates edge-type membership, not endpoint semantics."
+});
 var edgePolicyManifest = {
-  policies: [
-    {
-      edgeType: "evidence_derived_from_evidence",
-      fromKinds: ["epistemic_node"],
-      fromNodeTypes: ["evidence"],
-      toKinds: ["epistemic_node"],
-      toNodeTypes: ["evidence"],
-      description: "Evidence E2 was synthesized from evidence E1 by a transformation. Provides chain-of-evidence lineage."
-    },
-    {
-      edgeType: "evidence_supports_belief",
-      fromKinds: ["epistemic_node"],
-      fromNodeTypes: ["evidence"],
-      toKinds: ["epistemic_node"],
-      toNodeTypes: ["belief"],
-      description: "Existing link_evidence_to_belief semantics promoted to the create_edge policy source."
-    },
-    {
-      edgeType: "evidence_supports_question",
-      fromKinds: ["epistemic_node"],
-      fromNodeTypes: ["evidence"],
-      toKinds: ["epistemic_node"],
-      toNodeTypes: ["question"],
-      description: "Existing link_evidence_to_question semantics promoted to the create_edge policy source."
-    }
-  ]
+  policies: EDGE_TYPE_VALUES.map(publicEpistemicNodeEdgePolicy)
 };
 
 // ../contracts/src/tenant-client.contract.ts
@@ -8083,15 +8096,15 @@ var IDENTITY_WHOAMI = {
 };
 var COMPILE_CONTEXT = {
   name: "compile_context",
-  description: "Compile a focused reasoning context for a topic. Like `git log --graph --decorate` for the reasoning substrate \u2014 returns the canonical Pillar 3 context pack through the public API shape.",
+  description: "Compile a focused reasoning context. If topicId is omitted, Lucern resolves the best topic from the query. Like `git log --graph --decorate` for the reasoning substrate \u2014 returns the canonical Pillar 3 context pack through the public API shape.",
   parameters: {
     topicId: {
       type: "string",
-      description: "Topic scope ID to compile"
+      description: "Optional topic scope ID. Omit to resolve the topic from query."
     },
     query: {
       type: "string",
-      description: "Optional focus query used to rank context items"
+      description: "Focus query used to resolve the topic and rank context items. Required when topicId is omitted."
     },
     budget: {
       type: "number",
@@ -8115,7 +8128,7 @@ var COMPILE_CONTEXT = {
       description: "Include related ontological entities in the compiled result"
     }
   },
-  required: ["topicId"],
+  required: [],
   response: {
     description: "Compiled context pack for the requested topic",
     fields: {
@@ -10626,7 +10639,7 @@ var contextContracts = [
     path: "/context/compile",
     sdkNamespace: "context",
     sdkMethod: "compileContext",
-    summary: "Compile a focused reasoning context for a topic.",
+    summary: "Compile a focused reasoning context, resolving topic from query when omitted.",
     convex: {
       module: "contextCompiler",
       functionName: "compile",
@@ -11092,12 +11105,12 @@ var linkEvidenceToBeliefEdgeInput = (input, context) => withCreatedBy(
   compactRecord4({
     fromNodeId: input.insightId ?? input.evidenceNodeId ?? input.evidenceId,
     toNodeId: input.beliefNodeId ?? input.beliefId ?? input.targetId,
-    edgeType: "evidence_supports_belief",
+    edgeType: "informs",
     globalId: input.globalId ?? `edge:${String(
       input.insightId ?? input.evidenceNodeId ?? input.evidenceId
     )}:${String(
       input.beliefNodeId ?? input.beliefId ?? input.targetId
-    )}:evidence_supports_belief`,
+    )}:informs`,
     weight: typeof input.weight === "number" ? input.weight : input.type === "contradicting" ? -1 : 1,
     context: input.rationale ?? input.context,
     skipLayerValidation: true,
@@ -11110,12 +11123,12 @@ var linkEvidenceToQuestionEdgeInput = (input, context) => withCreatedBy(
   compactRecord4({
     fromNodeId: input.insightId ?? input.evidenceNodeId ?? input.evidenceId,
     toNodeId: input.questionId ?? input.questionNodeId ?? input.targetId,
-    edgeType: "evidence_supports_question",
+    edgeType: "responds_to",
     globalId: input.globalId ?? `edge:${String(
       input.insightId ?? input.evidenceNodeId ?? input.evidenceId
     )}:${String(
       input.questionId ?? input.questionNodeId ?? input.targetId
-    )}:evidence_supports_question`,
+    )}:responds_to`,
     weight: input.impactScore ?? input.weight,
     context: input.rationale ?? input.context,
     skipLayerValidation: true,
@@ -12620,10 +12633,13 @@ var tasksContracts = [
     }
   })
 ];
+var CREATE_EDGE_TYPES = edgePolicyManifest.policies.map(
+  (policy) => policy.edgeType
+);
 var createEdgeArgs = z.object({
   from: GraphRefSchema,
   to: GraphRefSchema,
-  edgeType: z.string(),
+  edgeType: z.enum(CREATE_EDGE_TYPES),
   globalId: z.string().optional(),
   weight: z.number().optional(),
   confidence: z.number().optional(),
@@ -18961,50 +18977,55 @@ function cleanNumber(value) {
 function cleanBoolean(value) {
   return typeof value === "boolean" ? value : void 0;
 }
-function buildCompileContextRequest(topicId, input = {}) {
-  const payload = { topicId };
-  const query5 = cleanString4(input.query);
+function buildCompileContextRequest(topicIdOrInput = {}, input = {}) {
+  const effectiveInput = typeof topicIdOrInput === "string" ? input : topicIdOrInput;
+  const payload = {};
+  const topicId = typeof topicIdOrInput === "string" ? cleanString4(topicIdOrInput) : cleanString4(effectiveInput.topicId);
+  if (topicId) {
+    payload.topicId = topicId;
+  }
+  const query5 = cleanString4(effectiveInput.query);
   if (query5) {
     payload.query = query5;
   }
-  const budget = cleanNumber(input.budget) ?? cleanNumber(input.tokenBudget);
+  const budget = cleanNumber(effectiveInput.budget) ?? cleanNumber(effectiveInput.tokenBudget);
   if (budget !== void 0) {
     payload.budget = budget;
   }
-  const ranking = cleanString4(input.ranking) ?? cleanString4(input.rankingProfile);
+  const ranking = cleanString4(effectiveInput.ranking) ?? cleanString4(effectiveInput.rankingProfile);
   if (ranking) {
     payload.ranking = ranking;
   }
-  const limit = cleanNumber(input.limit);
+  const limit = cleanNumber(effectiveInput.limit);
   if (limit !== void 0) {
     payload.limit = limit;
   }
-  const maxDepth = cleanNumber(input.maxDepth);
+  const maxDepth = cleanNumber(effectiveInput.maxDepth);
   if (maxDepth !== void 0) {
     payload.maxDepth = maxDepth;
   }
-  const includeEntities = cleanBoolean(input.includeEntities);
+  const includeEntities = cleanBoolean(effectiveInput.includeEntities);
   if (includeEntities !== void 0) {
     payload.includeEntities = includeEntities;
   }
-  const mode = cleanString4(input.mode);
+  const mode = cleanString4(effectiveInput.mode);
   if (mode) {
     payload.mode = mode;
   }
-  const includeFailures = cleanBoolean(input.includeFailures);
+  const includeFailures = cleanBoolean(effectiveInput.includeFailures);
   if (includeFailures !== void 0) {
     payload.includeFailures = includeFailures;
   }
-  const worktreeId = cleanString4(input.worktreeId);
+  const worktreeId = cleanString4(effectiveInput.worktreeId);
   if (worktreeId) {
     payload.worktreeId = worktreeId;
   }
-  const sessionId = cleanString4(input.sessionId);
+  const sessionId = cleanString4(effectiveInput.sessionId);
   if (sessionId) {
     payload.sessionId = sessionId;
   }
-  if (Array.isArray(input.packWeightOverrides) && input.packWeightOverrides.length > 0) {
-    payload.packWeightOverrides = input.packWeightOverrides;
+  if (Array.isArray(effectiveInput.packWeightOverrides) && effectiveInput.packWeightOverrides.length > 0) {
+    payload.packWeightOverrides = effectiveInput.packWeightOverrides;
   }
   return {
     path: "/api/platform/v1/context/compile",
@@ -19016,13 +19037,20 @@ function createContextClient(config = {}) {
   const gateway = createGatewayRequestClient(config);
   return {
     /**
-     * Compile a focused reasoning context pack for a topic scope.
-     * @param topicId - The topic to compile context for.
+     * Compile a focused reasoning context pack.
+     * @param topicIdOrInput - Optional topic ID, or compile input for query-first resolution.
      * @param input - Optional compile parameters (query, budget, ranking, etc.).
      * @returns The compiled context payload with beliefs, questions, and evidence.
      */
-    async compile(topicId, input = {}) {
-      const request = buildCompileContextRequest(topicId, input);
+    async compile(topicIdOrInput = {}, input = {}) {
+      const request = buildCompileContextRequest(topicIdOrInput, input);
+      return gateway.request({
+        ...request,
+        body: request.body
+      });
+    },
+    async compileByQuery(input = {}) {
+      const request = buildCompileContextRequest(input);
       return gateway.request({
         ...request,
         body: request.body
@@ -21420,6 +21448,21 @@ function createSchemaClient(config = {}) {
 }
 
 // ../sdk/src/clientHelpers.ts
+function normalizeCustomNamespace(namespace) {
+  return namespace.trim() || "custom";
+}
+function normalizeCustomToolPayload(input) {
+  return input && typeof input === "object" && !Array.isArray(input) ? input : {};
+}
+function resolveCustomToolFullName(name) {
+  return name.includes(".") ? name : `custom.${name}`;
+}
+function buildBeliefsRefinePayload(textOrInput, rationale) {
+  return typeof textOrInput === "string" ? { text: textOrInput, rationale } : { text: textOrInput.text, rationale: textOrInput.rationale };
+}
+function buildBeliefsArchivePayload(input) {
+  return typeof input === "string" ? { reason: input } : input ? { reason: input.reason ?? input.rationale } : void 0;
+}
 function asNodeArray(data) {
   const rows = asListItems(data, "nodes");
   if (rows.length > 0) {
@@ -21797,7 +21840,7 @@ function createToolRegistryClient(config = {}) {
 }
 
 // ../sdk/src/version.ts
-var LUCERN_SDK_VERSION = "0.3.0-alpha.7";
+var LUCERN_SDK_VERSION = "0.3.0-alpha.9";
 
 // ../sdk/src/workflowClient.ts
 function normalizeLensQuery(value) {
@@ -22318,11 +22361,11 @@ function createLucernClient(config = {}) {
     }
   }
   const invokeCustomTool = async (fullName, input = {}) => {
-    const payload = input && typeof input === "object" && !Array.isArray(input) ? input : {};
+    const payload = normalizeCustomToolPayload(input);
     return invokeRegisteredCustomTool(fullName, payload, { source: "sdk" });
   };
   const getCustomNamespace = (namespace) => {
-    const normalized = namespace.trim() || "custom";
+    const normalized = normalizeCustomNamespace(namespace);
     const cached = customNamespaceCache.get(normalized);
     if (cached) {
       return cached;
@@ -22782,10 +22825,7 @@ function createLucernClient(config = {}) {
         return beliefsFacade.get(nodeId).then(exposeGatewayData);
       },
       refine(nodeId, textOrInput, rationale) {
-        const payload = typeof textOrInput === "string" ? { text: textOrInput, rationale } : {
-          text: textOrInput.text,
-          rationale: textOrInput.rationale
-        };
+        const payload = buildBeliefsRefinePayload(textOrInput, rationale);
         return beliefsFacade.refine(nodeId, payload).then(exposeGatewayData);
       },
       updateConfidence(nodeId, input) {
@@ -22823,7 +22863,7 @@ function createLucernClient(config = {}) {
         }).then(exposeGatewayData);
       },
       archive(nodeId, input) {
-        const payload = typeof input === "string" ? { reason: input } : input ? { reason: input.reason ?? input.rationale } : void 0;
+        const payload = buildBeliefsArchivePayload(input);
         return beliefsFacade.archive(nodeId, payload).then(exposeGatewayData);
       },
       list(args) {
@@ -23863,7 +23903,7 @@ function createLucernClient(config = {}) {
       list: listRegisteredCustomTools,
       clear: clearRegisteredCustomTools,
       invoke(name, input = {}) {
-        const fullName = name.includes(".") ? name : `custom.${name}`;
+        const fullName = resolveCustomToolFullName(name);
         return invokeCustomTool(fullName, input);
       },
       namespace: getCustomNamespace
@@ -23962,50 +24002,55 @@ function cleanNumber2(value) {
 function cleanBoolean2(value) {
   return typeof value === "boolean" ? value : void 0;
 }
-function buildCompileContextRequest2(topicId, input = {}) {
-  const payload = { topicId };
-  const query5 = cleanString6(input.query);
+function buildCompileContextRequest2(topicIdOrInput = {}, input = {}) {
+  const effectiveInput = typeof topicIdOrInput === "string" ? input : topicIdOrInput;
+  const payload = {};
+  const topicId = typeof topicIdOrInput === "string" ? cleanString6(topicIdOrInput) : cleanString6(effectiveInput.topicId);
+  if (topicId) {
+    payload.topicId = topicId;
+  }
+  const query5 = cleanString6(effectiveInput.query);
   if (query5) {
     payload.query = query5;
   }
-  const budget = cleanNumber2(input.budget) ?? cleanNumber2(input.tokenBudget);
+  const budget = cleanNumber2(effectiveInput.budget) ?? cleanNumber2(effectiveInput.tokenBudget);
   if (budget !== void 0) {
     payload.budget = budget;
   }
-  const ranking = cleanString6(input.ranking) ?? cleanString6(input.rankingProfile);
+  const ranking = cleanString6(effectiveInput.ranking) ?? cleanString6(effectiveInput.rankingProfile);
   if (ranking) {
     payload.ranking = ranking;
   }
-  const limit = cleanNumber2(input.limit);
+  const limit = cleanNumber2(effectiveInput.limit);
   if (limit !== void 0) {
     payload.limit = limit;
   }
-  const maxDepth = cleanNumber2(input.maxDepth);
+  const maxDepth = cleanNumber2(effectiveInput.maxDepth);
   if (maxDepth !== void 0) {
     payload.maxDepth = maxDepth;
   }
-  const includeEntities = cleanBoolean2(input.includeEntities);
+  const includeEntities = cleanBoolean2(effectiveInput.includeEntities);
   if (includeEntities !== void 0) {
     payload.includeEntities = includeEntities;
   }
-  const mode = cleanString6(input.mode);
+  const mode = cleanString6(effectiveInput.mode);
   if (mode) {
     payload.mode = mode;
   }
-  const includeFailures = cleanBoolean2(input.includeFailures);
+  const includeFailures = cleanBoolean2(effectiveInput.includeFailures);
   if (includeFailures !== void 0) {
     payload.includeFailures = includeFailures;
   }
-  const worktreeId = cleanString6(input.worktreeId);
+  const worktreeId = cleanString6(effectiveInput.worktreeId);
   if (worktreeId) {
     payload.worktreeId = worktreeId;
   }
-  const sessionId = cleanString6(input.sessionId);
+  const sessionId = cleanString6(effectiveInput.sessionId);
   if (sessionId) {
     payload.sessionId = sessionId;
   }
-  if (Array.isArray(input.packWeightOverrides) && input.packWeightOverrides.length > 0) {
-    payload.packWeightOverrides = input.packWeightOverrides;
+  if (Array.isArray(effectiveInput.packWeightOverrides) && effectiveInput.packWeightOverrides.length > 0) {
+    payload.packWeightOverrides = effectiveInput.packWeightOverrides;
   }
   return {
     path: "/api/platform/v1/context/compile",
@@ -24015,8 +24060,12 @@ function buildCompileContextRequest2(topicId, input = {}) {
 }
 function createContextFacade(config) {
   return {
-    compile(topicId, input = {}) {
-      const request = buildCompileContextRequest2(topicId, input);
+    compile(topicIdOrInput = {}, input = {}) {
+      const request = buildCompileContextRequest2(topicIdOrInput, input);
+      return config.transport.request(request);
+    },
+    compileByQuery(input = {}) {
+      const request = buildCompileContextRequest2(input);
       return config.transport.request(request);
     }
   };
@@ -26665,24 +26714,27 @@ function readResultString(value, key) {
 }
 function createContextHandlers(context) {
   const compiler = createContextClient(context.sdkConfig);
+  const functionSurface = createFunctionSurfaceClient(context.sdkConfig);
   return {
     compile_context: contractToHandler(
       MCP_TOOL_CONTRACTS.compile_context,
       async (params) => {
-        const topicId = readTopicId4(params, { required: true });
-        const response = await compiler.compile(
-          topicId,
-          {
-            ...readString3(params, "query") ? { query: readString3(params, "query") } : {},
-            ...readNumber2(params, "budget") !== void 0 ? { budget: readNumber2(params, "budget") } : {},
-            ...readString3(params, "ranking") ? {
-              ranking: readString3(params, "ranking")
-            } : {},
-            ...readNumber2(params, "limit") !== void 0 ? { limit: readNumber2(params, "limit") } : {},
-            ...readNumber2(params, "maxDepth") !== void 0 ? { maxDepth: readNumber2(params, "maxDepth") } : {},
-            ...readBoolean(params, "includeEntities") !== void 0 ? { includeEntities: readBoolean(params, "includeEntities") } : {}
-          }
-        );
+        const topicId = readTopicId4(params);
+        const query5 = readString3(params, "query");
+        const input = {
+          ...query5 ? { query: query5 } : {},
+          ...readNumber2(params, "budget") !== void 0 ? { budget: readNumber2(params, "budget") } : {},
+          ...readString3(params, "ranking") ? {
+            ranking: readString3(params, "ranking")
+          } : {},
+          ...readNumber2(params, "limit") !== void 0 ? { limit: readNumber2(params, "limit") } : {},
+          ...readNumber2(params, "maxDepth") !== void 0 ? { maxDepth: readNumber2(params, "maxDepth") } : {},
+          ...readBoolean(params, "includeEntities") !== void 0 ? { includeEntities: readBoolean(params, "includeEntities") } : {}
+        };
+        if (!topicId && !query5) {
+          throw new Error("[compile_context] query is required when topicId is omitted.");
+        }
+        const response = topicId ? await compiler.compile(topicId, input) : await functionSurface.compileContext(input);
         writeLocalLucernContext({
           topicId: readResultString(response.data, "topicId") ?? topicId,
           topicName: readResultString(response.data, "topicName"),
@@ -28530,7 +28582,7 @@ function createLucernStandaloneMcpServer(options) {
   });
   const server = new McpServer({
     name: "lucern-mcp",
-    version: "0.3.0-alpha.7"
+    version: "0.3.0-alpha.9"
   });
   registerTools(server, runtime);
   const resources = registerResources(server, runtime, observationStore);