@sift-wiki/conductor 0.2.0-beta.1 → 0.2.0

package/dist/runtime/runtimeService.js

@@ -1,7 +1,9 @@
+import { createHash } from "node:crypto";
 import { runDaemon, runDaemonOnce } from "../daemon.js";
 import { redactSecrets } from "../redaction.js";
 export class HeadlessRuntimeService {
     input;
+    runtimeLock;
     state = "stopped";
     startedAt;
     stoppedAt;
@@ -9,8 +11,10 @@ export class HeadlessRuntimeService {
     lastErrorMessage;
     controller;
     runPromise;
-    constructor(input) {
+    lockHandle;
+    constructor(input, runtimeLock) {
         this.input = input;
+        this.runtimeLock = runtimeLock;
     }
     status() {
         return {
@@ -30,6 +34,7 @@ export class HeadlessRuntimeService {
         this.stoppedAt = undefined;
         this.lastErrorMessage = undefined;
         try {
+            await this.acquireOwnership();
             this.state = "running";
             const result = await runDaemonOnce(this.input);
             this.lastResult = result;
@@ -43,6 +48,9 @@ export class HeadlessRuntimeService {
             this.lastErrorMessage = safeRuntimeErrorMessage(error);
             throw error;
         }
+        finally {
+            await this.releaseOwnership();
+        }
     }
     async start() {
         await Promise.resolve();
@@ -58,6 +66,15 @@ export class HeadlessRuntimeService {
         this.startedAt = new Date().toISOString();
         this.stoppedAt = undefined;
         this.lastErrorMessage = undefined;
+        try {
+            await this.acquireOwnership();
+        }
+        catch (error) {
+            this.state = "failed";
+            this.stoppedAt = new Date().toISOString();
+            this.lastErrorMessage = safeRuntimeErrorMessage(error);
+            throw error;
+        }
         this.runPromise = this.runUntilStopped(controller);
         this.state = "running";
         return this.status();
@@ -80,27 +97,44 @@ export class HeadlessRuntimeService {
         await this.runPromise;
         return this.status();
     }
-    runUntilStopped(controller) {
-        return runDaemon({ ...this.input, signal: controller.signal })
-            .then(() => {
-            if (this.controller !== controller) {
-                return;
+    async runUntilStopped(controller) {
+        try {
+            await runDaemon({ ...this.input, signal: controller.signal });
+            if (this.controller === controller) {
+                this.state = "stopped";
+                this.stoppedAt = new Date().toISOString();
             }
-            this.state = "stopped";
-            this.stoppedAt = new Date().toISOString();
-            this.controller = undefined;
-            this.runPromise = undefined;
-        })
-            .catch((error) => {
-            if (this.controller !== controller) {
-                return;
+        }
+        catch (error) {
+            if (this.controller === controller) {
+                this.state = "failed";
+                this.stoppedAt = new Date().toISOString();
+                this.lastErrorMessage = safeRuntimeErrorMessage(error);
             }
-            this.state = "failed";
-            this.stoppedAt = new Date().toISOString();
-            this.lastErrorMessage = safeRuntimeErrorMessage(error);
-            this.controller = undefined;
-            this.runPromise = undefined;
-        });
+        }
+        finally {
+            if (this.controller === controller) {
+                this.controller = undefined;
+                this.runPromise = undefined;
+            }
+            await this.releaseOwnership();
+        }
+    }
+    async acquireOwnership() {
+        if (this.runtimeLock === undefined)
+            return;
+        const config = await this.input.store.read();
+        if (config === undefined)
+            throw new Error("No paired Conductor config found. Run pair first.");
+        const identityKey = config.conductorId ?? createHash("sha256")
+            .update(`${config.apiBaseUrl}\0${config.displayName}`)
+            .digest("hex");
+        this.lockHandle = await this.runtimeLock.acquire(identityKey);
+    }
+    async releaseOwnership() {
+        const handle = this.lockHandle;
+        this.lockHandle = undefined;
+        await handle?.release();
     }
 }
 function safeRuntimeErrorMessage(error) {

package/dist/runtime/runtimeService.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtimeService.js","sourceRoot":"","sources":["../../src/runtime/runtimeService.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtimeService.js","sourceRoot":"","sources":["../../src/runtime/runtimeService.ts"],"names":[],"mappings":"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"}

package/dist/runtime/taskExecution.d.ts

@@ -1,9 +1,12 @@
 import type { ConductorClient, ConductorWorkClient, ClaimedJob } from "../types.js";
+import type { AttemptAuthority } from "../protocol/fenced.js";
 export type TaskExecutionClient = Pick<ConductorWorkClient, "readWorkContext" | "checkoutTask" | "createChildTasks" | "addTaskComment" | "registerArtifact" | "requestApproval" | "reportUsage" | "setTaskDisposition">;
 export type OpenTaskExecution = {
     taskId: string;
     bridgeBaseUrl: string;
     bridgeToken: string;
+    hasAddedComment(): boolean;
+    hasRequestedApproval(): boolean;
     close(): Promise<void>;
 };
 export declare function openTaskExecution(input: {
@@ -11,6 +14,7 @@ export declare function openTaskExecution(input: {
     workClient: TaskExecutionClient;
     credential: string;
     job: ClaimedJob;
+    authority?: AttemptAuthority | undefined;
     onHardStop?: (() => void) | undefined;
 }): Promise<OpenTaskExecution>;
 export declare function taskIdFromJob(job: ClaimedJob): string;

package/dist/runtime/taskExecution.js

@@ -3,8 +3,9 @@ import { startLocalBridgeServer } from "../bridge/server.js";
 import { LocalBridgeSessionRegistry } from "../bridge/sessionRegistry.js";
 export async function openTaskExecution(input) {
     const taskId = taskIdFromJob(input.job);
-    await input.workClient.checkoutTask(input.credential, input.job.runId, taskId);
+    await input.workClient.checkoutTask(input.credential, input.job.runId, taskId, mutationOptions(input.authority));
     const sessions = new LocalBridgeSessionRegistry();
+    const bridgeEvidence = { commentAdded: false, approvalRequested: false };
     const session = sessions.create({
         runId: input.job.runId,
         taskId,
@@ -13,7 +14,7 @@ export async function openTaskExecution(input) {
     });
     const handler = createLocalBridgeHandler({
         sessions,
-        client: bridgeClient(input.coreClient, input.workClient),
+        client: bridgeClient(input.coreClient, input.workClient, input.authority, bridgeEvidence),
         machineCredential: input.credential,
         onHardStop: input.onHardStop,
     });
@@ -22,6 +23,8 @@ export async function openTaskExecution(input) {
         taskId,
         bridgeBaseUrl: server.baseUrl,
         bridgeToken: session.runToken,
+        hasAddedComment: () => bridgeEvidence.commentAdded,
+        hasRequestedApproval: () => bridgeEvidence.approvalRequested,
         async close() {
             sessions.revoke(input.job.runId);
             await server.close();
@@ -41,19 +44,36 @@ export function taskIdFromJob(job) {
     }
     return taskId;
 }
-function bridgeClient(core, work) {
+function bridgeClient(core, work, authority, evidence = {
+    commentAdded: false,
+    approvalRequested: false,
+}) {
     return {
-        readWorkContext: (...args) => work.readWorkContext(...args),
-        checkoutTask: (...args) => work.checkoutTask(...args),
-        createChildTasks: (...args) => work.createChildTasks(...args),
-        addTaskComment: (...args) => work.addTaskComment(...args),
-        registerArtifact: (...args) => work.registerArtifact(...args),
-        requestApproval: (...args) => work.requestApproval(...args),
-        reportUsage: (...args) => work.reportUsage(...args),
-        setTaskDisposition: (...args) => work.setTaskDisposition(...args),
-        appendRunEvent: (...args) => core.appendRunEvent(...args),
+        readWorkContext: (credential, runId, taskId) => work.readWorkContext(credential, runId, taskId, mutationOptions(authority)),
+        checkoutTask: (credential, runId, taskId) => work.checkoutTask(credential, runId, taskId, mutationOptions(authority)),
+        createChildTasks: (credential, runId, taskId, children) => work.createChildTasks(credential, runId, taskId, children, mutationOptions(authority)),
+        addTaskComment: (credential, runId, taskId, bodyMarkdown) => work.addTaskComment(credential, runId, taskId, bodyMarkdown, mutationOptions(authority))
+            .then((comment) => {
+            evidence.commentAdded = true;
+            return comment;
+        }),
+        registerArtifact: (credential, runId, taskId, artifact) => work.registerArtifact(credential, runId, taskId, artifact, mutationOptions(authority)),
+        requestApproval: (credential, runId, taskId, request) => work.requestApproval(credential, runId, taskId, request, mutationOptions(authority))
+            .then((approval) => {
+            evidence.approvalRequested = true;
+            return approval;
+        }),
+        reportUsage: (credential, runId, taskId, usage) => work.reportUsage(credential, runId, taskId, usage, mutationOptions(authority)),
+        setTaskDisposition: (credential, runId, taskId, disposition, resultSummary) => work.setTaskDisposition(credential, runId, taskId, disposition, resultSummary, mutationOptions(authority)),
+        appendRunEvent: (credential, runId, event) => core.appendRunEvent(credential, runId, {
+            ...event,
+            ...(authority === undefined ? {} : { authority }),
+        }),
     };
 }
+function mutationOptions(authority) {
+    return authority === undefined ? undefined : { authority };
+}
 function bridgeSessionTtlMs(job) {
     const maxRunMinutes = job.wakeEnvelope?.limits.maxRunMinutes;
     return (maxRunMinutes ?? 60) * 60_000 + 60_000;

package/dist/runtime/taskExecution.js.map

@@ -1 +1 @@
-{"version":3,"file":"taskExecution.js","sourceRoot":"","sources":["../../src/runtime/taskExecution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AA0B1E,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAMvC;IACC,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC/E,MAAM,QAAQ,GAAG,IAAI,0BAA0B,EAAE,CAAC;IAClD,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC;QAC9B,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK;QACtB,MAAM;QACN,MAAM,EAAE,aAAa,EAAE;QACvB,KAAK,EAAE,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC;KACrC,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,wBAAwB,CAAC;QACvC,QAAQ;QACR,MAAM,EAAE,YAAY,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC;QACxD,iBAAiB,EAAE,KAAK,CAAC,UAAU;QACnC,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IACjE,OAAO;QACL,MAAM;QACN,aAAa,EAAE,MAAM,CAAC,OAAO;QAC7B,WAAW,EAAE,OAAO,CAAC,QAAQ;QAC7B,KAAK,CAAC,KAAK;YACT,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACjC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAe;IAC3C,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,CAAC,YAAY,CAAC;IAC7D,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAC9E,IAAI,GAAG,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACnC,IAAI,GAAG,CAAC,YAAY,CAAC,KAAK,KAAK,GAAG,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAClG,IAAI,GAAG,CAAC,YAAY,KAAK,SAAS,IAAI,GAAG,CAAC,YAAY,KAAK,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACpF,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,YAAY,CACnB,IAA6C,EAC7C,IAAyB;IAEzB,OAAO;QACL,eAAe,EAAE,CAAC,GAAG,IAAwD,EAAE,EAAE,CAC/E,IAAI,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC;QAC/B,YAAY,EAAE,CAAC,GAAG,IAAqD,EAAE,EAAE,CACzE,IAAI,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;QAC5B,gBAAgB,EAAE,CAAC,GAAG,IAAyD,EAAE,EAAE,CACjF,IAAI,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;QAChC,cAAc,EAAE,CAAC,GAAG,IAAuD,EAAE,EAAE,CAC7E,IAAI,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;QAC9B,gBAAgB,EAAE,CAAC,GAAG,IAAyD,EAAE,EAAE,CACjF,IAAI,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;QAChC,eAAe,EAAE,CAAC,GAAG,IAAwD,EAAE,EAAE,CAC/E,IAAI,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC;QAC/B,WAAW,EAAE,CAAC,GAAG,IAAoD,EAAE,EAAE,CACvE,IAAI,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;QAC3B,kBAAkB,EAAE,CAAC,GAAG,IAA2D,EAAE,EAAE,CACrF,IAAI,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC;QAClC,cAAc,EAAE,CAAC,GAAG,IAAmD,EAAE,EAAE,CACzE,IAAI,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;KAC/B,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAe;IACzC,MAAM,aAAa,GAAG,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,aAAa,CAAC;IAC7D,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC;AACjD,CAAC;AAED,SAAS,aAAa;IACpB,OAAO;QACL,UAAU;QACV,iBAAiB;QACjB,eAAe;QACf,kBAAkB;QAClB,oBAAoB;QACpB,gBAAgB;QAChB,gBAAgB;QAChB,aAAa;QACb,wBAAwB;KACzB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"taskExecution.js","sourceRoot":"","sources":["../../src/runtime/taskExecution.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -1,4 +1,5 @@
 import type { SiftWakeEnvelope } from "./runtime/wakeEnvelope.js";
+import type { AttemptAuthority, AttemptAuthorityFence, AttemptMutationOptions, ClientEventIdentity, EventAcknowledgement, LateResultRequest, LateResultResponse, ReconcileAttemptRequest, ReconcileAttemptResponse } from "./protocol/fenced.js";
 import type { WorkApproval, WorkArtifact, WorkArtifactInput, WorkChildTaskInput, WorkDisposition, WorkDispositionResponse, WorkTask, WorkTaskComment, WorkUsageDecision } from "./workTypes.js";
 export type JsonObject = Record<string, unknown>;
 export type ConductorConfig = {
@@ -59,8 +60,11 @@ export type ClaimedJob = {
     limits: JsonObject;
     status: string;
     attempts: number;
+    maxAttempts?: number | undefined;
     leaseExpiresAt?: string | undefined;
     wakeEnvelope?: SiftWakeEnvelope | undefined;
+    authorityMode?: "legacy-v1" | "fenced-attempts-v1" | undefined;
+    authority?: AttemptAuthority | undefined;
 };
 export type LeaseRefresh = {
     job: {
@@ -70,6 +74,7 @@ export type LeaseRefresh = {
         leaseExpiresAt?: string | undefined;
     };
     cancelRequested: boolean;
+    authority?: AttemptAuthority | undefined;
 };
 export type RunEventType = "health" | "progress" | "log" | "artifact" | "approval_requested" | "completed" | "failed" | "cancelled";
 export type RunEventInput = {
@@ -77,6 +82,9 @@ export type RunEventInput = {
     payload?: JsonObject;
     occurredAt?: string;
 };
+export type RunEventDeliveryInput = RunEventInput & Partial<ClientEventIdentity> & {
+    authority?: AttemptAuthorityFence | undefined;
+};
 export type RunEvent = {
     id: string;
     runId: string;
@@ -84,7 +92,12 @@ export type RunEvent = {
     eventType: RunEventType;
     payload: JsonObject;
     occurredAt: string;
+    attemptId?: string | undefined;
+    clientEventId?: string | undefined;
+    clientSequence?: number | undefined;
+    acknowledgedClientSequence?: number | undefined;
 };
+export type RunEventAppendResult = RunEvent | EventAcknowledgement;
 export type ConductorClient = PairConductorClient & {
     heartbeat(credential: string, request: {
         version?: string;
@@ -93,29 +106,31 @@ export type ConductorClient = PairConductorClient & {
     }): Promise<unknown>;
     advertiseAgents(credential: string, agents: ConductorAgentAdvertisement[]): Promise<ConductorAgent[]>;
     claimJob(credential: string): Promise<ClaimedJob | undefined>;
-    refreshLease(credential: string, jobId: string): Promise<LeaseRefresh>;
-    appendRunEvent(credential: string, runId: string, event: RunEventInput): Promise<RunEvent>;
-    completeRun(credential: string, runId: string, resultSummary: JsonObject): Promise<unknown>;
-    failRun(credential: string, runId: string, errorSummary: JsonObject): Promise<unknown>;
-    acknowledgeCancellation(credential: string, runId: string, resultSummary: JsonObject): Promise<unknown>;
+    refreshLease(credential: string, jobId: string, authority?: AttemptAuthorityFence): Promise<LeaseRefresh>;
+    appendRunEvent(credential: string, runId: string, event: RunEventDeliveryInput): Promise<RunEventAppendResult>;
+    completeRun(credential: string, runId: string, resultSummary: JsonObject, options?: AttemptMutationOptions): Promise<unknown>;
+    failRun(credential: string, runId: string, errorSummary: JsonObject, options?: AttemptMutationOptions): Promise<unknown>;
+    acknowledgeCancellation(credential: string, runId: string, resultSummary: JsonObject, options?: AttemptMutationOptions): Promise<unknown>;
+    reconcileAttempt?(credential: string, request: ReconcileAttemptRequest): Promise<ReconcileAttemptResponse>;
+    registerLateResult?(credential: string, attemptId: string, request: LateResultRequest): Promise<LateResultResponse>;
 };
 export type ConductorWorkClient = {
-    readWorkContext(credential: string, runId: string, taskId: string): Promise<SiftWakeEnvelope>;
-    checkoutTask(credential: string, runId: string, taskId: string): Promise<WorkTask>;
-    createChildTasks(credential: string, runId: string, taskId: string, children: WorkChildTaskInput[]): Promise<WorkTask[]>;
-    addTaskComment(credential: string, runId: string, taskId: string, bodyMarkdown: string): Promise<WorkTaskComment>;
-    registerArtifact(credential: string, runId: string, taskId: string, artifact: WorkArtifactInput): Promise<WorkArtifact>;
+    readWorkContext(credential: string, runId: string, taskId: string, options?: AttemptMutationOptions): Promise<SiftWakeEnvelope>;
+    checkoutTask(credential: string, runId: string, taskId: string, options?: AttemptMutationOptions): Promise<WorkTask>;
+    createChildTasks(credential: string, runId: string, taskId: string, children: WorkChildTaskInput[], options?: AttemptMutationOptions): Promise<WorkTask[]>;
+    addTaskComment(credential: string, runId: string, taskId: string, bodyMarkdown: string, options?: AttemptMutationOptions): Promise<WorkTaskComment>;
+    registerArtifact(credential: string, runId: string, taskId: string, artifact: WorkArtifactInput, options?: AttemptMutationOptions): Promise<WorkArtifact>;
     requestApproval(credential: string, runId: string, taskId: string, request: {
         type: string;
         payload?: JsonObject;
         idempotencyKey?: string;
-    }): Promise<WorkApproval>;
+    }, options?: AttemptMutationOptions): Promise<WorkApproval>;
     reportUsage(credential: string, runId: string, taskId: string, usage: {
         eventKey: string;
         costMicros: number;
         durationMs: number;
-    }): Promise<WorkUsageDecision>;
-    setTaskDisposition(credential: string, runId: string, taskId: string, disposition: WorkDisposition, resultSummary?: JsonObject): Promise<WorkDispositionResponse>;
+    }, options?: AttemptMutationOptions): Promise<WorkUsageDecision>;
+    setTaskDisposition(credential: string, runId: string, taskId: string, disposition: WorkDisposition, resultSummary?: JsonObject, options?: AttemptMutationOptions): Promise<WorkDispositionResponse>;
     listTasks(userCredential: string, projectId?: string): Promise<WorkTask[]>;
     listRuns(userCredential: string, taskId?: string): Promise<ClaimedJob[]>;
 };

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const CONDUCTOR_VERSION = "0.2.0-beta.1";
+export declare const CONDUCTOR_VERSION = "0.2.0";
 export declare const PROTOCOL_VERSION = "v1";

package/dist/version.js

@@ -1,3 +1,3 @@
-export const CONDUCTOR_VERSION = "0.2.0-beta.1";
+export const CONDUCTOR_VERSION = "0.2.0";
 export const PROTOCOL_VERSION = "v1";
 //# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAChD,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC;AACzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC"}

package/dist/workTypes.d.ts

@@ -56,10 +56,10 @@ export declare const workArtifactSchema: z.ZodObject<{
     url: z.ZodOptional<z.ZodString>;
     brainRecordId: z.ZodOptional<z.ZodString>;
     status: z.ZodEnum<{
+        superseded: "superseded";
+        failed: "failed";
         pending: "pending";
         ready: "ready";
-        failed: "failed";
-        superseded: "superseded";
     }>;
     reviewState: z.ZodEnum<{
         pending: "pending";
@@ -106,9 +106,9 @@ export declare const workProjectSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     status: z.ZodEnum<{
         cancelled: "cancelled";
+        completed: "completed";
         planned: "planned";
         active: "active";
-        completed: "completed";
     }>;
     leadPrincipalId: z.ZodOptional<z.ZodString>;
     contextRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -181,10 +181,10 @@ export declare const workTaskDetailSchema: z.ZodObject<{
         url: z.ZodOptional<z.ZodString>;
         brainRecordId: z.ZodOptional<z.ZodString>;
         status: z.ZodEnum<{
+            superseded: "superseded";
+            failed: "failed";
             pending: "pending";
             ready: "ready";
-            failed: "failed";
-            superseded: "superseded";
         }>;
         reviewState: z.ZodEnum<{
             pending: "pending";