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

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-beta.2";
 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-beta.2";
 export const PROTOCOL_VERSION = "v1";
 //# sourceMappingURL=version.js.map

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";