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

package/dist/client.d.ts

@@ -38,6 +38,7 @@ import { LearningClientConfig } from './learningClient.js';
 import { ReportsClientConfig } from './reportsClient.js';
 import { SourcesClientConfig, UpsertSourceSpec } from './sourcesClient.js';
 import { WorkflowClientConfig, WorkflowLensPerspectiveType, WorkflowLensStatus, AddWorktreeInput, WorkflowWorktreeStatus, UpdateWorktreeTargetsInput, MergeInput, CreateTaskInput, CompleteTaskInput, UpdateTaskInput, WorkflowBranchStatus, CompleteWorktreeInput, AdvanceWorktreePhaseInput, SetWorktreePhaseInput, PatchWorktreeStateInput, BulkCreateWorktreesInput, ListTopicsInput, SwitchTopicContextInput } from './workflowClient.js';
+import { CustomToolInput as CustomToolInput$1 } from './clientHelpers.js';
 import './authContext.js';
 import './contracts/auth-session.contract.js';
 import './contracts/workflow-runtime.contract.js';
@@ -50,7 +51,7 @@ import 'zod';
 import '@lucern/contracts/tool-contracts';
 
 type ClientConfig = BeliefsClientConfig | SourcesClientConfig | GraphClientConfig | DecisionsClientConfig | AnswersClientConfig | ContextClientConfig | WorkflowClientConfig | AuditClientConfig | AdminClientConfig | EvidenceClientConfig | EmbeddingsClientConfig | EventingClientConfig | GraphAnalysisClientConfig | GraphRecommendationsClientConfig | GraphStateClassifierClientConfig | IdentityClientConfig | JobsClientConfig | ModelRuntimeClientConfig | OntologyLinksClientConfig | OrgGraphSearchClientConfig | PolicyClientConfig | PacksClientConfig | ReportsClientConfig | LearningClientConfig | TelemetryClientConfig | ToolRegistryClientConfig | FunctionSurfaceClientConfig | OntologyClientConfig | HarnessClientConfig | SchemaClientConfig | AudiencesClientConfig | TopicsClientConfig;
-type CustomToolInput = JsonObject;
+type CustomToolInput = CustomToolInput$1;
 type CustomToolInvoker = (input?: CustomToolInput) => Promise<unknown>;
 type CustomToolNamespace = Record<string, CustomToolInvoker>;
 type GatewayDataEnvelope<T extends Record<string, unknown>> = PlatformGatewaySuccess<T> & T;
@@ -1124,7 +1125,7 @@ declare function createLucernClient(config?: LucernClientConfig): {
     };
     context: {
         listTopics(query?: Parameters<(query?: TopicListInput) => Promise<PlatformGatewaySuccess<TopicListResponse>>>[0]): Promise<PlatformGatewaySuccess<TopicListResponse>>;
-        compile: (topicId: string, input?: CompileContextInput) => Promise<PlatformGatewaySuccess<PublicCompiledContext>>;
+        compile: (topicIdOrInput?: string | CompileContextInput, input?: CompileContextInput) => Promise<PlatformGatewaySuccess<PublicCompiledContext>>;
         recordScopeLearning: (input?: FunctionSurfaceInput, idempotencyKey?: string) => FunctionSurfaceResult<unknown>;
         discover(input: FunctionSurfaceInput): Promise<GatewayDataEnvelope<Record<string, unknown>>>;
         analyzeTopicDensity: (input?: FunctionSurfaceInput, idempotencyKey?: string) => FunctionSurfaceResult<unknown>;
@@ -2169,7 +2170,9 @@ declare function createLucernClient(config?: LucernClientConfig): {
                 name?: string;
                 status?: "active" | "archived";
                 defaultProjectVisibility?: "private" | "team" | "firm" | "external" | "public";
-                restore?: boolean;
+                restore
+                /** Target environment. Defaults to production if not specified. */
+                ? /** Target environment. Defaults to production if not specified. */: boolean;
                 metadata?: JsonObject;
             }, idempotencyKey?: string): Promise<PlatformGatewaySuccess<unknown>>;
             listMemberships(query?: GatewayScope & {

package/dist/client.js

@@ -3908,50 +3908,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",
@@ -3963,13 +3968,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
@@ -6244,6 +6256,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) {
@@ -6621,7 +6648,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) {
@@ -7142,11 +7169,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;
@@ -7606,10 +7633,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) {
@@ -7647,7 +7671,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) {
@@ -8687,7 +8711,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