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

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":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,KAAK,EACL,KAAK,EACL,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,EAAE,GAEH,MAAM,kBAAkB,CAAC;AAC1B,OAAO,IAAI,MAAM,WAAW,CAAC;AAO7B,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,QAAgB,EAChB,QAAgB,EAChB,UAA8B,EAAE;IAEhC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACzD,MAAM,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAE9B,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,WAAW,CAAC,GAAG,QAAQ,YAAY,EAAE,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IACD,MAAM,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;AAChE,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,QAAgB,EAChB,QAAgB,EAChB,cAAsE;IAEtE,MAAM,aAAa,GAAG,GAAG,QAAQ,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,UAAU,EAAE,MAAM,CAAC;IAC/E,IAAI,CAAC;QACH,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,YAAY,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,MAAM,cAAc,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;YAC9C,MAAM,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;QACpC,CAAC;QACD,MAAM,MAAM,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;QACtC,MAAM,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC7B,MAAM,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,EAAE,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAChE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,QAAgB,EAAE,QAAgB;IAC5D,IAAI,MAA8B,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QAC3C,MAAM,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACzC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,SAAiB;IAC5C,IAAI,MAA8B,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QACpC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,2BAA2B,CAAC,KAAK,CAAC;YAAE,MAAM,KAAK,CAAC;IACvD,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,QAAgB;IAC1C,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QACpE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,2BAA2B,CAAC,KAAc;IACjD,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC;AACtF,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,CAAC;AACnD,CAAC"}

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 {};

package/dist/runtime/eventOutbox.js

@@ -0,0 +1,206 @@
+import { randomUUID } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { z } from "zod";
+import { defaultConfigPath } from "../config.js";
+import { attemptAuthorityFenceSchema, authorityFence } from "../protocol/fenced.js";
+import { redactSecrets } from "../redaction.js";
+import { atomicWriteOwnerOnly, isNodeError } from "./atomicFile.js";
+export const OUTBOX_SCHEMA_VERSION = 1;
+const MAX_OUTBOX_BYTES = 1024 * 1024;
+const DEFAULT_MAX_ENTRIES = 1_000;
+const eventTypeSchema = z.enum([
+    "health",
+    "progress",
+    "log",
+    "artifact",
+    "approval_requested",
+    "completed",
+    "failed",
+    "cancelled",
+]);
+const outboxEntrySchema = z.object({
+    clientEventId: z.string().min(1).max(200),
+    clientSequence: z.number().int().positive(),
+    attemptId: z.string().min(1),
+    runId: z.string().min(1),
+    authority: attemptAuthorityFenceSchema,
+    event: z.object({
+        eventType: eventTypeSchema,
+        payload: z.record(z.string(), z.unknown()).optional(),
+        occurredAt: z.iso.datetime().optional(),
+    }).strict(),
+    attempts: z.number().int().nonnegative(),
+    enqueuedAt: z.number().int().nonnegative(),
+    nextAttemptAt: z.number().int().nonnegative(),
+    lastErrorMessage: z.string().max(1_000).optional(),
+}).strict();
+const outboxFileSchema = z.object({
+    schemaVersion: z.literal(OUTBOX_SCHEMA_VERSION),
+    entries: z.array(outboxEntrySchema),
+    updatedAt: z.iso.datetime(),
+}).strict();
+const legacyOutboxFileSchema = outboxFileSchema.omit({ schemaVersion: true }).extend({
+    schemaVersion: z.literal(0),
+}).strict();
+export class DurableEventOutbox {
+    path;
+    options;
+    loaded = false;
+    snapshot = emptySnapshot();
+    constructor(path = defaultEventOutboxPath(), options = {}) {
+        this.path = path;
+        this.options = options;
+    }
+    async enqueue(input) {
+        await this.load();
+        if (this.snapshot.entries.length >= (this.options.maxEntries ?? DEFAULT_MAX_ENTRIES)) {
+            throw new Error("Durable event outbox is full; refusing to lose an acknowledged event identity.");
+        }
+        const now = this.nowMs();
+        const entry = outboxEntrySchema.parse({
+            clientEventId: this.createId(),
+            clientSequence: input.clientSequence,
+            attemptId: input.attemptId,
+            runId: input.runId,
+            authority: authorityFence(input.authority),
+            event: sanitizeEvent(input.event),
+            attempts: 0,
+            enqueuedAt: now,
+            nextAttemptAt: now,
+            ...(input.error === undefined ? {} : { lastErrorMessage: safeError(input.error) }),
+        });
+        this.snapshot.entries.push(entry);
+        await this.persist();
+        return structuredClone(entry);
+    }
+    async due(nowMs = this.nowMs()) {
+        await this.load();
+        return structuredClone(this.snapshot.entries.filter((entry) => entry.nextAttemptAt <= nowMs));
+    }
+    async acknowledge(attemptId, acknowledgedClientSequence) {
+        await this.load();
+        this.snapshot.entries = this.snapshot.entries.filter((entry) => entry.attemptId !== attemptId || entry.clientSequence > acknowledgedClientSequence);
+        await this.persist();
+    }
+    async discardAttempt(attemptId) {
+        await this.load();
+        this.snapshot.entries = this.snapshot.entries.filter((entry) => entry.attemptId !== attemptId);
+        await this.persist();
+    }
+    async listAttempt(attemptId) {
+        await this.load();
+        return structuredClone(this.snapshot.entries
+            .filter((entry) => entry.attemptId === attemptId)
+            .sort((left, right) => left.clientSequence - right.clientSequence));
+    }
+    async recordFailure(clientEventId, error, nextAttemptAt) {
+        await this.load();
+        const entry = this.snapshot.entries.find((candidate) => candidate.clientEventId === clientEventId);
+        if (entry === undefined)
+            return;
+        entry.attempts += 1;
+        entry.nextAttemptAt = nextAttemptAt;
+        entry.lastErrorMessage = safeError(error);
+        await this.persist();
+    }
+    async stats() {
+        await this.load();
+        return {
+            retainedEntries: this.snapshot.entries.length,
+            lastClientSequence: Math.max(0, ...this.snapshot.entries.map((entry) => entry.clientSequence)),
+        };
+    }
+    async load() {
+        if (this.loaded)
+            return;
+        const contents = await readOptional(this.path);
+        if (contents === undefined) {
+            this.loaded = true;
+            return;
+        }
+        const parsed = parseSnapshot(contents);
+        if (parsed !== undefined) {
+            this.snapshot = parsed.snapshot;
+            this.loaded = true;
+            if (parsed.migrated)
+                await this.persist();
+            return;
+        }
+        const backup = await readOptional(`${this.path}.last-good`);
+        const recovered = backup === undefined ? undefined : parseSnapshot(backup);
+        if (recovered === undefined) {
+            throw new Error("Durable event outbox is corrupt and has no valid last-good snapshot.");
+        }
+        this.snapshot = recovered.snapshot;
+        this.loaded = true;
+        await this.persist();
+    }
+    async persist() {
+        this.snapshot.updatedAt = new Date(this.nowMs()).toISOString();
+        const parsed = outboxFileSchema.parse(this.snapshot);
+        const contents = `${JSON.stringify(parsed, null, 2)}\n`;
+        if (Buffer.byteLength(contents, "utf8") > MAX_OUTBOX_BYTES) {
+            throw new Error(`Durable event outbox exceeds its ${String(MAX_OUTBOX_BYTES)} byte limit.`);
+        }
+        await atomicWriteOwnerOnly(this.path, contents, { ...this.options, backup: true });
+    }
+    nowMs() {
+        return (this.options.nowMs ?? Date.now)();
+    }
+    createId() {
+        return (this.options.createId ?? randomUUID)();
+    }
+}
+export function defaultEventOutboxPath(env = process.env) {
+    return path.join(path.dirname(defaultConfigPath(env)), "runtime", "event-outbox.json");
+}
+function emptySnapshot() {
+    return { schemaVersion: OUTBOX_SCHEMA_VERSION, entries: [], updatedAt: new Date(0).toISOString() };
+}
+function parseSnapshot(contents) {
+    let raw;
+    try {
+        raw = JSON.parse(contents);
+    }
+    catch {
+        return undefined;
+    }
+    const current = outboxFileSchema.safeParse(raw);
+    if (current.success)
+        return { snapshot: current.data, migrated: false };
+    const legacy = legacyOutboxFileSchema.safeParse(raw);
+    if (!legacy.success)
+        return undefined;
+    return { snapshot: { ...legacy.data, schemaVersion: OUTBOX_SCHEMA_VERSION }, migrated: true };
+}
+function sanitizeEvent(event) {
+    return {
+        ...event,
+        ...(event.payload === undefined ? {} : { payload: sanitizeJson(event.payload) }),
+    };
+}
+function sanitizeJson(value) {
+    return Object.fromEntries(Object.entries(value).map(([key, entry]) => {
+        if (typeof entry === "string")
+            return [key, redactSecrets(entry)];
+        if (Array.isArray(entry)) {
+            return [key, entry.map((item) => typeof item === "string" ? redactSecrets(item) : item)];
+        }
+        return [key, entry];
+    }));
+}
+function safeError(error) {
+    return redactSecrets(error instanceof Error ? error.message : "Unknown event delivery failure.").slice(0, 1_000);
+}
+async function readOptional(filePath) {
+    try {
+        return await readFile(filePath, "utf8");
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT")
+            return undefined;
+        throw error;
+    }
+}
+//# sourceMappingURL=eventOutbox.js.map

package/dist/runtime/eventOutbox.js.map

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