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

package/dist/localApi/workContracts.js

@@ -0,0 +1,130 @@
+import { z } from "zod";
+import { workTaskStatusSchema } from "../workTypes.js";
+export const workQueueStateSchema = z.enum([
+    "needs_review",
+    "blocked",
+    "running",
+    "ready",
+    "finished",
+    "needs_attention",
+]);
+export const workConsoleSnapshotSchema = z.object({
+    state: z.enum(["unauthorized", "ready", "offline"]),
+    message: z.string().optional(),
+    refreshedAt: z.string(),
+    selectedProjectId: z.string().optional(),
+    selectedTaskId: z.string().optional(),
+    projects: z.array(z.object({
+        id: z.string(),
+        name: z.string(),
+        description: z.string().optional(),
+        stateLabel: z.string(),
+    }).strict()),
+    agents: z.array(z.object({
+        conductorAgentId: z.string(),
+        agentPrincipalId: z.string(),
+        localKey: z.string(),
+        displayName: z.string(),
+        adapterType: z.string(),
+        stateLabel: z.string(),
+        available: z.boolean(),
+    }).strict()),
+    queue: z.array(z.object({
+        id: z.string(),
+        projectId: z.string().optional(),
+        title: z.string(),
+        state: workQueueStateSchema,
+        stateLabel: z.string(),
+        priority: z.enum(["critical", "high", "medium", "low"]),
+        assigneePrincipalId: z.string().optional(),
+        runId: z.string().optional(),
+        progressSummary: z.string().optional(),
+        updatedAt: z.string(),
+    }).strict()),
+    detail: z.object({
+        id: z.string(),
+        title: z.string(),
+        bodyMarkdown: z.string(),
+        status: workTaskStatusSchema,
+        stateLabel: z.string(),
+        priority: z.enum(["critical", "high", "medium", "low"]),
+        assigneePrincipalId: z.string().optional(),
+        updatedAt: z.string(),
+        run: z.object({
+            id: z.string(),
+            stateLabel: z.string(),
+            progressSummary: z.string(),
+            updatedAt: z.string(),
+            localStateLabel: z.string().optional(),
+            events: z.array(z.object({
+                id: z.string(),
+                type: z.string(),
+                summary: z.string(),
+                occurredAt: z.string(),
+            }).strict()),
+            trace: z.array(z.object({
+                id: z.string(),
+                stream: z.enum(["stdout", "stderr", "system"]),
+                message: z.string(),
+                occurredAt: z.string(),
+                truncated: z.boolean(),
+            }).strict()),
+        }).strict().optional(),
+        comments: z.array(z.object({ id: z.string(), bodyMarkdown: z.string(), authorPrincipalId: z.string(), createdAt: z.string() }).strict()),
+        artifacts: z.array(z.object({ id: z.string(), title: z.string(), summary: z.string().optional(), stateLabel: z.string(), openTarget: z.string().optional(), intermediate: z.boolean() }).strict()),
+        approvals: z.array(z.object({ id: z.string(), typeLabel: z.string(), state: z.enum(["pending", "approved", "rejected", "revision_requested"]), stateLabel: z.string(), decisionNote: z.string().optional() }).strict()),
+        blockers: z.array(z.object({ id: z.string(), title: z.string(), stateLabel: z.string() }).strict()),
+        actions: z.object({
+            canEdit: z.boolean(),
+            canDispatch: z.boolean(),
+            canComment: z.boolean(),
+            canCancel: z.boolean(),
+            canReview: z.boolean(),
+            canRetry: z.boolean(),
+        }).strict(),
+    }).strict().optional(),
+    activity: z.array(z.object({
+        id: z.string(),
+        summary: z.string(),
+        occurredAt: z.string(),
+        taskId: z.string().optional(),
+        runId: z.string().optional(),
+        correlationId: z.string().optional(),
+    }).strict()),
+}).strict();
+export const workSnapshotRequestSchema = z.object({
+    projectId: z.string().min(1).optional(),
+    taskId: z.string().min(1).optional(),
+}).strict();
+export const createTaskRequestSchema = z.object({
+    projectId: z.string().min(1).optional(),
+    title: z.string().trim().min(1).max(300),
+    bodyMarkdown: z.string().max(100_000).optional(),
+    priority: z.enum(["critical", "high", "medium", "low"]).optional(),
+    assigneePrincipalId: z.string().min(1).optional(),
+}).strict();
+export const updateTaskRequestSchema = z.object({
+    taskId: z.string().min(1),
+    title: z.string().trim().min(1).max(300).optional(),
+    bodyMarkdown: z.string().max(100_000).optional(),
+    status: workTaskStatusSchema.optional(),
+    priority: z.enum(["critical", "high", "medium", "low"]).optional(),
+    assigneePrincipalId: z.string().min(1).optional(),
+}).strict();
+export const commentTaskRequestSchema = z.object({
+    taskId: z.string().min(1),
+    bodyMarkdown: z.string().trim().min(1).max(20_000),
+}).strict();
+export const dispatchTaskRequestSchema = z.object({
+    taskId: z.string().min(1),
+    conductorAgentId: z.string().min(1),
+    reason: z.string().trim().min(1).max(500).optional(),
+    idempotencyKey: z.string().min(1).max(200).optional(),
+}).strict();
+export const approvalDecisionRequestSchema = z.object({
+    approvalId: z.string().min(1),
+    decision: z.enum(["approved", "rejected", "revision_requested"]),
+    decisionNote: z.string().trim().min(1).max(20_000).optional(),
+}).strict();
+export const cancelRunRequestSchema = z.object({ runId: z.string().min(1) }).strict();
+//# sourceMappingURL=workContracts.js.map

package/dist/localApi/workContracts.js.map

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

package/dist/localApp/platform.d.ts

@@ -0,0 +1,2 @@
+export declare function openExternalUrl(url: string): Promise<void>;
+export declare function selectLocalFolder(): Promise<string | undefined>;

package/dist/localApp/platform.js

@@ -0,0 +1,57 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+export async function openExternalUrl(url) {
+    const parsed = new URL(url);
+    if (parsed.protocol !== "https:" && !isLoopbackHttp(parsed)) {
+        throw new Error("Conductor can open only HTTPS or loopback HTTP destinations.");
+    }
+    if (process.platform === "darwin") {
+        await execFileAsync("open", [parsed.toString()]);
+        return;
+    }
+    if (process.platform === "win32") {
+        await execFileAsync("cmd", ["/c", "start", "", parsed.toString()], { windowsHide: true });
+        return;
+    }
+    await execFileAsync("xdg-open", [parsed.toString()]);
+}
+export async function selectLocalFolder() {
+    try {
+        if (process.platform === "darwin") {
+            const result = await execFileAsync("osascript", [
+                "-e",
+                "POSIX path of (choose folder with prompt \"Choose an agent workspace\")",
+            ]);
+            return normalizedSelection(result.stdout);
+        }
+        if (process.platform === "win32") {
+            const script = [
+                "Add-Type -AssemblyName System.Windows.Forms;",
+                "$dialog = New-Object System.Windows.Forms.FolderBrowserDialog;",
+                "$dialog.Description = 'Choose an agent workspace';",
+                "if ($dialog.ShowDialog() -eq 'OK') { Write-Output $dialog.SelectedPath }",
+            ].join(" ");
+            const result = await execFileAsync("powershell.exe", ["-NoProfile", "-NonInteractive", "-Command", script], { windowsHide: true });
+            return normalizedSelection(result.stdout);
+        }
+        const result = await execFileAsync("zenity", ["--file-selection", "--directory", "--title=Choose an agent workspace"]);
+        return normalizedSelection(result.stdout);
+    }
+    catch (error) {
+        if (isCancellation(error))
+            return undefined;
+        throw new Error("Folder selection is unavailable on this computer. Configure the agent through the CLI instead.");
+    }
+}
+function isLoopbackHttp(url) {
+    return url.protocol === "http:" && (url.hostname === "127.0.0.1" || url.hostname === "::1" || url.hostname === "localhost");
+}
+function normalizedSelection(value) {
+    const selected = value.trim();
+    return selected.length === 0 ? undefined : selected.replace(/[\\/]$/u, "");
+}
+function isCancellation(error) {
+    return error instanceof Error && "code" in error && [1, 130].includes(Number(error.code));
+}
+//# sourceMappingURL=platform.js.map

package/dist/localApp/platform.js.map

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

package/dist/localApp/service.d.ts

@@ -0,0 +1,25 @@
+import { type ConductorLocalApi } from "../localApi/contracts.js";
+export type LocalAppHandle = {
+    origin: string;
+    browserUrl: string;
+    close(): Promise<void>;
+    waitUntilStopped(): Promise<void>;
+};
+export type StartLocalAppOptions = {
+    api: ConductorLocalApi;
+    staticDirectory: string;
+    preferredPort?: number | undefined;
+    openBrowser?: boolean | undefined;
+    browserOpener?: ((url: string) => Promise<void>) | undefined;
+    startRuntime?: boolean | undefined;
+    installSignalHandlers?: boolean | undefined;
+};
+export declare function startLocalApp(options: StartLocalAppOptions): Promise<LocalAppHandle>;
+export declare function startConductorLocalApp(input?: {
+    configPath?: string | undefined;
+    preferredPort?: number | undefined;
+    openBrowser?: boolean | undefined;
+    staticDirectory?: string | undefined;
+    browserOpener?: ((url: string) => Promise<void>) | undefined;
+}): Promise<LocalAppHandle>;
+export declare function defaultStaticDirectory(): string;

package/dist/localApp/service.js

@@ -0,0 +1,126 @@
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { ProviderAgentStore } from "../adapters/provider/store.js";
+import { FileConfigStore } from "../config.js";
+import { DesktopController } from "../desktop/app/controller.js";
+import { createLocalControllerApi } from "../localApi/contracts.js";
+import { assertStaticAssets, startLocalWebServer } from "../localApi/server.js";
+import { openExternalUrl, selectLocalFolder } from "./platform.js";
+import { ConductorUserAuthorizationService } from "../userAuth/service.js";
+import { createUserCredentialStore } from "../userAuth/store.js";
+import { WorkConsoleService } from "../localApi/workConsole.js";
+import { LocalRuntimeSessionCache } from "../runtime/localSessionCache.js";
+import { LocalLogSpool } from "../runtime/localLogSpool.js";
+import { DesktopRuntimeController } from "../desktop/app/runtimeController.js";
+import { AuthorizedPairingService } from "../localApi/authorizedPairing.js";
+import { ExecutionJournalStore } from "../runtime/executionJournal.js";
+import { DurableEventOutbox } from "../runtime/eventOutbox.js";
+import { LocalRecoveryService } from "../localApi/recovery.js";
+export async function startLocalApp(options) {
+    await assertStaticAssets(options.staticDirectory);
+    const server = await startLocalWebServer({
+        api: options.api,
+        staticDirectory: options.staticDirectory,
+        preferredPort: options.preferredPort,
+    });
+    let closed = false;
+    let resolveStopped;
+    const stopped = new Promise((resolve) => { resolveStopped = resolve; });
+    const close = async () => {
+        if (closed)
+            return;
+        closed = true;
+        removeSignals();
+        await stopRuntimeSafely(options.api);
+        await server.close();
+        resolveStopped?.();
+    };
+    const onSignal = () => { void close(); };
+    const removeSignals = installSignals(options.installSignalHandlers !== false, onSignal);
+    try {
+        if (options.startRuntime !== false && (await options.api.pairedStatus()).paired) {
+            await options.api.startRuntime();
+        }
+        if (options.openBrowser !== false) {
+            await (options.browserOpener ?? openExternalUrl)(server.browserUrl);
+        }
+    }
+    catch (error) {
+        await close();
+        throw error;
+    }
+    return {
+        origin: server.origin,
+        browserUrl: server.browserUrl,
+        close,
+        waitUntilStopped: () => stopped,
+    };
+}
+export async function startConductorLocalApp(input = {}) {
+    const configStore = new FileConfigStore(input.configPath);
+    const agentStore = new ProviderAgentStore(input.configPath === undefined
+        ? undefined
+        : path.join(path.dirname(input.configPath), "agents.json"));
+    const sessionCache = new LocalRuntimeSessionCache();
+    const logSpool = new LocalLogSpool();
+    const runtimeDirectory = path.join(path.dirname(configStore.path), "runtime");
+    const journalStore = new ExecutionJournalStore(path.join(runtimeDirectory, "executions"));
+    const eventOutbox = new DurableEventOutbox(path.join(runtimeDirectory, "event-outbox.json"));
+    const runtime = new DesktopRuntimeController({
+        configStore,
+        agentStore,
+        sessionCache,
+        logSpool,
+        journalStore,
+        eventOutbox,
+    });
+    const controller = new DesktopController({
+        configStore,
+        agentStore,
+        runtime,
+        selectFolder: selectLocalFolder,
+        openExternal: openExternalUrl,
+    });
+    const userAuthorization = new ConductorUserAuthorizationService({
+        configStore,
+        credentialStore: createUserCredentialStore(),
+        openBrowser: openExternalUrl,
+    });
+    const work = new WorkConsoleService({ configStore, authorization: userAuthorization, sessionCache, logSpool });
+    const authorizedPairing = new AuthorizedPairingService({ authorization: userAuthorization, controller });
+    const recovery = new LocalRecoveryService({ journals: journalStore, outbox: eventOutbox, runtime });
+    return startLocalApp({
+        api: createLocalControllerApi(controller, userAuthorization, work, authorizedPairing, {
+            clear: () => {
+                sessionCache.clear();
+                logSpool.clearAll();
+            },
+        }, recovery),
+        staticDirectory: input.staticDirectory ?? defaultStaticDirectory(),
+        preferredPort: input.preferredPort,
+        openBrowser: input.openBrowser,
+        browserOpener: input.browserOpener,
+    });
+}
+export function defaultStaticDirectory() {
+    return path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../dist-web");
+}
+async function stopRuntimeSafely(api) {
+    try {
+        await api.stopRuntime();
+    }
+    catch {
+        // The HTTP listener must still close if runtime shutdown reports a failure.
+    }
+}
+function installSignals(enabled, onSignal) {
+    if (!enabled)
+        return () => undefined;
+    process.once("SIGINT", onSignal);
+    process.once("SIGTERM", onSignal);
+    return () => {
+        process.off("SIGINT", onSignal);
+        process.off("SIGTERM", onSignal);
+    };
+}
+//# sourceMappingURL=service.js.map

package/dist/localApp/service.js.map

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

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