@lucern/sdk 1.0.29 → 1.0.31

package/dist/version.d.ts

@@ -1,3 +1,3 @@
 /** Current SDK package version. */
-export declare const LUCERN_SDK_VERSION = "1.0.29";
+export declare const LUCERN_SDK_VERSION = "1.0.31";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,3 +1,3 @@
 /** Current SDK package version. */
-export const LUCERN_SDK_VERSION = "1.0.29";
+export const LUCERN_SDK_VERSION = "1.0.31";
 //# sourceMappingURL=version.js.map

package/dist/workflowClient.d.ts

@@ -1,9 +1,9 @@
-import { type GatewayClientConfig, LucernApiError } from "./coreClient";
-import type { LensPerspectiveType, LensPromptTemplateReference, LensStatus, LensTaskTemplate, LensWorkflowTemplate } from "./contracts/lensWorkflow";
+import type { LensPerspectiveType, LensPromptTemplateReference, LensQuestionTemplate, LensStatus, LensTaskTemplate, LensWorkflowTemplate } from "./contracts/lensWorkflow";
 import type { WorkflowAutoFixPolicy, WorkflowProofArtifact, WorkflowStaffingHint } from "./contracts/workflowRuntime";
+import { type GatewayClientConfig } from "./coreClient";
 import type { CompleteTaskResponse, CreateTaskResponse, JsonObject, ListTopicsResponse, ListWorktreesResponse, MergeWorktreeResponse, OpenPullRequestResponse, PushWorktreeResponse, SwitchTopicContextResponse, TopicIdentifierInput, UpdateTaskResponse, WorkflowBranchRecord, WorkflowLensRecord, WorkflowWorktreeRecord } from "./types";
-export { LucernApiError };
 export type { PlatformGatewaySuccess } from "./coreClient";
+export { LucernApiError } from "./coreClient";
 export type { AddWorktreeResponse, CompleteTaskResponse, CreateBranchResponse, CreateLensResponse, CreateTaskResponse, LensTopicBindingResponse, ListBranchesResponse, ListLensesResponse, ListTopicsResponse, ListWorktreesResponse, MergeWorktreeResponse, OpenPullRequestResponse, PushWorktreeResponse, SwitchTopicContextResponse, UpdateTaskResponse, } from "./types";
 /** Configuration for the workflow client. */
 export type WorkflowClientConfig = GatewayClientConfig;
@@ -83,52 +83,52 @@ export type WorkflowMergeInputOutcome = string | {
     rationale: string;
 };
 /** Input for merging worktree findings with optional belief confidence outcomes. */
-export type MergeInput = {
+export interface MergeInput {
     outcomes: WorkflowMergeInputOutcome[];
     summary?: string;
-};
+}
 /** Input for updating the beliefs and questions tracked by a worktree. */
-export type UpdateWorktreeTargetsInput = {
-    worktreeId: string;
+export interface UpdateWorktreeTargetsInput {
     addBeliefIds?: string[];
     addQuestionIds?: string[];
     removeBeliefIds?: string[];
     removeQuestionIds?: string[];
-};
-/** Input for marking a worktree complete with recorded outcomes. */
-export type CompleteWorktreeInput = {
     worktreeId: string;
-    keyFindings?: string[];
+}
+/** Input for marking a worktree complete with recorded outcomes. */
+export interface CompleteWorktreeInput {
     decisionsReached?: string[];
+    keyFindings?: string[];
     nextSteps?: string[];
-};
+    worktreeId: string;
+}
 /** Input for moving a worktree forward to its next phase. */
-export type AdvanceWorktreePhaseInput = {
+export interface AdvanceWorktreePhaseInput {
     worktreeId: string;
-};
+}
 /** Input for forcing a worktree into a specific phase. */
-export type SetWorktreePhaseInput = {
-    worktreeId: string;
+export interface SetWorktreePhaseInput {
     phase: string;
-};
-/** Input for patching arbitrary structured worktree state. */
-export type PatchWorktreeStateInput = {
     worktreeId: string;
+}
+/** Input for patching arbitrary structured worktree state. */
+export interface PatchWorktreeStateInput {
     patch: JsonObject;
-};
+    worktreeId: string;
+}
 /** Input for batch-creating worktrees through the workflow surface. */
-export type BulkCreateWorktreesInput = {
+export interface BulkCreateWorktreesInput {
     worktrees: unknown[];
-};
+}
 /** Input for listing accessible topic contexts. */
-export type ListTopicsInput = {
+export interface ListTopicsInput {
     includeShared?: boolean;
     limit?: number;
-};
+}
 /** Input for switching the active topic context by name. */
-export type SwitchTopicContextInput = {
+export interface SwitchTopicContextInput {
     targetTopicName: string;
-};
+}
 /** Input for creating a workflow task linked to a question or worktree. */
 export type CreateTaskInput = {
     title: string;
@@ -141,22 +141,22 @@ export type CreateTaskInput = {
     priority?: "low" | "medium" | "high" | "urgent";
 } & TopicIdentifierInput;
 /** Input for marking a workflow task as completed with an output summary. */
-export type CompleteTaskInput = {
-    outputSummary: string;
+export interface CompleteTaskInput {
     evidenceCreated?: boolean;
-};
+    outputSummary: string;
+}
 /** Input for partially updating an existing workflow task. */
-export type UpdateTaskInput = {
-    title?: string;
+export interface UpdateTaskInput {
+    assigneeId?: string;
+    blockedReason?: string;
     description?: string;
     linkedBeliefId?: string;
     linkedQuestionId?: string;
     linkedWorktreeId?: string;
-    priority?: "critical" | "high" | "medium" | "low";
+    priority?: "urgent" | "high" | "medium" | "low";
     status?: "todo" | "in_progress" | "blocked" | "done";
-    assigneeId?: string;
-    blockedReason?: string;
-};
+    title?: string;
+}
 /**
  * Create the workflow client for lenses, legacy branches, worktrees, context,
  * and tasks.
@@ -202,6 +202,7 @@ export declare function createWorkflowClient(config?: WorkflowClientConfig): {
         promptTemplates?: LensPromptTemplateReference[];
         workflowTemplates?: LensWorkflowTemplate[];
         taskTemplates?: LensTaskTemplate[];
+        questionTemplates?: LensQuestionTemplate[];
         filterCriteria?: JsonObject;
     } & TopicIdentifierInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<WorkflowLensRecord>>;
     /**

package/dist/workflowClient.js

@@ -1,6 +1,6 @@
-import { createGatewayRequestClient, LucernApiError, randomIdempotencyKey, toQueryString, } from "./coreClient.js";
+import { LucernApiError as CoreLucernApiError, createGatewayRequestClient, randomIdempotencyKey, toQueryString, } from "./coreClient.js";
 import { asListItems, createListResult, mapAliasedList, mapGatewayData, normalizeTopicQuery, resolveTopicId, withTopicAlias, } from "./sdkSurface.js";
-export { LucernApiError };
+export { LucernApiError } from "./coreClient.js";
 function normalizeLensQuery(value) {
     const topicId = resolveTopicId(value);
     return {
@@ -8,6 +8,12 @@ function normalizeLensQuery(value) {
         ...(topicId ? { topicId } : {}),
     };
 }
+function optionalBooleanQueryParam(value) {
+    if (typeof value !== "boolean") {
+        return;
+    }
+    return value ? "true" : "false";
+}
 /**
  * Create the workflow client for lenses, legacy branches, worktrees, context,
  * and tasks.
@@ -20,81 +26,94 @@ export function createWorkflowClient(config = {}) {
         /**
          * List workflow branches for a topic scope.
          */
-        async listBranches(query) {
-            return gateway.request({
+        listBranches(query) {
+            return gateway
+                .request({
                 path: `/api/platform/v1/workflow/branches${toQueryString(normalizeTopicQuery(query))}`,
-            }).then((response) => mapGatewayData(response, (data) => mapAliasedList(data, "branches")));
+            })
+                .then((response) => mapGatewayData(response, (data) => mapAliasedList(data, "branches")));
         },
         /**
          * Create a workflow branch.
          */
-        async createBranch(input, idempotencyKey) {
-            return gateway.request({
+        createBranch(input, idempotencyKey) {
+            return gateway
+                .request({
                 path: "/api/platform/v1/workflow/branches",
                 method: "POST",
                 body: normalizeTopicQuery(input),
                 idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            }).then((response) => mapGatewayData(response, (data) => withTopicAlias(data)));
+            })
+                .then((response) => mapGatewayData(response, (data) => withTopicAlias(data)));
         },
         /**
          * List reusable lenses for a workspace or topic scope.
          */
-        async listLenses(query) {
-            return gateway.request({
+        listLenses(query) {
+            return gateway
+                .request({
                 path: `/api/platform/v1/workflow/lenses${toQueryString(normalizeLensQuery(query))}`,
-            }).then((response) => mapGatewayData(response, (data) => mapAliasedList(data, "lenses")));
+            })
+                .then((response) => mapGatewayData(response, (data) => mapAliasedList(data, "lenses")));
         },
         /**
          * Create a reusable workflow lens.
          */
-        async createLens(input, idempotencyKey) {
+        createLens(input, idempotencyKey) {
             const payload = normalizeLensQuery(input);
-            return gateway.request({
+            return gateway
+                .request({
                 path: "/api/platform/v1/workflow/lenses",
                 method: "POST",
                 body: payload,
                 idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            }).then((response) => mapGatewayData(response, (data) => withTopicAlias(data)));
+            })
+                .then((response) => mapGatewayData(response, (data) => withTopicAlias(data)));
         },
         /**
          * Apply an existing lens to a topic.
          */
-        async applyLensToTopic(input, idempotencyKey) {
+        applyLensToTopic(input, idempotencyKey) {
             const payload = normalizeLensQuery(input);
-            return gateway.request({
+            return gateway
+                .request({
                 path: "/api/platform/v1/workflow/lens-bindings",
                 method: "POST",
                 body: payload,
                 idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            }).then((response) => mapGatewayData(response, (data) => withTopicAlias(data)));
+            })
+                .then((response) => mapGatewayData(response, (data) => withTopicAlias(data)));
         },
         /**
          * Remove an applied lens from a topic.
          */
-        async removeLensFromTopic(input, idempotencyKey) {
+        removeLensFromTopic(input, idempotencyKey) {
             const topicId = resolveTopicId(input);
             if (!topicId) {
-                throw new LucernApiError({
+                return Promise.reject(new CoreLucernApiError({
                     code: "INVALID_REQUEST",
                     message: "topicId is required",
                     status: 400,
-                });
+                }));
             }
-            return gateway.request({
+            return gateway
+                .request({
                 path: `/api/platform/v1/workflow/lens-bindings${toQueryString({
                     lensId: input.lensId,
                     topicId,
                 })}`,
                 method: "DELETE",
                 idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            }).then((response) => mapGatewayData(response, (data) => withTopicAlias(data)));
+            })
+                .then((response) => mapGatewayData(response, (data) => withTopicAlias(data)));
         },
         /**
          * List worktrees for a topic scope.
          */
-        async listWorktrees(query) {
+        listWorktrees(query) {
             const normalized = normalizeTopicQuery(query);
-            return gateway.request({
+            return gateway
+                .request({
                 path: `/api/platform/v1/worktrees${toQueryString({
                     ...normalized,
                     groupBy: query.groupBy,
@@ -102,13 +121,15 @@ export function createWorkflowClient(config = {}) {
                     campaign: query.campaign,
                     limit: query.limit,
                 })}`,
-            }).then((response) => mapGatewayData(response, (data) => mapAliasedList(data, "worktrees")));
+            })
+                .then((response) => mapGatewayData(response, (data) => mapAliasedList(data, "worktrees")));
         },
         /**
          * List all worktrees across accessible topics.
          */
-        async listAllWorktrees(query = {}) {
-            return gateway.request({
+        listAllWorktrees(query = {}) {
+            return gateway
+                .request({
                 path: `/api/platform/v1/worktrees/all${toQueryString({
                     status: query.status,
                     groupBy: query.groupBy,
@@ -116,7 +137,8 @@ export function createWorkflowClient(config = {}) {
                     campaign: query.campaign,
                     limit: query.limit,
                 })}`,
-            }).then((response) => mapGatewayData(response, (data) => {
+            })
+                .then((response) => mapGatewayData(response, (data) => {
                 const record = data && typeof data === "object" && !Array.isArray(data)
                     ? data
                     : {};
@@ -139,7 +161,7 @@ export function createWorkflowClient(config = {}) {
         /**
          * List compact pipeline campaigns with nested lanes.
          */
-        async listCampaigns(query = {}) {
+        listCampaigns(query = {}) {
             return gateway.request({
                 path: `/api/platform/v1/worktrees/campaigns${toQueryString(normalizeTopicQuery(query))}`,
             });
@@ -147,18 +169,20 @@ export function createWorkflowClient(config = {}) {
         /**
          * Create a workflow worktree.
          */
-        async createWorktree(input, idempotencyKey) {
-            return gateway.request({
+        createWorktree(input, idempotencyKey) {
+            return gateway
+                .request({
                 path: "/api/platform/v1/worktrees",
                 method: "POST",
                 body: normalizeTopicQuery(input),
                 idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            }).then((response) => mapGatewayData(response, (data) => withTopicAlias(data)));
+            })
+                .then((response) => mapGatewayData(response, (data) => withTopicAlias(data)));
         },
         /**
          * Merge a worktree into the main belief line.
          */
-        async merge(worktreeId, input, idempotencyKey) {
+        merge(worktreeId, input, idempotencyKey) {
             return gateway.request({
                 path: `/api/platform/v1/worktrees/${encodeURIComponent(worktreeId)}/merge`,
                 method: "POST",
@@ -169,29 +193,33 @@ export function createWorkflowClient(config = {}) {
         /**
          * Activate a planning worktree.
          */
-        async activateWorktree(worktreeId, idempotencyKey) {
-            return gateway.request({
+        activateWorktree(worktreeId, idempotencyKey) {
+            return gateway
+                .request({
                 path: `/api/platform/v1/worktrees/${encodeURIComponent(worktreeId)}/activate`,
                 method: "POST",
                 idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            }).then((response) => mapGatewayData(response, (data) => withTopicAlias(data)));
+            })
+                .then((response) => mapGatewayData(response, (data) => withTopicAlias(data)));
         },
         /**
          * Update targeted beliefs/questions for a worktree.
          */
-        async updateWorktreeTargets(input, idempotencyKey) {
+        updateWorktreeTargets(input, idempotencyKey) {
             const { worktreeId, ...body } = input;
-            return gateway.request({
+            return gateway
+                .request({
                 path: `/api/platform/v1/worktrees/${encodeURIComponent(worktreeId)}/targets`,
                 method: "POST",
                 body,
                 idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            }).then((response) => mapGatewayData(response, (data) => withTopicAlias(data)));
+            })
+                .then((response) => mapGatewayData(response, (data) => withTopicAlias(data)));
         },
         /**
          * Mark a worktree record complete.
          */
-        async completeWorktree(input, idempotencyKey) {
+        completeWorktree(input, idempotencyKey) {
             return gateway.request({
                 path: "/api/platform/v1/worktrees/complete",
                 method: "POST",
@@ -202,7 +230,7 @@ export function createWorkflowClient(config = {}) {
         /**
          * Advance a worktree to its next lifecycle phase.
          */
-        async advanceWorktreePhase(input, idempotencyKey) {
+        advanceWorktreePhase(input, idempotencyKey) {
             return gateway.request({
                 path: "/api/platform/v1/worktrees/advance-phase",
                 method: "POST",
@@ -213,7 +241,7 @@ export function createWorkflowClient(config = {}) {
         /**
          * Force a worktree into a specific lifecycle phase.
          */
-        async setWorktreePhase(input, idempotencyKey) {
+        setWorktreePhase(input, idempotencyKey) {
             return gateway.request({
                 path: "/api/platform/v1/worktrees/set-phase",
                 method: "POST",
@@ -224,7 +252,7 @@ export function createWorkflowClient(config = {}) {
         /**
          * Patch opaque worktree state for orchestration flows.
          */
-        async patchWorktreeState(input, idempotencyKey) {
+        patchWorktreeState(input, idempotencyKey) {
             return gateway.request({
                 path: "/api/platform/v1/worktrees/patch-state",
                 method: "POST",
@@ -235,7 +263,7 @@ export function createWorkflowClient(config = {}) {
         /**
          * Batch create worktree records.
          */
-        async bulkCreateWorktrees(input, idempotencyKey) {
+        bulkCreateWorktrees(input, idempotencyKey) {
             return gateway.request({
                 path: "/api/platform/v1/worktrees/bulk",
                 method: "POST",
@@ -246,7 +274,7 @@ export function createWorkflowClient(config = {}) {
         /**
          * Open a pull request for a worktree.
          */
-        async openPullRequest(worktreeId, input, idempotencyKey) {
+        openPullRequest(worktreeId, input, idempotencyKey) {
             return gateway.request({
                 path: `/api/platform/v1/workflow/worktrees/${encodeURIComponent(worktreeId)}/pull-request`,
                 method: "POST",
@@ -257,7 +285,7 @@ export function createWorkflowClient(config = {}) {
         /**
          * Push scored worktree findings into another context.
          */
-        async push(worktreeId, input, idempotencyKey) {
+        push(worktreeId, input, idempotencyKey) {
             return gateway.request({
                 path: `/api/platform/v1/workflow/worktrees/${encodeURIComponent(worktreeId)}/push`,
                 method: "POST",
@@ -268,17 +296,15 @@ export function createWorkflowClient(config = {}) {
         /**
          * List accessible topic contexts.
          */
-        async listTopics(query = {}) {
-            return gateway.request({
+        listTopics(query = {}) {
+            return gateway
+                .request({
                 path: `/api/platform/v1/workflow/topics${toQueryString({
-                    includeShared: typeof query.includeShared === "boolean"
-                        ? query.includeShared
-                            ? "true"
-                            : "false"
-                        : undefined,
+                    includeShared: optionalBooleanQueryParam(query.includeShared),
                     limit: query.limit,
                 })}`,
-            }).then((response) => mapGatewayData(response, (data) => {
+            })
+                .then((response) => mapGatewayData(response, (data) => {
                 const items = asListItems(data, "topics").map((item) => withTopicAlias(item));
                 const record = data && typeof data === "object"
                     ? data
@@ -293,20 +319,22 @@ export function createWorkflowClient(config = {}) {
         /**
          * Switch the active context by topic or project name.
          */
-        async switchTopicContext(input, idempotencyKey) {
-            return gateway.request({
+        switchTopicContext(input, idempotencyKey) {
+            return gateway
+                .request({
                 path: "/api/platform/v1/workflow/topics/switch",
                 method: "POST",
                 body: {
                     targetTopicName: input.targetTopicName,
                 },
                 idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            }).then((response) => mapGatewayData(response, (data) => withTopicAlias(data)));
+            })
+                .then((response) => mapGatewayData(response, (data) => withTopicAlias(data)));
         },
         /**
          * Create a workflow task.
          */
-        async createTask(input, idempotencyKey) {
+        createTask(input, idempotencyKey) {
             return gateway.request({
                 path: "/api/platform/v1/workflow/tasks",
                 method: "POST",
@@ -317,7 +345,7 @@ export function createWorkflowClient(config = {}) {
         /**
          * Complete a workflow task.
          */
-        async completeTask(taskId, input, idempotencyKey) {
+        completeTask(taskId, input, idempotencyKey) {
             return gateway.request({
                 path: `/api/platform/v1/workflow/tasks/${encodeURIComponent(taskId)}/complete`,
                 method: "POST",
@@ -328,7 +356,7 @@ export function createWorkflowClient(config = {}) {
         /**
          * Update a workflow task.
          */
-        async updateTask(taskId, input, idempotencyKey) {
+        updateTask(taskId, input, idempotencyKey) {
             return gateway.request({
                 path: `/api/platform/v1/workflow/tasks/${encodeURIComponent(taskId)}`,
                 method: "PATCH",