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

package/dist/protocol/fenced.d.ts

@@ -0,0 +1,135 @@
+import { z } from "zod";
+import type { JsonObject } from "../types.js";
+export declare const FENCED_ATTEMPTS_CAPABILITY = "fenced-attempts-v1";
+export declare const attemptAuthoritySchema: z.ZodObject<{
+    attemptId: z.ZodString;
+    leaseGeneration: z.ZodNumber;
+    leaseExpiresAt: z.ZodISODateTime;
+    mustStopAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export declare const attemptAuthorityFenceSchema: z.ZodObject<{
+    attemptId: z.ZodString;
+    leaseGeneration: z.ZodNumber;
+}, z.core.$strict>;
+export declare const clientEventIdentitySchema: z.ZodObject<{
+    clientEventId: z.ZodString;
+    clientSequence: z.ZodNumber;
+}, z.core.$strict>;
+export declare const reconciliationDecisionSchema: z.ZodEnum<{
+    resume: "resume";
+    stop: "stop";
+    superseded: "superseded";
+    already_terminal: "already_terminal";
+    retry_as_new_attempt: "retry_as_new_attempt";
+}>;
+export declare const reconcileAttemptRequestSchema: z.ZodObject<{
+    attemptId: z.ZodString;
+    leaseGeneration: z.ZodNumber;
+    lastAcknowledgedClientSequence: z.ZodNumber;
+    providerResumeSupported: z.ZodBoolean;
+    supervisedProcessRunning: z.ZodBoolean;
+    terminalResult: z.ZodOptional<z.ZodObject<{
+        disposition: z.ZodEnum<{
+            cancelled: "cancelled";
+            completed: "completed";
+            failed: "failed";
+        }>;
+        summary: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const reconcileAttemptResponseSchema: z.ZodObject<{
+    decision: z.ZodEnum<{
+        resume: "resume";
+        stop: "stop";
+        superseded: "superseded";
+        already_terminal: "already_terminal";
+        retry_as_new_attempt: "retry_as_new_attempt";
+    }>;
+    authority: z.ZodOptional<z.ZodObject<{
+        attemptId: z.ZodString;
+        leaseGeneration: z.ZodNumber;
+        leaseExpiresAt: z.ZodISODateTime;
+        mustStopAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+    lastAcknowledgedClientSequence: z.ZodNumber;
+    canonicalStatus: z.ZodString;
+    cancellationRequested: z.ZodBoolean;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const settlementResultSchema: z.ZodObject<{
+    attemptId: z.ZodString;
+    idempotencyKey: z.ZodString;
+    disposition: z.ZodEnum<{
+        cancelled: "cancelled";
+        completed: "completed";
+        failed: "failed";
+    }>;
+    payloadDigest: z.ZodString;
+    terminalAt: z.ZodISODateTime;
+    repeated: z.ZodBoolean;
+}, z.core.$strict>;
+export declare const fencedSettlementResponseSchema: z.ZodObject<{
+    job: z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodEnum<{
+            cancelled: "cancelled";
+            completed: "completed";
+            failed: "failed";
+        }>;
+    }, z.core.$loose>;
+    settlement: z.ZodObject<{
+        attemptId: z.ZodString;
+        idempotencyKey: z.ZodString;
+        disposition: z.ZodEnum<{
+            cancelled: "cancelled";
+            completed: "completed";
+            failed: "failed";
+        }>;
+        payloadDigest: z.ZodString;
+        terminalAt: z.ZodISODateTime;
+        repeated: z.ZodBoolean;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const eventAcknowledgementSchema: z.ZodObject<{
+    eventId: z.ZodString;
+    attemptId: z.ZodString;
+    clientEventId: z.ZodString;
+    clientSequence: z.ZodNumber;
+    acknowledgedClientSequence: z.ZodNumber;
+    serverSequence: z.ZodNumber;
+    repeated: z.ZodBoolean;
+}, z.core.$strict>;
+export declare const lateResultRequestSchema: z.ZodObject<{
+    idempotencyKey: z.ZodString;
+    summary: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    artifactId: z.ZodOptional<z.ZodString>;
+    brainRecordId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const lateResultResponseSchema: z.ZodObject<{
+    lateResult: z.ZodObject<{
+        id: z.ZodString;
+        attemptId: z.ZodString;
+        reviewStatus: z.ZodLiteral<"pending">;
+    }, z.core.$loose>;
+    repeated: z.ZodBoolean;
+}, z.core.$strict>;
+export type AttemptAuthority = z.infer<typeof attemptAuthoritySchema>;
+export type AttemptAuthorityFence = z.infer<typeof attemptAuthorityFenceSchema>;
+export type ClientEventIdentity = z.infer<typeof clientEventIdentitySchema>;
+export type ReconciliationDecision = z.infer<typeof reconciliationDecisionSchema>;
+export type ReconcileAttemptRequest = z.infer<typeof reconcileAttemptRequestSchema>;
+export type ReconcileAttemptResponse = z.infer<typeof reconcileAttemptResponseSchema>;
+export type EventAcknowledgement = z.infer<typeof eventAcknowledgementSchema>;
+export type FencedSettlementResponse = z.infer<typeof fencedSettlementResponseSchema>;
+export type LateResultRequest = z.input<typeof lateResultRequestSchema>;
+export type LateResultResponse = z.infer<typeof lateResultResponseSchema>;
+export type AttemptMutationOptions = {
+    authority?: AttemptAuthorityFence | undefined;
+    idempotencyKey?: string | undefined;
+};
+export type ApiFailureDisposition = "retryable" | "authentication" | "authority_lost" | "conflict" | "invalid_request";
+export declare function classifyApiFailure(status: number, code: string): ApiFailureDisposition;
+export declare function fencedMutationBody<T extends JsonObject>(body: T, options?: AttemptMutationOptions): T & Partial<AttemptAuthorityFence & {
+    idempotencyKey: string;
+}>;
+export declare function authorityFence(authority: AttemptAuthorityFence): AttemptAuthorityFence;

package/dist/protocol/fenced.js

@@ -0,0 +1,142 @@
+import { z } from "zod";
+export const FENCED_ATTEMPTS_CAPABILITY = "fenced-attempts-v1";
+export const attemptAuthoritySchema = z.object({
+    attemptId: z.string().min(1),
+    leaseGeneration: z.number().int().positive(),
+    leaseExpiresAt: z.iso.datetime(),
+    mustStopAt: z.iso.datetime(),
+}).strict();
+export const attemptAuthorityFenceSchema = attemptAuthoritySchema.pick({
+    attemptId: true,
+    leaseGeneration: true,
+}).strict();
+export const clientEventIdentitySchema = z.object({
+    clientEventId: z.string().min(1).max(200),
+    clientSequence: z.number().int().positive(),
+}).strict();
+export const reconciliationDecisionSchema = z.enum([
+    "resume",
+    "stop",
+    "superseded",
+    "already_terminal",
+    "retry_as_new_attempt",
+]);
+export const reconcileAttemptRequestSchema = z.object({
+    attemptId: z.string().min(1),
+    leaseGeneration: z.number().int().positive(),
+    lastAcknowledgedClientSequence: z.number().int().nonnegative(),
+    providerResumeSupported: z.boolean(),
+    supervisedProcessRunning: z.boolean(),
+    terminalResult: z.object({
+        disposition: z.enum(["completed", "failed", "cancelled"]),
+        summary: z.record(z.string(), z.unknown()).optional(),
+    }).strict().optional(),
+}).strict();
+export const reconcileAttemptResponseSchema = z.object({
+    decision: reconciliationDecisionSchema,
+    authority: attemptAuthoritySchema.optional(),
+    lastAcknowledgedClientSequence: z.number().int().nonnegative(),
+    canonicalStatus: z.string().min(1),
+    cancellationRequested: z.boolean(),
+    reason: z.string().min(1).max(1_000).optional(),
+}).superRefine((value, context) => {
+    if ((value.decision === "resume" || value.decision === "retry_as_new_attempt") &&
+        value.authority === undefined) {
+        context.addIssue({
+            code: "custom",
+            message: value.decision === "resume"
+                ? "A resume reconciliation decision requires refreshed authority."
+                : "A retry-as-new-attempt decision requires replacement authority.",
+            path: ["authority"],
+        });
+    }
+    if (value.decision !== "resume" &&
+        value.decision !== "retry_as_new_attempt" &&
+        value.authority !== undefined) {
+        context.addIssue({
+            code: "custom",
+            message: "Only a resume or retry-as-new-attempt decision may grant authority.",
+            path: ["authority"],
+        });
+    }
+});
+export const settlementResultSchema = z.object({
+    attemptId: z.string().min(1),
+    idempotencyKey: z.string().min(1).max(200),
+    disposition: z.enum(["completed", "failed", "cancelled"]),
+    payloadDigest: z.string().min(1),
+    terminalAt: z.iso.datetime(),
+    repeated: z.boolean(),
+}).strict();
+export const fencedSettlementResponseSchema = z.object({
+    job: z.looseObject({
+        id: z.string().min(1),
+        status: z.enum(["completed", "failed", "cancelled"]),
+    }),
+    settlement: settlementResultSchema,
+}).strict();
+export const eventAcknowledgementSchema = z.object({
+    eventId: z.string().min(1),
+    attemptId: z.string().min(1),
+    clientEventId: z.string().min(1).max(200),
+    clientSequence: z.number().int().positive(),
+    acknowledgedClientSequence: z.number().int().nonnegative(),
+    serverSequence: z.number().int().positive(),
+    repeated: z.boolean(),
+}).strict();
+export const lateResultRequestSchema = z.object({
+    idempotencyKey: z.string().min(1).max(200),
+    summary: z.record(z.string(), z.unknown()),
+    artifactId: z.string().min(1).optional(),
+    brainRecordId: z.string().min(1).optional(),
+}).strict();
+export const lateResultResponseSchema = z.object({
+    lateResult: z.object({
+        id: z.string().min(1),
+        attemptId: z.string().min(1),
+        reviewStatus: z.literal("pending"),
+    }).loose(),
+    repeated: z.boolean(),
+}).strict();
+const AUTHORITY_ERROR_CODES = new Set([
+    "stale_attempt",
+    "stale_generation",
+    "authority_expired",
+    "deadline_exceeded",
+    "run_cancelled",
+    "attempt_superseded",
+    "already_terminal",
+]);
+export function classifyApiFailure(status, code) {
+    if (status === 0 || status === 408 || status === 425 || status === 429 || status >= 500) {
+        return "retryable";
+    }
+    if (status === 401 || status === 403) {
+        return "authentication";
+    }
+    if (AUTHORITY_ERROR_CODES.has(code)) {
+        return "authority_lost";
+    }
+    if (status === 409) {
+        return "conflict";
+    }
+    return "invalid_request";
+}
+export function fencedMutationBody(body, options) {
+    return {
+        ...body,
+        ...(options?.authority === undefined
+            ? {}
+            : authorityFence(options.authority)),
+        ...(options?.idempotencyKey === undefined
+            ? {}
+            : { idempotencyKey: z.string().min(1).max(200).parse(options.idempotencyKey) }),
+    };
+}
+export function authorityFence(authority) {
+    return attemptAuthorityFenceSchema.parse({
+        attemptId: authority.attemptId,
+        leaseGeneration: authority.leaseGeneration,
+    });
+}
+//# sourceMappingURL=fenced.js.map

package/dist/protocol/fenced.js.map

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

package/dist/redaction.js

@@ -1,5 +1,6 @@
 const CONDUCTOR_CREDENTIAL_PATTERN = /sift_conductor_([^:\s]+):([^\s]+)/gu;
 const PAIRING_CODE_PATTERN = /\bSC-[A-Za-z0-9_-]+\b/gu;
+const PROVIDER_SECRET_PATTERN = /\b(?:sk-[A-Za-z0-9_-]{8,}|gh[pousr]_[A-Za-z0-9_-]{8,})\b/gu;
 const HOME_PATH_PATTERNS = [
     {
         regex: /\/Users\/([^/\\\s]+)/gu,
@@ -17,6 +18,7 @@ const HOME_PATH_PATTERNS = [
 export function redactSecrets(input) {
     let redacted = input.replace(CONDUCTOR_CREDENTIAL_PATTERN, "sift_conductor_$1:<redacted>");
     redacted = redacted.replace(PAIRING_CODE_PATTERN, "SC-<redacted>");
+    redacted = redacted.replace(PROVIDER_SECRET_PATTERN, "<provider-secret-redacted>");
     for (const pattern of HOME_PATH_PATTERNS) {
         redacted = redacted.replace(pattern.regex, pattern.replace);
     }

package/dist/redaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"redaction.js","sourceRoot":"","sources":["../src/redaction.ts"],"names":[],"mappings":"AAAA,MAAM,4BAA4B,GAAG,qCAAqC,CAAC;AAC3E,MAAM,oBAAoB,GAAG,yBAAyB,CAAC;AACvD,MAAM,kBAAkB,GAAG;IACzB;QACE,KAAK,EAAE,wBAAwB;QAC/B,OAAO,EAAE,CAAC,MAAc,EAAE,IAAY,EAAE,EAAE,CAAC,UAAU,eAAe,CAAC,IAAI,CAAC,EAAE;KAC7E;IACD;QACE,KAAK,EAAE,uBAAuB;QAC9B,OAAO,EAAE,CAAC,MAAc,EAAE,IAAY,EAAE,EAAE,CAAC,SAAS,eAAe,CAAC,IAAI,CAAC,EAAE;KAC5E;IACD;QACE,KAAK,EAAE,mCAAmC;QAC1C,OAAO,EAAE,CAAC,MAAc,EAAE,MAAc,EAAE,IAAY,EAAE,EAAE,CAAC,GAAG,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,EAAE;KAC/F;CACO,CAAC;AAEX,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAI,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,4BAA4B,EAAE,8BAA8B,CAAC,CAAC;IAC3F,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,oBAAoB,EAAE,eAAe,CAAC,CAAC;IACnE,KAAK,MAAM,OAAO,IAAI,kBAAkB,EAAE,CAAC;QACzC,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,OAAO,aAAa,CAAC,UAAU,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7E,CAAC"}
+{"version":3,"file":"redaction.js","sourceRoot":"","sources":["../src/redaction.ts"],"names":[],"mappings":"AAAA,MAAM,4BAA4B,GAAG,qCAAqC,CAAC;AAC3E,MAAM,oBAAoB,GAAG,yBAAyB,CAAC;AACvD,MAAM,uBAAuB,GAAG,4DAA4D,CAAC;AAC7F,MAAM,kBAAkB,GAAG;IACzB;QACE,KAAK,EAAE,wBAAwB;QAC/B,OAAO,EAAE,CAAC,MAAc,EAAE,IAAY,EAAE,EAAE,CAAC,UAAU,eAAe,CAAC,IAAI,CAAC,EAAE;KAC7E;IACD;QACE,KAAK,EAAE,uBAAuB;QAC9B,OAAO,EAAE,CAAC,MAAc,EAAE,IAAY,EAAE,EAAE,CAAC,SAAS,eAAe,CAAC,IAAI,CAAC,EAAE;KAC5E;IACD;QACE,KAAK,EAAE,mCAAmC;QAC1C,OAAO,EAAE,CAAC,MAAc,EAAE,MAAc,EAAE,IAAY,EAAE,EAAE,CAAC,GAAG,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,EAAE;KAC/F;CACO,CAAC;AAEX,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAI,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,4BAA4B,EAAE,8BAA8B,CAAC,CAAC;IAC3F,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,oBAAoB,EAAE,eAAe,CAAC,CAAC;IACnE,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,uBAAuB,EAAE,4BAA4B,CAAC,CAAC;IACnF,KAAK,MAAM,OAAO,IAAI,kBAAkB,EAAE,CAAC;QACzC,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,OAAO,aAAa,CAAC,UAAU,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7E,CAAC"}

package/dist/runtime/atomicFile.d.ts

@@ -0,0 +1,6 @@
+export type AtomicWriteOptions = {
+    backup?: boolean | undefined;
+    writeTemporary?: ((filePath: string, contents: string) => Promise<void>) | undefined;
+};
+export declare function atomicWriteOwnerOnly(filePath: string, contents: string, options?: AtomicWriteOptions): Promise<void>;
+export declare function isNodeError(error: unknown): error is NodeJS.ErrnoException;

package/dist/runtime/atomicFile.js

@@ -0,0 +1,78 @@
+import { randomUUID } from "node:crypto";
+import { chmod, mkdir, open, readFile, rename, rm, } from "node:fs/promises";
+import path from "node:path";
+export async function atomicWriteOwnerOnly(filePath, contents, options = {}) {
+    const directory = path.dirname(filePath);
+    await mkdir(directory, { recursive: true, mode: 0o700 });
+    await chmod(directory, 0o700);
+    if (options.backup === true) {
+        const previous = await readOptional(filePath);
+        if (previous !== undefined) {
+            await replaceFile(`${filePath}.last-good`, previous, options.writeTemporary);
+        }
+    }
+    await replaceFile(filePath, contents, options.writeTemporary);
+}
+async function replaceFile(filePath, contents, writeTemporary) {
+    const temporaryPath = `${filePath}.${String(process.pid)}.${randomUUID()}.tmp`;
+    try {
+        if (writeTemporary === undefined) {
+            await writeAndSync(temporaryPath, contents);
+        }
+        else {
+            await writeTemporary(temporaryPath, contents);
+            await chmod(temporaryPath, 0o600);
+        }
+        await rename(temporaryPath, filePath);
+        await chmod(filePath, 0o600);
+        await syncDirectory(path.dirname(filePath));
+    }
+    catch (error) {
+        await rm(temporaryPath, { force: true }).catch(() => undefined);
+        throw error;
+    }
+}
+async function writeAndSync(filePath, contents) {
+    let handle;
+    try {
+        handle = await open(filePath, "wx", 0o600);
+        await handle.writeFile(contents, "utf8");
+        await handle.sync();
+    }
+    finally {
+        await handle?.close();
+    }
+}
+async function syncDirectory(directory) {
+    let handle;
+    try {
+        handle = await open(directory, "r");
+        await handle.sync();
+    }
+    catch (error) {
+        if (!ignorableDirectorySyncError(error))
+            throw error;
+    }
+    finally {
+        await handle?.close();
+    }
+}
+async function readOptional(filePath) {
+    try {
+        return await readFile(filePath, "utf8");
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT")
+            return undefined;
+        throw error;
+    }
+}
+function ignorableDirectorySyncError(error) {
+    if (!isNodeError(error))
+        return false;
+    return error.code === "EINVAL" || error.code === "EISDIR" || error.code === "EPERM";
+}
+export function isNodeError(error) {
+    return error instanceof Error && "code" in error;
+}
+//# sourceMappingURL=atomicFile.js.map

package/dist/runtime/atomicFile.js.map

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

package/dist/runtime/daemonCapabilities.d.ts

@@ -0,0 +1,7 @@
+import type { LocalAgentAdapter } from "../adapters/types.js";
+import type { ConductorAgentAdvertisement, JsonObject } from "../types.js";
+export type ReadyAdapter = LocalAgentAdapter & {
+    readinessMetadata: JsonObject;
+};
+export declare function daemonCapabilities(adapters: LocalAgentAdapter[]): JsonObject;
+export declare function advertiseAdapters(adapters: ReadyAdapter[]): ConductorAgentAdvertisement[];

package/dist/runtime/daemonCapabilities.js

@@ -0,0 +1,24 @@
+import { FENCED_ATTEMPTS_CAPABILITY } from "../protocol/fenced.js";
+import { processTreeTerminationCapability } from "./process.js";
+export function daemonCapabilities(adapters) {
+    return {
+        platform: process.platform,
+        adapters: adapters.map((adapter) => adapter.adapterType),
+        [FENCED_ATTEMPTS_CAPABILITY]: true,
+        processTreeTermination: processTreeTerminationCapability(),
+    };
+}
+export function advertiseAdapters(adapters) {
+    return adapters.map((adapter) => ({
+        localKey: adapter.localKey,
+        displayName: adapter.displayName,
+        adapterType: adapter.adapterType,
+        status: "active",
+        capabilities: {
+            ...adapter.capabilities,
+            ...adapter.readinessMetadata,
+            resumeSupport: adapter.resumeSupport ?? "none",
+        },
+    }));
+}
+//# sourceMappingURL=daemonCapabilities.js.map

package/dist/runtime/daemonCapabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemonCapabilities.js","sourceRoot":"","sources":["../../src/runtime/daemonCapabilities.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,EAAE,gCAAgC,EAAE,MAAM,cAAc,CAAC;AAIhE,MAAM,UAAU,kBAAkB,CAAC,QAA6B;IAC9D,OAAO;QACL,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC;QACxD,CAAC,0BAA0B,CAAC,EAAE,IAAI;QAClC,sBAAsB,EAAE,gCAAgC,EAAE;KAC3D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAwB;IACxD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,MAAM,EAAE,QAAQ;QAChB,YAAY,EAAE;YACZ,GAAG,OAAO,CAAC,YAAY;YACvB,GAAG,OAAO,CAAC,iBAAiB;YAC5B,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,MAAM;SAC/C;KACF,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/runtime/eventOutbox.d.ts

@@ -0,0 +1,100 @@
+import { z } from "zod";
+import type { RunEventInput } from "../types.js";
+import { type AtomicWriteOptions } from "./atomicFile.js";
+export declare const OUTBOX_SCHEMA_VERSION = 1;
+declare const outboxEntrySchema: z.ZodObject<{
+    clientEventId: z.ZodString;
+    clientSequence: z.ZodNumber;
+    attemptId: z.ZodString;
+    runId: z.ZodString;
+    authority: z.ZodObject<{
+        attemptId: z.ZodString;
+        leaseGeneration: z.ZodNumber;
+    }, z.core.$strict>;
+    event: z.ZodObject<{
+        eventType: z.ZodEnum<{
+            cancelled: "cancelled";
+            completed: "completed";
+            failed: "failed";
+            health: "health";
+            progress: "progress";
+            log: "log";
+            artifact: "artifact";
+            approval_requested: "approval_requested";
+        }>;
+        payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        occurredAt: z.ZodOptional<z.ZodISODateTime>;
+    }, z.core.$strict>;
+    attempts: z.ZodNumber;
+    enqueuedAt: z.ZodNumber;
+    nextAttemptAt: z.ZodNumber;
+    lastErrorMessage: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+declare const outboxFileSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    entries: z.ZodArray<z.ZodObject<{
+        clientEventId: z.ZodString;
+        clientSequence: z.ZodNumber;
+        attemptId: z.ZodString;
+        runId: z.ZodString;
+        authority: z.ZodObject<{
+            attemptId: z.ZodString;
+            leaseGeneration: z.ZodNumber;
+        }, z.core.$strict>;
+        event: z.ZodObject<{
+            eventType: z.ZodEnum<{
+                cancelled: "cancelled";
+                completed: "completed";
+                failed: "failed";
+                health: "health";
+                progress: "progress";
+                log: "log";
+                artifact: "artifact";
+                approval_requested: "approval_requested";
+            }>;
+            payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            occurredAt: z.ZodOptional<z.ZodISODateTime>;
+        }, z.core.$strict>;
+        attempts: z.ZodNumber;
+        enqueuedAt: z.ZodNumber;
+        nextAttemptAt: z.ZodNumber;
+        lastErrorMessage: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    updatedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export type DurableRunEvent = z.infer<typeof outboxEntrySchema>;
+export type EventOutboxSnapshot = z.infer<typeof outboxFileSchema>;
+export declare class DurableEventOutbox {
+    readonly path: string;
+    private readonly options;
+    private loaded;
+    private snapshot;
+    constructor(path?: string, options?: AtomicWriteOptions & {
+        maxEntries?: number | undefined;
+        nowMs?: (() => number) | undefined;
+        createId?: (() => string) | undefined;
+    });
+    enqueue(input: {
+        attemptId: string;
+        runId: string;
+        authority: DurableRunEvent["authority"];
+        clientSequence: number;
+        event: RunEventInput;
+        error?: unknown;
+    }): Promise<DurableRunEvent>;
+    due(nowMs?: number): Promise<DurableRunEvent[]>;
+    acknowledge(attemptId: string, acknowledgedClientSequence: number): Promise<void>;
+    discardAttempt(attemptId: string): Promise<void>;
+    listAttempt(attemptId: string): Promise<DurableRunEvent[]>;
+    recordFailure(clientEventId: string, error: unknown, nextAttemptAt: number): Promise<void>;
+    stats(): Promise<{
+        retainedEntries: number;
+        lastClientSequence: number;
+    }>;
+    private load;
+    private persist;
+    private nowMs;
+    private createId;
+}
+export declare function defaultEventOutboxPath(env?: NodeJS.ProcessEnv): string;
+export {};