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

package/dist/facade/context.d.ts

@@ -12,7 +12,8 @@ type ContextFacadeConfig = {
     transport: ContextFacadeTransport;
 };
 declare function createContextFacade(config: ContextFacadeConfig): {
-    compile(topicId: string, input?: CompileContextInput): Promise<PublicCompiledContext>;
+    compile(topicIdOrInput?: string | CompileContextInput, input?: CompileContextInput): Promise<PublicCompiledContext>;
+    compileByQuery(input?: CompileContextInput): Promise<PublicCompiledContext>;
 };
 
 export { CompileContextInput, type ContextClientRequest, type ContextFacadeConfig, type ContextFacadeTransport, PublicCompiledContext, createContextFacade };

package/dist/facade/context.js

@@ -8,50 +8,55 @@ function cleanNumber(value) {
 function cleanBoolean(value) {
   return typeof value === "boolean" ? value : void 0;
 }
-function buildCompileContextRequest(topicId, input = {}) {
-  const payload = { topicId };
-  const query = cleanString(input.query);
+function buildCompileContextRequest(topicIdOrInput = {}, input = {}) {
+  const effectiveInput = typeof topicIdOrInput === "string" ? input : topicIdOrInput;
+  const payload = {};
+  const topicId = typeof topicIdOrInput === "string" ? cleanString(topicIdOrInput) : cleanString(effectiveInput.topicId);
+  if (topicId) {
+    payload.topicId = topicId;
+  }
+  const query = cleanString(effectiveInput.query);
   if (query) {
     payload.query = query;
   }
-  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 = cleanString(input.ranking) ?? cleanString(input.rankingProfile);
+  const ranking = cleanString(effectiveInput.ranking) ?? cleanString(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 = cleanString(input.mode);
+  const mode = cleanString(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 = cleanString(input.worktreeId);
+  const worktreeId = cleanString(effectiveInput.worktreeId);
   if (worktreeId) {
     payload.worktreeId = worktreeId;
   }
-  const sessionId = cleanString(input.sessionId);
+  const sessionId = cleanString(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",
@@ -61,8 +66,12 @@ function buildCompileContextRequest(topicId, input = {}) {
 }
 function createContextFacade(config) {
   return {
-    compile(topicId, input = {}) {
-      const request = buildCompileContextRequest(topicId, input);
+    compile(topicIdOrInput = {}, input = {}) {
+      const request = buildCompileContextRequest(topicIdOrInput, input);
+      return config.transport.request(request);
+    },
+    compileByQuery(input = {}) {
+      const request = buildCompileContextRequest(input);
       return config.transport.request(request);
     }
   };

package/dist/facade/context.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/facade/context.ts"],"names":[],"mappings":"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","file":"context.js","sourcesContent":["import type { CompileContextInput, PublicCompiledContext } from \"../contextTypes\";\n\nexport type ContextClientRequest = {\n  path: \"/api/platform/v1/context/compile\";\n  method: \"POST\";\n  body: Record<string, unknown>;\n};\n\nexport type ContextFacadeTransport = {\n  request<T>(request: ContextClientRequest): Promise<T>;\n};\n\nexport type ContextFacadeConfig = {\n  transport: ContextFacadeTransport;\n};\n\nfunction cleanString(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.trim().length > 0\n    ? value.trim()\n    : undefined;\n}\n\nfunction cleanNumber(value: unknown): number | undefined {\n  return typeof value === \"number\" && Number.isFinite(value) ? value : undefined;\n}\n\nfunction cleanBoolean(value: unknown): boolean | undefined {\n  return typeof value === \"boolean\" ? value : undefined;\n}\n\nfunction buildCompileContextRequest(\n  topicId: string,\n  input: CompileContextInput = {}\n): ContextClientRequest {\n  const payload: Record<string, unknown> = { topicId };\n\n  const query = cleanString(input.query);\n  if (query) {\n    payload.query = query;\n  }\n\n  const budget = cleanNumber(input.budget) ?? cleanNumber(input.tokenBudget);\n  if (budget !== undefined) {\n    payload.budget = budget;\n  }\n\n  const ranking = cleanString(input.ranking) ?? cleanString(input.rankingProfile);\n  if (ranking) {\n    payload.ranking = ranking;\n  }\n\n  const limit = cleanNumber(input.limit);\n  if (limit !== undefined) {\n    payload.limit = limit;\n  }\n\n  const maxDepth = cleanNumber(input.maxDepth);\n  if (maxDepth !== undefined) {\n    payload.maxDepth = maxDepth;\n  }\n\n  const includeEntities = cleanBoolean(input.includeEntities);\n  if (includeEntities !== undefined) {\n    payload.includeEntities = includeEntities;\n  }\n\n  const mode = cleanString(input.mode);\n  if (mode) {\n    payload.mode = mode;\n  }\n\n  const includeFailures = cleanBoolean(input.includeFailures);\n  if (includeFailures !== undefined) {\n    payload.includeFailures = includeFailures;\n  }\n\n  const worktreeId = cleanString(input.worktreeId);\n  if (worktreeId) {\n    payload.worktreeId = worktreeId;\n  }\n\n  const sessionId = cleanString(input.sessionId);\n  if (sessionId) {\n    payload.sessionId = sessionId;\n  }\n\n  if (\n    Array.isArray(input.packWeightOverrides) &&\n    input.packWeightOverrides.length > 0\n  ) {\n    payload.packWeightOverrides = input.packWeightOverrides;\n  }\n\n  return {\n    path: \"/api/platform/v1/context/compile\",\n    method: \"POST\",\n    body: payload,\n  };\n}\n\nexport function createContextFacade(config: ContextFacadeConfig) {\n  return {\n    compile(topicId: string, input: CompileContextInput = {}) {\n      const request = buildCompileContextRequest(topicId, input);\n      return config.transport.request<PublicCompiledContext>(request);\n    },\n  };\n}\n\nexport type { CompileContextInput, PublicCompiledContext };\n"]}
+{"version":3,"sources":["../../src/facade/context.ts"],"names":[],"mappings":"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","file":"context.js","sourcesContent":["import type { CompileContextInput, PublicCompiledContext } from \"../contextTypes\";\n\nexport type ContextClientRequest = {\n  path: \"/api/platform/v1/context/compile\";\n  method: \"POST\";\n  body: Record<string, unknown>;\n};\n\nexport type ContextFacadeTransport = {\n  request<T>(request: ContextClientRequest): Promise<T>;\n};\n\nexport type ContextFacadeConfig = {\n  transport: ContextFacadeTransport;\n};\n\nfunction cleanString(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.trim().length > 0\n    ? value.trim()\n    : undefined;\n}\n\nfunction cleanNumber(value: unknown): number | undefined {\n  return typeof value === \"number\" && Number.isFinite(value) ? value : undefined;\n}\n\nfunction cleanBoolean(value: unknown): boolean | undefined {\n  return typeof value === \"boolean\" ? value : undefined;\n}\n\nfunction buildCompileContextRequest(\n  topicIdOrInput: string | CompileContextInput = {},\n  input: CompileContextInput = {}\n): ContextClientRequest {\n  const effectiveInput =\n    typeof topicIdOrInput === \"string\" ? input : topicIdOrInput;\n  const payload: Record<string, unknown> = {};\n\n  const topicId =\n    typeof topicIdOrInput === \"string\"\n      ? cleanString(topicIdOrInput)\n      : cleanString(effectiveInput.topicId);\n  if (topicId) {\n    payload.topicId = topicId;\n  }\n\n  const query = cleanString(effectiveInput.query);\n  if (query) {\n    payload.query = query;\n  }\n\n  const budget =\n    cleanNumber(effectiveInput.budget) ?? cleanNumber(effectiveInput.tokenBudget);\n  if (budget !== undefined) {\n    payload.budget = budget;\n  }\n\n  const ranking =\n    cleanString(effectiveInput.ranking) ?? cleanString(effectiveInput.rankingProfile);\n  if (ranking) {\n    payload.ranking = ranking;\n  }\n\n  const limit = cleanNumber(effectiveInput.limit);\n  if (limit !== undefined) {\n    payload.limit = limit;\n  }\n\n  const maxDepth = cleanNumber(effectiveInput.maxDepth);\n  if (maxDepth !== undefined) {\n    payload.maxDepth = maxDepth;\n  }\n\n  const includeEntities = cleanBoolean(effectiveInput.includeEntities);\n  if (includeEntities !== undefined) {\n    payload.includeEntities = includeEntities;\n  }\n\n  const mode = cleanString(effectiveInput.mode);\n  if (mode) {\n    payload.mode = mode;\n  }\n\n  const includeFailures = cleanBoolean(effectiveInput.includeFailures);\n  if (includeFailures !== undefined) {\n    payload.includeFailures = includeFailures;\n  }\n\n  const worktreeId = cleanString(effectiveInput.worktreeId);\n  if (worktreeId) {\n    payload.worktreeId = worktreeId;\n  }\n\n  const sessionId = cleanString(effectiveInput.sessionId);\n  if (sessionId) {\n    payload.sessionId = sessionId;\n  }\n\n  if (\n    Array.isArray(effectiveInput.packWeightOverrides) &&\n    effectiveInput.packWeightOverrides.length > 0\n  ) {\n    payload.packWeightOverrides = effectiveInput.packWeightOverrides;\n  }\n\n  return {\n    path: \"/api/platform/v1/context/compile\",\n    method: \"POST\",\n    body: payload,\n  };\n}\n\nexport function createContextFacade(config: ContextFacadeConfig) {\n  return {\n    compile(\n      topicIdOrInput: string | CompileContextInput = {},\n      input: CompileContextInput = {}\n    ) {\n      const request = buildCompileContextRequest(topicIdOrInput, input);\n      return config.transport.request<PublicCompiledContext>(request);\n    },\n    compileByQuery(input: CompileContextInput = {}) {\n      const request = buildCompileContextRequest(input);\n      return config.transport.request<PublicCompiledContext>(request);\n    },\n  };\n}\n\nexport type { CompileContextInput, PublicCompiledContext };\n"]}

package/dist/index.d.ts

@@ -59,6 +59,7 @@ export { AddWorktreeInput, AdvanceWorktreePhaseInput, BulkCreateWorktreesInput,
 export * from '@lucern/contracts/tool-contracts';
 import './mcpClient.js';
 import '@lucern/contracts/mcp-gateway-boundary.contract';
+import './clientHelpers.js';
 import './contextPackPolicy.js';
 import 'zod';
 import './boundaryClientSurface.js';

package/dist/index.js

@@ -4166,50 +4166,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",
@@ -4221,13 +4226,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
@@ -6616,6 +6628,21 @@ function createSchemaClient(config = {}) {
 }
 
 // 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) {
@@ -6993,7 +7020,7 @@ function createToolRegistryClient(config = {}) {
 }
 
 // src/version.ts
-var LUCERN_SDK_VERSION = "0.3.0-alpha.7";
+var LUCERN_SDK_VERSION = "0.3.0-alpha.9";
 
 // src/workflowClient.ts
 function normalizeLensQuery(value) {
@@ -7514,11 +7541,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;
@@ -7978,10 +8005,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) {
@@ -8019,7 +8043,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) {
@@ -9059,7 +9083,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
@@ -9158,50 +9182,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",
@@ -9211,8 +9240,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);
     }
   };