@lucern/sdk 0.2.0-alpha.6 → 0.2.0-alpha.8

package/dist/{lib/platform/sdk/workflowClient.d.ts → workflowClient.d.ts}

@@ -1,24 +1,25 @@
-import { type GatewayClientConfig, LucernApiError } from "./coreClient";
-import type { LensPerspectiveType, LensPromptTemplateReference, LensStatus, LensTaskTemplate, LensWorkflowTemplate } from "./contracts/lensWorkflow";
-import type { WorkflowAutoFixPolicy, WorkflowProofArtifact, WorkflowStaffingHint } from "./contracts/workflowRuntime";
-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 type { AddWorktreeResponse, CompleteTaskResponse, CreateBranchResponse, CreateLensResponse, CreateTaskResponse, LensTopicBindingResponse, ListBranchesResponse, ListLensesResponse, ListTopicsResponse, ListWorktreesResponse, MergeWorktreeResponse, OpenPullRequestResponse, PushWorktreeResponse, SwitchTopicContextResponse, UpdateTaskResponse, } from "./types";
+import { GatewayClientConfig, PlatformGatewaySuccess } from './coreClient.js';
+export { LucernApiError } from './coreClient.js';
+import { TopicIdentifierInput, JsonObject, ListResult, WorkflowBranchRecord, WorkflowLensRecord, WorkflowLensBindingRecord, WorkflowWorktreeRecord, ListWorktreesResponse, MergeWorktreeResponse, OpenPullRequestResponse, PushWorktreeResponse, ListTopicsResponse, SwitchTopicContextResponse, CreateTaskResponse, CompleteTaskResponse, UpdateTaskResponse } from './types.js';
+export { AddWorktreeResponse, CreateBranchResponse, CreateLensResponse, LensTopicBindingResponse, ListBranchesResponse, ListLensesResponse } from './types.js';
+import { LensPerspectiveType, LensStatus, LensPromptTemplateReference, LensWorkflowTemplate, LensTaskTemplate } from './contracts/lens-workflow.contract.js';
+import { WorkflowProofArtifact, WorkflowStaffingHint, WorkflowAutoFixPolicy } from './contracts/workflow-runtime.contract.js';
+import './contracts/lens-filter.contract.js';
+
 /** Configuration for the workflow client. */
-export type WorkflowClientConfig = GatewayClientConfig;
+type WorkflowClientConfig = GatewayClientConfig;
 /** Lifecycle status of a workflow branch. */
-export type WorkflowBranchStatus = "dormant" | "active" | "archived";
+type WorkflowBranchStatus = "dormant" | "active" | "archived";
 /** Lifecycle status of a workflow lens. */
-export type WorkflowLensStatus = LensStatus;
+type WorkflowLensStatus = LensStatus;
 /** Analytical perspective type for a lens overlay. */
-export type WorkflowLensPerspectiveType = LensPerspectiveType;
+type WorkflowLensPerspectiveType = LensPerspectiveType;
 /** Lifecycle status of a workflow worktree. */
-export type WorkflowWorktreeStatus = "planning" | "active" | "paused" | "completed" | "merged" | "failed" | "archived";
+type WorkflowWorktreeStatus = "planning" | "active" | "paused" | "completed" | "merged" | "failed" | "archived";
 /** Possible outcomes when merging worktree findings into the main belief line. */
-export type WorkflowMergeOutcome = "validated" | "invalidated" | "forked" | "inconclusive";
+type WorkflowMergeOutcome = "validated" | "invalidated" | "forked" | "inconclusive";
 /** Input for creating a new workflow worktree. */
-export type AddWorktreeInput = {
+type AddWorktreeInput = {
     title: string;
     topicId?: string;
     branchId?: string;
@@ -37,7 +38,7 @@ export type AddWorktreeInput = {
     autoFixPolicy?: WorkflowAutoFixPolicy;
 } & TopicIdentifierInput;
 /** Input for merging worktree findings with belief confidence outcomes. */
-export type MergeInput = {
+type MergeInput = {
     outcomes: Array<{
         beliefId: string;
         confidence: number;
@@ -46,7 +47,7 @@ export type MergeInput = {
     summary?: string;
 };
 /** Input for updating the beliefs and questions tracked by a worktree. */
-export type UpdateWorktreeTargetsInput = {
+type UpdateWorktreeTargetsInput = {
     worktreeId: string;
     addBeliefIds?: string[];
     addQuestionIds?: string[];
@@ -54,41 +55,41 @@ export type UpdateWorktreeTargetsInput = {
     removeQuestionIds?: string[];
 };
 /** Input for marking a worktree complete with recorded outcomes. */
-export type CompleteWorktreeInput = {
+type CompleteWorktreeInput = {
     worktreeId: string;
     keyFindings?: string[];
     decisionsReached?: string[];
     nextSteps?: string[];
 };
 /** Input for moving a worktree forward to its next phase. */
-export type AdvanceWorktreePhaseInput = {
+type AdvanceWorktreePhaseInput = {
     worktreeId: string;
 };
 /** Input for forcing a worktree into a specific phase. */
-export type SetWorktreePhaseInput = {
+type SetWorktreePhaseInput = {
     worktreeId: string;
     phase: string;
 };
 /** Input for patching arbitrary structured worktree state. */
-export type PatchWorktreeStateInput = {
+type PatchWorktreeStateInput = {
     worktreeId: string;
     patch: JsonObject;
 };
 /** Input for batch-creating worktrees through the workflow surface. */
-export type BulkCreateWorktreesInput = {
+type BulkCreateWorktreesInput = {
     worktrees: unknown[];
 };
 /** Input for listing accessible topic contexts. */
-export type ListTopicsInput = {
+type ListTopicsInput = {
     includeShared?: boolean;
     limit?: number;
 };
 /** Input for switching the active topic context by name. */
-export type SwitchTopicContextInput = {
+type SwitchTopicContextInput = {
     targetTopicName: string;
 };
 /** Input for creating a workflow task linked to a question or worktree. */
-export type CreateTaskInput = {
+type CreateTaskInput = {
     title: string;
     topicId?: string;
     taskType?: "research" | "interview" | "analysis" | "data_collection";
@@ -99,12 +100,12 @@ export type CreateTaskInput = {
     priority?: "low" | "medium" | "high" | "urgent";
 } & TopicIdentifierInput;
 /** Input for marking a workflow task as completed with an output summary. */
-export type CompleteTaskInput = {
+type CompleteTaskInput = {
     outputSummary: string;
     evidenceCreated?: boolean;
 };
 /** Input for partially updating an existing workflow task. */
-export type UpdateTaskInput = {
+type UpdateTaskInput = {
     title?: string;
     description?: string;
     linkedBeliefId?: string;
@@ -119,7 +120,7 @@ export type UpdateTaskInput = {
  * @param config - Gateway transport configuration.
  * @returns An object with methods to manage branches, lenses, worktrees, topics, and tasks.
  */
-export declare function createWorkflowClient(config?: WorkflowClientConfig): {
+declare function createWorkflowClient(config?: WorkflowClientConfig): {
     /**
      * List workflow branches for a topic scope.
      */
@@ -127,7 +128,7 @@ export declare function createWorkflowClient(config?: WorkflowClientConfig): {
         topicId?: string;
         status?: WorkflowBranchStatus;
         limit?: number;
-    } & TopicIdentifierInput): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").ListResult<WorkflowBranchRecord, "branches">>>;
+    } & TopicIdentifierInput): Promise<PlatformGatewaySuccess<ListResult<WorkflowBranchRecord, "branches">>>;
     /**
      * Create a workflow branch.
      */
@@ -136,7 +137,7 @@ export declare function createWorkflowClient(config?: WorkflowClientConfig): {
         topicId?: string;
         description?: string;
         metadata?: JsonObject;
-    } & TopicIdentifierInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<WorkflowBranchRecord>>;
+    } & TopicIdentifierInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<WorkflowBranchRecord>>;
     /**
      * List reusable lenses for a workspace or topic scope.
      */
@@ -145,7 +146,7 @@ export declare function createWorkflowClient(config?: WorkflowClientConfig): {
         topicId?: string;
         status?: WorkflowLensStatus;
         perspectiveType?: WorkflowLensPerspectiveType;
-    } & TopicIdentifierInput): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").ListResult<WorkflowLensRecord, "lenses">>>;
+    } & TopicIdentifierInput): Promise<PlatformGatewaySuccess<ListResult<WorkflowLensRecord, "lenses">>>;
     /**
      * Create a reusable workflow lens.
      */
@@ -159,7 +160,7 @@ export declare function createWorkflowClient(config?: WorkflowClientConfig): {
         workflowTemplates?: LensWorkflowTemplate[];
         taskTemplates?: LensTaskTemplate[];
         filterCriteria?: JsonObject;
-    } & TopicIdentifierInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<WorkflowLensRecord>>;
+    } & TopicIdentifierInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<WorkflowLensRecord>>;
     /**
      * Apply an existing lens to a topic.
      */
@@ -167,14 +168,14 @@ export declare function createWorkflowClient(config?: WorkflowClientConfig): {
         lensId: string;
         topicId?: string;
         metadata?: JsonObject;
-    } & TopicIdentifierInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").WorkflowLensBindingRecord>>;
+    } & TopicIdentifierInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<WorkflowLensBindingRecord>>;
     /**
      * Remove an applied lens from a topic.
      */
     removeLensFromTopic(input: {
         lensId: string;
         topicId?: string;
-    } & TopicIdentifierInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").WorkflowLensBindingRecord>>;
+    } & TopicIdentifierInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<WorkflowLensBindingRecord>>;
     /**
      * List worktrees for a topic scope.
      */
@@ -185,7 +186,7 @@ export declare function createWorkflowClient(config?: WorkflowClientConfig): {
         track?: string;
         executionBand?: number;
         limit?: number;
-    } & TopicIdentifierInput): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").ListResult<WorkflowWorktreeRecord, "worktrees">>>;
+    } & TopicIdentifierInput): Promise<PlatformGatewaySuccess<ListResult<WorkflowWorktreeRecord, "worktrees">>>;
     /**
      * List all worktrees across accessible topics.
      */
@@ -194,47 +195,47 @@ export declare function createWorkflowClient(config?: WorkflowClientConfig): {
         track?: string;
         executionBand?: number;
         limit?: number;
-    }): Promise<import("./coreClient").PlatformGatewaySuccess<ListWorktreesResponse>>;
+    }): Promise<PlatformGatewaySuccess<ListWorktreesResponse>>;
     /**
      * Create a workflow worktree.
      */
-    createWorktree(input: AddWorktreeInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<WorkflowWorktreeRecord>>;
+    createWorktree(input: AddWorktreeInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<WorkflowWorktreeRecord>>;
     /**
      * @deprecated Use createWorktree.
      */
-    addWorktree(input: AddWorktreeInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<WorkflowWorktreeRecord>>;
+    addWorktree(input: AddWorktreeInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<WorkflowWorktreeRecord>>;
     /**
      * Merge a worktree into the main belief line.
      */
-    merge(worktreeId: string, input: MergeInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<MergeWorktreeResponse>>;
+    merge(worktreeId: string, input: MergeInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<MergeWorktreeResponse>>;
     /**
      * Activate a planning worktree.
      */
-    activateWorktree(worktreeId: string, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<WorkflowWorktreeRecord>>;
+    activateWorktree(worktreeId: string, idempotencyKey?: string): Promise<PlatformGatewaySuccess<WorkflowWorktreeRecord>>;
     /**
      * Update targeted beliefs/questions for a worktree.
      */
-    updateWorktreeTargets(input: UpdateWorktreeTargetsInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<WorkflowWorktreeRecord>>;
+    updateWorktreeTargets(input: UpdateWorktreeTargetsInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<WorkflowWorktreeRecord>>;
     /**
      * Mark a worktree record complete.
      */
-    completeWorktree(input: CompleteWorktreeInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<Record<string, unknown>>>;
+    completeWorktree(input: CompleteWorktreeInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<Record<string, unknown>>>;
     /**
      * Advance a worktree to its next lifecycle phase.
      */
-    advanceWorktreePhase(input: AdvanceWorktreePhaseInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<Record<string, unknown>>>;
+    advanceWorktreePhase(input: AdvanceWorktreePhaseInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<Record<string, unknown>>>;
     /**
      * Force a worktree into a specific lifecycle phase.
      */
-    setWorktreePhase(input: SetWorktreePhaseInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<Record<string, unknown>>>;
+    setWorktreePhase(input: SetWorktreePhaseInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<Record<string, unknown>>>;
     /**
      * Patch opaque worktree state for orchestration flows.
      */
-    patchWorktreeState(input: PatchWorktreeStateInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<Record<string, unknown>>>;
+    patchWorktreeState(input: PatchWorktreeStateInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<Record<string, unknown>>>;
     /**
      * Batch create worktree records.
      */
-    bulkCreateWorktrees(input: BulkCreateWorktreesInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<Record<string, unknown>>>;
+    bulkCreateWorktrees(input: BulkCreateWorktreesInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<Record<string, unknown>>>;
     /**
      * Open a pull request for a worktree.
      */
@@ -242,7 +243,7 @@ export declare function createWorkflowClient(config?: WorkflowClientConfig): {
         summary: string;
         reviewers?: string[];
         status?: "pending_review" | "changes_requested" | "approved" | "blocked";
-    }, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<OpenPullRequestResponse>>;
+    }, idempotencyKey?: string): Promise<PlatformGatewaySuccess<OpenPullRequestResponse>>;
     /**
      * Push scored worktree findings into another context.
      */
@@ -250,27 +251,27 @@ export declare function createWorkflowClient(config?: WorkflowClientConfig): {
         targetContext: string;
         beliefIds?: string[];
         metadata?: JsonObject;
-    }, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<PushWorktreeResponse>>;
+    }, idempotencyKey?: string): Promise<PlatformGatewaySuccess<PushWorktreeResponse>>;
     /**
      * List accessible topic contexts.
      */
-    listTopics(query?: ListTopicsInput): Promise<import("./coreClient").PlatformGatewaySuccess<ListTopicsResponse>>;
+    listTopics(query?: ListTopicsInput): Promise<PlatformGatewaySuccess<ListTopicsResponse>>;
     /**
      * Switch the active context by topic or project name.
      */
-    switchTopicContext(input: SwitchTopicContextInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<SwitchTopicContextResponse>>;
+    switchTopicContext(input: SwitchTopicContextInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<SwitchTopicContextResponse>>;
     /**
      * Create a workflow task.
      */
-    createTask(input: CreateTaskInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<CreateTaskResponse>>;
+    createTask(input: CreateTaskInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<CreateTaskResponse>>;
     /**
      * Complete a workflow task.
      */
-    completeTask(taskId: string, input: CompleteTaskInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<CompleteTaskResponse>>;
+    completeTask(taskId: string, input: CompleteTaskInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<CompleteTaskResponse>>;
     /**
      * Update a workflow task.
      */
-    updateTask(taskId: string, input: UpdateTaskInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<UpdateTaskResponse>>;
+    updateTask(taskId: string, input: UpdateTaskInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<UpdateTaskResponse>>;
     /**
      * @deprecated Use createBranch.
      */
@@ -279,7 +280,7 @@ export declare function createWorkflowClient(config?: WorkflowClientConfig): {
         topicId?: string;
         description?: string;
         metadata?: JsonObject;
-    } & TopicIdentifierInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<WorkflowBranchRecord>>;
+    } & TopicIdentifierInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<WorkflowBranchRecord>>;
     /**
      * @deprecated Use addWorktree.
      */
@@ -289,11 +290,11 @@ export declare function createWorkflowClient(config?: WorkflowClientConfig): {
         branchId?: string;
         hypothesis?: string;
         beliefIds?: string[];
-    } & TopicIdentifierInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<WorkflowWorktreeRecord>>;
+    } & TopicIdentifierInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<WorkflowWorktreeRecord>>;
     /**
      * @deprecated Use merge.
      */
-    completeSprint(worktreeId: string, input: MergeInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<MergeWorktreeResponse>>;
+    completeSprint(worktreeId: string, input: MergeInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<MergeWorktreeResponse>>;
     /**
      * @deprecated Use openPullRequest.
      */
@@ -301,7 +302,7 @@ export declare function createWorkflowClient(config?: WorkflowClientConfig): {
         summary: string;
         reviewers?: string[];
         status?: "pending_review" | "changes_requested" | "approved" | "blocked";
-    }, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<OpenPullRequestResponse>>;
+    }, idempotencyKey?: string): Promise<PlatformGatewaySuccess<OpenPullRequestResponse>>;
     /**
      * @deprecated Use push.
      */
@@ -309,5 +310,7 @@ export declare function createWorkflowClient(config?: WorkflowClientConfig): {
         targetContext: string;
         beliefIds?: string[];
         metadata?: JsonObject;
-    }, idempotencyKey?: string): Promise<import("./coreClient").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 WorkflowMergeOutcome, type WorkflowWorktreeStatus, createWorkflowClient };