@lucern/sdk 0.3.0-alpha.7 → 0.3.0-alpha.8

package/README.md

@@ -326,7 +326,7 @@ await lucern.graph.createEdge({
 Before your agent starts its next session, it reads the graph:
 
 ```typescript
-const context = await lucern.context.compile(topicId, {
+const context = await lucern.context.compile({
   query: "code review strategy and static analysis coverage",
   ranking: "weighted_v1",
   tokenBudget: 2000,
@@ -492,7 +492,7 @@ traversal.data.nodes.forEach(node => {
 ### Inject Reasoning Context Into Any LLM Call
 
 ```typescript
-const context = await lucern.context.compile(topicId, {
+const context = await lucern.context.compile({
   query: "security review priorities",
   ranking: "weighted_v1",
   tokenBudget: 3000,
@@ -603,7 +603,7 @@ architectural decisions, check the reasoning graph:
 
 - Read current beliefs: `lucern.beliefs.list({ topicId: "..." })`
 - Check for contradictions: `lucern.contradictions.list({ topicId: "..." })`
-- Compile context before analysis: `lucern.context.compile(topicId, { query: "..." })`
+- Compile context before analysis: `lucern.context.compile({ query: "..." })`
 
 After making decisions, write them back:
 - Create beliefs for architectural decisions
@@ -634,7 +634,7 @@ contradictions, or knowledge state.
 Compile the current context to understand what the graph knows:
 
 \`\`\`typescript
-const context = await lucern.context.compile(topicId, {
+const context = await lucern.context.compile({
   query: "<what you're working on>",
   tokenBudget: 2000,
 });

package/dist/beliefs/index.js

@@ -3914,50 +3914,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",
@@ -3969,13 +3974,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
@@ -6627,7 +6639,7 @@ function createToolRegistryClient(config = {}) {
 }
 
 // src/version.ts
-var LUCERN_SDK_VERSION = "0.3.0-alpha.7";
+var LUCERN_SDK_VERSION = "0.3.0-alpha.8";
 
 // src/workflowClient.ts
 function normalizeLensQuery(value) {