@lucern/sdk 0.3.0-alpha.17 → 0.3.0-alpha.3

package/dist/workflowClient.d.ts

@@ -24,49 +24,12 @@ type WorkflowMergeOutcome = "validated" | "invalidated" | "forked" | "inconclusi
 type AddWorktreeInput = {
     title: string;
     topicId?: string;
-    topicHint?: string;
     branchId?: string;
     objective?: string;
     hypothesis?: string;
-    rationale?: string;
-    worktreeType?: string;
-    startDate?: number;
-    endDate?: number;
-    durationWeeks?: number;
-    confidenceImpact?: "high" | "medium" | "low";
-    beliefFocus?: string;
     beliefIds?: string[];
-    targetBeliefIds?: string[];
-    targetQuestionIds?: string[];
-    keyQuestions?: Array<{
-        question: string;
-        status?: "open" | "answered" | "forked";
-        answer?: string;
-        answerConfidence?: "high" | "medium" | "low";
-        linkedQuestionId?: string;
-    }>;
-    evidenceSignals?: Array<{
-        signal: string;
-        collected?: boolean;
-        progress?: string;
-        notes?: string;
-    }>;
-    decisionGate?: {
-        goCriteria: string[];
-        noGoSignals: string[];
-        verdict?: "go" | "no_go" | "pivot" | "pending";
-        verdictRationale?: string;
-        decidedAt?: number;
-        decidedBy?: string;
-    };
-    goCriteria?: string[];
-    noGoSignals?: string[];
     autoShape?: boolean;
     domainPackId?: string;
-    tags?: string[];
-    touchedPaths?: string[];
-    sourceRef?: string;
-    sourceKind?: string;
     campaign?: number;
     lane?: string;
     laneOrderInCampaign?: number;
@@ -78,16 +41,14 @@ type AddWorktreeInput = {
     staffingHint?: WorkflowStaffingHint | string;
     lastReconciledAt?: number;
     autoFixPolicy?: WorkflowAutoFixPolicy;
-    lensId?: string;
 } & TopicIdentifierInput;
-type WorkflowMergeInputOutcome = string | {
-    beliefId: string;
-    confidence: number;
-    rationale: string;
-};
-/** Input for merging worktree findings with optional belief confidence outcomes. */
+/** Input for merging worktree findings with belief confidence outcomes. */
 type MergeInput = {
-    outcomes: WorkflowMergeInputOutcome[];
+    outcomes: Array<{
+        beliefId: string;
+        confidence: number;
+        rationale: string;
+    }>;
     summary?: string;
 };
 /** Input for updating the beliefs and questions tracked by a worktree. */
@@ -157,8 +118,6 @@ type UpdateTaskInput = {
     linkedWorktreeId?: string;
     priority?: "critical" | "high" | "medium" | "low";
     status?: "todo" | "in_progress" | "blocked" | "done";
-    assigneeId?: string;
-    blockedReason?: string;
 };
 /**
  * Create the workflow client for lenses, legacy branches, worktrees, context,
@@ -256,6 +215,10 @@ declare function createWorkflowClient(config?: WorkflowClientConfig): {
      * Create a workflow worktree.
      */
     createWorktree(input: AddWorktreeInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<WorkflowWorktreeRecord>>;
+    /**
+     * @deprecated Use createWorktree.
+     */
+    addWorktree(input: AddWorktreeInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<WorkflowWorktreeRecord>>;
     /**
      * Merge a worktree into the main belief line.
      */
@@ -324,26 +287,45 @@ declare function createWorkflowClient(config?: WorkflowClientConfig): {
      * Update a workflow task.
      */
     updateTask(taskId: string, input: UpdateTaskInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<UpdateTaskResponse>>;
-} & {
-    addWorktree: (input: AddWorktreeInput, idempotencyKey?: string) => Promise<PlatformGatewaySuccess<WorkflowWorktreeRecord>>;
-    createPillar: (input: {
+    /**
+     * @deprecated Use createBranch.
+     */
+    createPillar(input: {
         name: string;
         topicId?: string;
         description?: string;
         metadata?: JsonObject;
-    } & TopicIdentifierInput, idempotencyKey?: string) => Promise<PlatformGatewaySuccess<WorkflowBranchRecord>>;
-    createSprint: (input: AddWorktreeInput, idempotencyKey?: string) => Promise<PlatformGatewaySuccess<WorkflowWorktreeRecord>>;
-    completeSprint: (worktreeId: string, input: MergeInput, idempotencyKey?: string) => Promise<PlatformGatewaySuccess<MergeWorktreeResponse>>;
-    requestReview: (worktreeId: string, input: {
+    } & TopicIdentifierInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<WorkflowBranchRecord>>;
+    /**
+     * @deprecated Use addWorktree.
+     */
+    createSprint(input: {
+        title: string;
+        topicId?: string;
+        branchId?: string;
+        hypothesis?: string;
+        beliefIds?: string[];
+    } & TopicIdentifierInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<WorkflowWorktreeRecord>>;
+    /**
+     * @deprecated Use merge.
+     */
+    completeSprint(worktreeId: string, input: MergeInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<MergeWorktreeResponse>>;
+    /**
+     * @deprecated Use openPullRequest.
+     */
+    requestReview(worktreeId: string, input: {
         summary: string;
         reviewers?: string[];
         status?: "pending_review" | "changes_requested" | "approved" | "blocked";
-    }, idempotencyKey?: string) => Promise<PlatformGatewaySuccess<OpenPullRequestResponse>>;
-    publishFindings: (worktreeId: string, input: {
+    }, idempotencyKey?: string): Promise<PlatformGatewaySuccess<OpenPullRequestResponse>>;
+    /**
+     * @deprecated Use push.
+     */
+    publishFindings(worktreeId: string, input: {
         targetContext: string;
         beliefIds?: string[];
         metadata?: JsonObject;
-    }, idempotencyKey?: string) => Promise<PlatformGatewaySuccess<PushWorktreeResponse>>;
+    }, idempotencyKey?: string): Promise<PlatformGatewaySuccess<PushWorktreeResponse>>;
 };
 
-export { type AddWorktreeInput, type AdvanceWorktreePhaseInput, type BulkCreateWorktreesInput, type CompleteTaskInput, CompleteTaskResponse, type CompleteWorktreeInput, type CreateTaskInput, CreateTaskResponse, type ListTopicsInput, ListTopicsResponse, ListWorktreesResponse, type MergeInput, MergeWorktreeResponse, OpenPullRequestResponse, type PatchWorktreeStateInput, PlatformGatewaySuccess, PushWorktreeResponse, type SetWorktreePhaseInput, type SwitchTopicContextInput, SwitchTopicContextResponse, type UpdateTaskInput, UpdateTaskResponse, type UpdateWorktreeTargetsInput, type WorkflowBranchStatus, type WorkflowClientConfig, type WorkflowLensPerspectiveType, type WorkflowLensStatus, type WorkflowMergeInputOutcome, type WorkflowMergeOutcome, type WorkflowWorktreeStatus, createWorkflowClient };
+export { type AddWorktreeInput, type AdvanceWorktreePhaseInput, type BulkCreateWorktreesInput, type CompleteTaskInput, CompleteTaskResponse, type CompleteWorktreeInput, type CreateTaskInput, CreateTaskResponse, type ListTopicsInput, ListTopicsResponse, ListWorktreesResponse, type MergeInput, MergeWorktreeResponse, OpenPullRequestResponse, type PatchWorktreeStateInput, PlatformGatewaySuccess, PushWorktreeResponse, type SetWorktreePhaseInput, type SwitchTopicContextInput, SwitchTopicContextResponse, type UpdateTaskInput, UpdateTaskResponse, type UpdateWorktreeTargetsInput, type WorkflowBranchStatus, type WorkflowClientConfig, type WorkflowLensPerspectiveType, type WorkflowLensStatus, type WorkflowMergeOutcome, type WorkflowWorktreeStatus, createWorkflowClient };

package/dist/workflowClient.js

@@ -82,15 +82,14 @@ function normalizeCanonicalLucernAuthContext(input) {
   );
   const roles = cleanStringList(input.roles);
   const scopes = cleanStringList(input.scopes);
-  const principalType = requirePrincipalType(input.principalType);
-  const authMode = requireAuthMode(input.authMode);
-  const roleBasedInteractiveAuth = authMode === "interactive_user" && roles.length > 0;
-  if (roles.length === 0 || scopes.length === 0 && !roleBasedInteractiveAuth) {
+  if (roles.length === 0 || scopes.length === 0) {
     throw new LucernSdkAuthContextError(
       "membership_missing",
       "Canonical Lucern SDK auth context requires non-empty roles and scopes."
     );
   }
+  const principalType = requirePrincipalType(input.principalType);
+  const authMode = requireAuthMode(input.authMode);
   const subject = cleanString(input.permit?.subject) ?? principalId;
   const tenant = cleanString(input.permit?.tenant) ?? tenantId;
   const workspace = cleanString(input.permit?.workspace) ?? workspaceId;
@@ -232,7 +231,9 @@ function generatePortableRequestId() {
     8
   ).join("")}-${hex.slice(8, 10).join("")}-${hex.slice(10).join("")}`;
 }
-var randomIdempotencyKey = generatePortableRequestId;
+function randomIdempotencyKey() {
+  return generatePortableRequestId();
+}
 function isRetryableStatus(status) {
   return status >= 500 || status === 408 || status === 429;
 }
@@ -297,11 +298,8 @@ function timeoutError(timeoutMs) {
   error.name = "AbortError";
   return error;
 }
-function isRecord(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value);
-}
 function readPolicySummaryFromDetails(details) {
-  if (!isRecord(details)) {
+  if (!details || typeof details !== "object" || Array.isArray(details)) {
     return null;
   }
   const directSummary = details.summary;
@@ -309,11 +307,11 @@ function readPolicySummaryFromDetails(details) {
     return directSummary.trim();
   }
   const policy = details.policy;
-  if (!isRecord(policy)) {
+  if (!policy || typeof policy !== "object" || Array.isArray(policy)) {
     return null;
   }
   const explanation = policy.explanation;
-  if (!isRecord(explanation)) {
+  if (!explanation || typeof explanation !== "object" || Array.isArray(explanation)) {
     return null;
   }
   const nestedSummary = explanation.summary;
@@ -342,31 +340,13 @@ 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 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 base = config.getAuthHeaders ? await config.getAuthHeaders() : {};
     const authContextInput = await resolveConfiguredAuthContext(
       config.authContext
     );
@@ -395,11 +375,11 @@ function createGatewayRequestClient(config = {}) {
     if (!text) {
       return null;
     }
-    const parsed = tryParseGatewayEnvelopeJson(text);
-    if (!parsed.ok) {
+    try {
+      return JSON.parse(text);
+    } catch {
       return null;
     }
-    return isRecord(parsed.value) ? parsed.value : null;
   }
   function resolveTimeoutMs(method, requestTimeoutMs) {
     if (typeof requestTimeoutMs === "number") {
@@ -411,31 +391,16 @@ function createGatewayRequestClient(config = {}) {
     }
     return config.timeoutMs ?? 15e3;
   }
-  function tryParseGatewayEnvelopeJson(text) {
-    const trimmed = text.trim();
-    if (!trimmed.startsWith("{") && !trimmed.startsWith("[")) {
-      return { ok: false, reason: "non-json" };
-    }
-    try {
-      return { ok: true, value: JSON.parse(trimmed) };
-    } catch (error) {
-      if (error instanceof SyntaxError) {
-        return { ok: false, reason: "invalid-json", error };
-      }
-      throw error;
-    }
-  }
   function buildApiError(args) {
     const failure = args.failure;
-    const legacyError = failure && isRecord(failure.error) ? failure.error : failure?.legacyError;
+    const legacyError = failure && typeof failure.error === "object" && failure.error !== null ? failure.error : failure?.legacyError;
     const correlationId = failure?.correlationId ?? args.response.headers.get("x-lucern-correlation-id")?.trim() ?? args.requestId;
     const policyTraceId = failure?.policyTraceId ?? args.response.headers.get("x-lucern-policy-trace-id")?.trim() ?? null;
     const details = failure?.details ?? legacyError?.details;
     const policySummary = readPolicySummaryFromDetails(details);
-    const failureMessage = typeof failure?.error === "string" ? failure.error : legacyError?.message;
     return new LucernApiError({
       code: failure?.code ?? legacyError?.code ?? fallbackErrorCode(args.response.status),
-      message: policySummary ?? failureMessage ?? (args.response.ok ? "Platform API returned an invalid success payload." : "Platform API request failed."),
+      message: policySummary ?? (typeof failure?.error === "string" ? failure.error : legacyError?.message ?? (args.response.ok ? "Platform API returned an invalid success payload." : "Platform API request failed.")),
       status: args.response.status,
       invariant: failure?.invariant,
       suggestion: failure?.suggestion,
@@ -561,11 +526,8 @@ function createGatewayRequestClient(config = {}) {
 }
 
 // src/sdkSurface.ts
-function isRecord2(value) {
-  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
-}
 function asRecord(value) {
-  return isRecord2(value) ? value : {};
+  return value && typeof value === "object" ? value : {};
 }
 function cleanString2(value) {
   return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
@@ -619,10 +581,7 @@ function createListResult(items, legacyKey) {
     total: items.length
   };
   if (legacyKey) {
-    return {
-      ...result,
-      [legacyKey]: items
-    };
+    result[legacyKey] = items;
   }
   return result;
 }
@@ -831,6 +790,12 @@ function createWorkflowClient(config = {}) {
         )
       );
     },
+    /**
+     * @deprecated Use createWorktree.
+     */
+    async addWorktree(input, idempotencyKey) {
+      return client.createWorktree(input, idempotencyKey);
+    },
     /**
      * Merge a worktree into the main belief line.
      */
@@ -1028,16 +993,39 @@ function createWorkflowClient(config = {}) {
         body: input,
         idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
       });
+    },
+    /**
+     * @deprecated Use createBranch.
+     */
+    async createPillar(input, idempotencyKey) {
+      return client.createBranch(input, idempotencyKey);
+    },
+    /**
+     * @deprecated Use addWorktree.
+     */
+    async createSprint(input, idempotencyKey) {
+      return client.createWorktree(input, idempotencyKey);
+    },
+    /**
+     * @deprecated Use merge.
+     */
+    async completeSprint(worktreeId, input, idempotencyKey) {
+      return client.merge(worktreeId, input, idempotencyKey);
+    },
+    /**
+     * @deprecated Use openPullRequest.
+     */
+    async requestReview(worktreeId, input, idempotencyKey) {
+      return client.openPullRequest(worktreeId, input, idempotencyKey);
+    },
+    /**
+     * @deprecated Use push.
+     */
+    async publishFindings(worktreeId, input, idempotencyKey) {
+      return client.push(worktreeId, input, idempotencyKey);
     }
   };
-  return Object.assign(client, {
-    addWorktree: client.createWorktree,
-    createPillar: client.createBranch,
-    createSprint: client.createWorktree,
-    completeSprint: client.merge,
-    requestReview: client.openPullRequest,
-    publishFindings: client.push
-  });
+  return client;
 }
 
 export { LucernApiError, createWorkflowClient };