@lucern/sdk 0.3.0-alpha.9 → 1.0.0

package/dist/functionSurfaceClient.js

@@ -322,13 +322,31 @@ function mergeHeaderRecord(base, addition) {
   }
   return Object.fromEntries(headers.entries());
 }
+function cleanHeaderValue(value) {
+  const normalized = value?.trim();
+  return normalized ? normalized : void 0;
+}
 function createGatewayRequestClient(config = {}) {
   const fetchImpl = config.fetchImpl ?? fetch;
   const baseUrl = config.baseUrl?.replace(/\/+$/, "") ?? "";
   const maxRetries = config.maxRetries ?? 2;
   const requestIdFactory = config.requestIdFactory ?? (() => generatePortableRequestId());
   async function resolveAuthHeaders() {
-    const base = config.getAuthHeaders ? await config.getAuthHeaders() : {};
+    const provided = config.getAuthHeaders ? await config.getAuthHeaders() : {};
+    const headers = new Headers(provided);
+    const setIfAbsent = (name, value) => {
+      const normalized = cleanHeaderValue(value);
+      if (normalized && !headers.has(name)) {
+        headers.set(name, normalized);
+      }
+    };
+    setIfAbsent("x-lucern-key", config.apiKey);
+    setIfAbsent("x-lucern-session-token", config.userToken);
+    setIfAbsent("x-lucern-environment", config.environment);
+    setIfAbsent("x-lucern-clerk-id", config.clerkId);
+    setIfAbsent("x-lucern-user-id", config.userId ?? config.clerkId);
+    setIfAbsent("x-lucern-deployment-host", config.deploymentHost);
+    const base = Object.fromEntries(headers.entries());
     const authContextInput = await resolveConfiguredAuthContext(
       config.authContext
     );
@@ -555,6 +573,7 @@ var FUNCTION_SURFACE_METHOD_PATHS = [
   "contracts.evaluateContract",
   "contracts.getContractStatus",
   "contradictions.flagContradiction",
+  "controlPlane.identity.resolveInteractivePrincipal",
   "coordination.broadcastMessage",
   "coordination.claimFiles",
   "coordination.endSession",
@@ -563,8 +582,12 @@ var FUNCTION_SURFACE_METHOD_PATHS = [
   "coordination.listActiveSessions",
   "coordination.registerSession",
   "coordination.sendAgentMessage",
+  "edges.batchCreateEdges",
   "edges.createEdge",
   "edges.queryLineage",
+  "edges.removeEdge",
+  "edges.removeEdgesBetween",
+  "edges.updateEdge",
   "evidence.addEvidence",
   "evidence.createEvidence",
   "evidence.getEvidence",
@@ -592,6 +615,14 @@ var FUNCTION_SURFACE_METHOD_PATHS = [
   "lenses.createLens",
   "lenses.listLenses",
   "lenses.removeLensFromTopic",
+  "nodes.archiveEpistemicNode",
+  "nodes.batchCreateEpistemicNodes",
+  "nodes.createEpistemicNode",
+  "nodes.getEpistemicNode",
+  "nodes.listEpistemicNodes",
+  "nodes.supersedeEpistemicNode",
+  "nodes.updateEpistemicNode",
+  "nodes.verifyEpistemicNode",
   "observations.getObservationContext",
   "observations.ingestObservation",
   "ontologies.applyOntology",
@@ -621,8 +652,10 @@ var FUNCTION_SURFACE_METHOD_PATHS = [
   "tasks.updateTask",
   "topics.createTopic",
   "topics.getTopic",
+  "topics.getTopicGraphSpine",
   "topics.getTopicTree",
   "topics.listTopics",
+  "topics.materializeTopicGraph",
   "topics.updateTopic",
   "worktrees.activateWorktree",
   "worktrees.addWorktree",
@@ -647,8 +680,11 @@ var CONTRACTS = {
   "apply_lens_to_topic": { method: "POST", path: "/lenses/apply", kind: "mutation", idempotent: true, surfaceIntent: "mcp_workflow" },
   "apply_ontology": { method: "POST", path: "/ontologies/apply", kind: "mutation", idempotent: true, surfaceIntent: "mcp_workflow" },
   "archive_belief": { method: "DELETE", path: "/beliefs", kind: "mutation", idempotent: true, surfaceIntent: "mcp_core" },
+  "archive_epistemic_node": { method: "POST", path: "/nodes/archive", kind: "mutation", idempotent: true, surfaceIntent: "mcp_core" },
   "archive_ontology": { method: "DELETE", path: "/ontologies", kind: "mutation", idempotent: true, surfaceIntent: "mcp_governance" },
   "archive_question": { method: "DELETE", path: "/questions", kind: "mutation", idempotent: true, surfaceIntent: "mcp_core" },
+  "batch_create_edges": { method: "POST", path: "/edges/batch", kind: "mutation", idempotent: true, surfaceIntent: "mcp_analysis" },
+  "batch_create_epistemic_nodes": { method: "POST", path: "/nodes/batch", kind: "mutation", idempotent: true, surfaceIntent: "mcp_core" },
   "begin_build_session": { method: "POST", path: "/mcp/build-session/begin", kind: "mutation", idempotent: true, surfaceIntent: "system" },
   "bisect_confidence": { method: "POST", path: "/beliefs/confidence/bisect", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
   "broadcast_message": { method: "POST", path: "/coordination/messages/broadcast", kind: "mutation", idempotent: true, surfaceIntent: "system" },
@@ -660,6 +696,7 @@ var CONTRACTS = {
   "create_belief": { method: "POST", path: "/beliefs", kind: "mutation", idempotent: true, surfaceIntent: "mcp_core" },
   "create_edge": { method: "POST", path: "/edges", kind: "mutation", idempotent: true, surfaceIntent: "mcp_analysis" },
   "create_epistemic_contract": { method: "POST", path: "/contracts", kind: "mutation", idempotent: true, surfaceIntent: "mcp_governance" },
+  "create_epistemic_node": { method: "POST", path: "/nodes", kind: "mutation", idempotent: true, surfaceIntent: "mcp_core" },
   "create_evidence": { method: "POST", path: "/evidence", kind: "mutation", idempotent: true, surfaceIntent: "mcp_core" },
   "create_lens": { method: "POST", path: "/lenses", kind: "mutation", idempotent: true, surfaceIntent: "mcp_governance" },
   "create_ontology": { method: "POST", path: "/ontologies", kind: "mutation", idempotent: true, surfaceIntent: "mcp_governance" },
@@ -687,6 +724,7 @@ var CONTRACTS = {
   "get_code_context": { method: "POST", path: "/coding/context", kind: "query", idempotent: false, surfaceIntent: "system" },
   "get_confidence_history": { method: "POST", path: "/beliefs/confidence-history", kind: "query", idempotent: false, surfaceIntent: "compatibility" },
   "get_contract_status": { method: "POST", path: "/contracts/status", kind: "query", idempotent: false, surfaceIntent: "mcp_governance" },
+  "get_epistemic_node": { method: "GET", path: "/nodes/get", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
   "get_evidence": { method: "GET", path: "/evidence/get", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
   "get_failure_log": { method: "POST", path: "/coding/failure-log", kind: "query", idempotent: false, surfaceIntent: "system" },
   "get_falsification_questions": { method: "POST", path: "/questions/falsification", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
@@ -700,6 +738,7 @@ var CONTRACTS = {
   "get_question": { method: "GET", path: "/questions/get", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
   "get_topic": { method: "GET", path: "/topics/get", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
   "get_topic_coverage": { method: "POST", path: "/graph/topic-coverage", kind: "query", idempotent: false, surfaceIntent: "mcp_analysis" },
+  "get_topic_graph_spine": { method: "GET", path: "/topics/graph-spine", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
   "get_topic_tree": { method: "GET", path: "/topics/tree", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
   "heartbeat_session": { method: "POST", path: "/coordination/heartbeat-session", kind: "mutation", idempotent: true, surfaceIntent: "system" },
   "identity_whoami": { method: "GET", path: "/identity/whoami", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
@@ -711,6 +750,7 @@ var CONTRACTS = {
   "list_all_worktrees": { method: "GET", path: "/worktrees/all", kind: "query", idempotent: false, surfaceIntent: "mcp_workflow" },
   "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_epistemic_nodes": { method: "GET", path: "/nodes", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
   "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" },
@@ -721,6 +761,7 @@ var CONTRACTS = {
   "list_worktrees": { method: "GET", path: "/worktrees", kind: "query", idempotent: false, surfaceIntent: "mcp_workflow" },
   "manage_write_policy": { method: "POST", path: "/policy/write-policy/manage", kind: "mutation", idempotent: true, surfaceIntent: "mcp_governance" },
   "match_entity_type": { method: "POST", path: "/ontologies/match-entity-type", kind: "query", idempotent: false, surfaceIntent: "mcp_workflow" },
+  "materialize_topic_graph": { method: "POST", path: "/topics/materialize-graph", kind: "mutation", idempotent: true, surfaceIntent: "mcp_core" },
   "merge": { method: "POST", path: "/worktrees/merge", kind: "mutation", idempotent: true, surfaceIntent: "mcp_workflow" },
   "modulate_confidence": { method: "POST", path: "/beliefs/confidence", kind: "mutation", idempotent: true, surfaceIntent: "mcp_core" },
   "open_pull_request": { method: "POST", path: "/worktrees/open-pull-request", kind: "mutation", idempotent: true, surfaceIntent: "system" },
@@ -734,22 +775,29 @@ var CONTRACTS = {
   "refine_belief": { method: "PATCH", path: "/beliefs/refine", kind: "mutation", idempotent: true, surfaceIntent: "mcp_core" },
   "refine_question": { method: "PATCH", path: "/questions/refine", kind: "mutation", idempotent: true, surfaceIntent: "mcp_core" },
   "register_session": { method: "POST", path: "/coordination/register-session", kind: "mutation", idempotent: true, surfaceIntent: "system" },
+  "remove_edge": { method: "DELETE", path: "/edges", kind: "mutation", idempotent: true, surfaceIntent: "mcp_analysis" },
+  "remove_edges_between": { method: "DELETE", path: "/edges/between", kind: "mutation", idempotent: true, surfaceIntent: "mcp_analysis" },
   "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" },
+  "resolve_interactive_principal": { method: "POST", path: "/control-plane/identity/resolve-interactive-principal", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
   "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" },
   "send_agent_message": { method: "POST", path: "/coordination/messages/send", kind: "mutation", idempotent: true, surfaceIntent: "system" },
+  "supersede_epistemic_node": { method: "POST", path: "/nodes/supersede", kind: "mutation", idempotent: true, surfaceIntent: "mcp_core" },
   "trace_entity_impact": { method: "POST", path: "/graph/trace-entity-impact", kind: "query", idempotent: false, surfaceIntent: "mcp_analysis" },
   "traverse_graph": { method: "POST", path: "/graph/traverse", kind: "query", idempotent: false, surfaceIntent: "mcp_analysis" },
   "trigger_belief_review": { method: "POST", path: "/context/belief-review", kind: "mutation", idempotent: true, surfaceIntent: "mcp_analysis" },
+  "update_edge": { method: "PATCH", path: "/edges", kind: "mutation", idempotent: true, surfaceIntent: "mcp_analysis" },
+  "update_epistemic_node": { method: "PATCH", path: "/nodes", kind: "mutation", idempotent: true, surfaceIntent: "mcp_core" },
   "update_ontology": { method: "PATCH", path: "/ontologies", kind: "mutation", idempotent: true, surfaceIntent: "mcp_governance" },
   "update_question_status": { method: "PATCH", path: "/questions/status", kind: "mutation", idempotent: true, surfaceIntent: "mcp_core" },
   "update_task": { method: "PATCH", path: "/tasks", kind: "mutation", idempotent: true, surfaceIntent: "mcp_workflow" },
   "update_topic": { method: "PATCH", path: "/topics", kind: "mutation", idempotent: true, surfaceIntent: "mcp_core" },
   "update_worktree_metadata": { method: "PATCH", path: "/worktrees/metadata", kind: "mutation", idempotent: true, surfaceIntent: "mcp_workflow" },
-  "update_worktree_targets": { method: "PATCH", path: "/worktrees/targets", kind: "mutation", idempotent: true, surfaceIntent: "mcp_workflow" }
+  "update_worktree_targets": { method: "PATCH", path: "/worktrees/targets", kind: "mutation", idempotent: true, surfaceIntent: "mcp_workflow" },
+  "verify_epistemic_node": { method: "POST", path: "/nodes/verify", kind: "mutation", idempotent: true, surfaceIntent: "mcp_core" }
 };
 function createSessionId() {
   return typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID() : randomIdempotencyKey();
@@ -817,12 +865,21 @@ function createFunctionSurfaceClient(config = {}) {
     archiveBelief(input = {}, idempotencyKey) {
       return execute("archive_belief", input, idempotencyKey);
     },
+    archiveEpistemicNode(input = {}, idempotencyKey) {
+      return execute("archive_epistemic_node", input, idempotencyKey);
+    },
     archiveOntology(input = {}, idempotencyKey) {
       return execute("archive_ontology", input, idempotencyKey);
     },
     archiveQuestion(input = {}, idempotencyKey) {
       return execute("archive_question", input, idempotencyKey);
     },
+    batchCreateEdges(input = {}, idempotencyKey) {
+      return execute("batch_create_edges", input, idempotencyKey);
+    },
+    batchCreateEpistemicNodes(input = {}, idempotencyKey) {
+      return execute("batch_create_epistemic_nodes", input, idempotencyKey);
+    },
     beginBuildSession(input = {}, idempotencyKey) {
       return execute("begin_build_session", input, idempotencyKey);
     },
@@ -856,6 +913,9 @@ function createFunctionSurfaceClient(config = {}) {
     createEpistemicContract(input = {}, idempotencyKey) {
       return execute("create_epistemic_contract", input, idempotencyKey);
     },
+    createEpistemicNode(input = {}, idempotencyKey) {
+      return execute("create_epistemic_node", input, idempotencyKey);
+    },
     createEvidence(input = {}, idempotencyKey) {
       return execute("create_evidence", input, idempotencyKey);
     },
@@ -937,6 +997,9 @@ function createFunctionSurfaceClient(config = {}) {
     getContractStatus(input = {}, idempotencyKey) {
       return execute("get_contract_status", input, idempotencyKey);
     },
+    getEpistemicNode(input = {}, idempotencyKey) {
+      return execute("get_epistemic_node", input, idempotencyKey);
+    },
     getEvidence(input = {}, idempotencyKey) {
       return execute("get_evidence", input, idempotencyKey);
     },
@@ -976,6 +1039,9 @@ function createFunctionSurfaceClient(config = {}) {
     getTopicCoverage(input = {}, idempotencyKey) {
       return execute("get_topic_coverage", input, idempotencyKey);
     },
+    getTopicGraphSpine(input = {}, idempotencyKey) {
+      return execute("get_topic_graph_spine", input, idempotencyKey);
+    },
     getTopicTree(input = {}, idempotencyKey) {
       return execute("get_topic_tree", input, idempotencyKey);
     },
@@ -1009,6 +1075,9 @@ function createFunctionSurfaceClient(config = {}) {
     listCampaigns(input = {}, idempotencyKey) {
       return execute("list_campaigns", input, idempotencyKey);
     },
+    listEpistemicNodes(input = {}, idempotencyKey) {
+      return execute("list_epistemic_nodes", input, idempotencyKey);
+    },
     listEvidence(input = {}, idempotencyKey) {
       return execute("list_evidence", input, idempotencyKey);
     },
@@ -1039,6 +1108,9 @@ function createFunctionSurfaceClient(config = {}) {
     matchEntityType(input = {}, idempotencyKey) {
       return execute("match_entity_type", input, idempotencyKey);
     },
+    materializeTopicGraph(input = {}, idempotencyKey) {
+      return execute("materialize_topic_graph", input, idempotencyKey);
+    },
     merge(input = {}, idempotencyKey) {
       return execute("merge", input, idempotencyKey);
     },
@@ -1078,12 +1150,21 @@ function createFunctionSurfaceClient(config = {}) {
     registerSession(input = {}, idempotencyKey) {
       return execute("register_session", input, idempotencyKey);
     },
+    removeEdge(input = {}, idempotencyKey) {
+      return execute("remove_edge", input, idempotencyKey);
+    },
+    removeEdgesBetween(input = {}, idempotencyKey) {
+      return execute("remove_edges_between", input, idempotencyKey);
+    },
     removeLensFromTopic(input = {}, idempotencyKey) {
       return execute("remove_lens_from_topic", input, idempotencyKey);
     },
     resolveEffectiveOntology(input = {}, idempotencyKey) {
       return execute("resolve_effective_ontology", input, idempotencyKey);
     },
+    resolveInteractivePrincipal(input = {}, idempotencyKey) {
+      return execute("resolve_interactive_principal", input, idempotencyKey);
+    },
     runGraphIntelligenceQuery(input = {}, idempotencyKey) {
       return execute("run_graph_intelligence_query", input, idempotencyKey);
     },
@@ -1099,6 +1180,9 @@ function createFunctionSurfaceClient(config = {}) {
     sendAgentMessage(input = {}, idempotencyKey) {
       return execute("send_agent_message", input, idempotencyKey);
     },
+    supersedeEpistemicNode(input = {}, idempotencyKey) {
+      return execute("supersede_epistemic_node", input, idempotencyKey);
+    },
     traceEntityImpact(input = {}, idempotencyKey) {
       return execute("trace_entity_impact", input, idempotencyKey);
     },
@@ -1108,6 +1192,12 @@ function createFunctionSurfaceClient(config = {}) {
     triggerBeliefReview(input = {}, idempotencyKey) {
       return execute("trigger_belief_review", input, idempotencyKey);
     },
+    updateEdge(input = {}, idempotencyKey) {
+      return execute("update_edge", input, idempotencyKey);
+    },
+    updateEpistemicNode(input = {}, idempotencyKey) {
+      return execute("update_epistemic_node", input, idempotencyKey);
+    },
     updateOntology(input = {}, idempotencyKey) {
       return execute("update_ontology", input, idempotencyKey);
     },
@@ -1125,6 +1215,9 @@ function createFunctionSurfaceClient(config = {}) {
     },
     updateWorktreeTargets(input = {}, idempotencyKey) {
       return execute("update_worktree_targets", input, idempotencyKey);
+    },
+    verifyEpistemicNode(input = {}, idempotencyKey) {
+      return execute("verify_epistemic_node", input, idempotencyKey);
     }
   };
 }