@noopolis/daimon 0.1.1 → 0.2.0

package/dist/runtime/wakeAcceptanceRecord.js

@@ -0,0 +1,56 @@
+import { redactCredentialText } from "../core/credentialRedaction.js";
+import { WAKE_ACCEPTANCE_VERSION, WAKE_RECEIPT_STATUS_VERSION, parseWakeAcceptanceRequest, sanitizeWakeCompletionText, wakeAcceptanceDigest } from "./wakeAcceptanceTypes.js";
+export function publicAcceptance(record) {
+    return { version: WAKE_ACCEPTANCE_VERSION, acceptance_id: record.acceptance_id, agent_id: record.agent_id, delivery_id: record.delivery_id, request_digest: record.request_digest, state: "accepted", accepted_at: record.accepted_at };
+}
+export function publicStatus(record) {
+    return { version: WAKE_RECEIPT_STATUS_VERSION, acceptance_id: record.acceptance_id, agent_id: record.agent_id, delivery_id: record.delivery_id, request_digest: record.request_digest, state: record.state, accepted_at: record.accepted_at, updated_at: record.updated_at, ...(record.execution_id === undefined ? {} : { execution_id: record.execution_id }), ...(record.deferred === undefined ? {} : { deferred: record.deferred }), ...(record.code === undefined ? {} : { code: record.code }), ...(record.text === undefined ? {} : { text: record.text }) };
+}
+export function parseStoredWakeAcceptance(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value))
+        throw new Error("wake acceptance record is invalid");
+    const record = value;
+    const keys = ["acceptance_id", "agent_id", "delivery_id", "request_digest", "event", "state", "accepted_at", "updated_at", "claim_generation", "execution_id", "deferred", "execution_error", "code", "text"];
+    if (Object.keys(record).some((key) => !keys.includes(key)))
+        throw new Error("wake acceptance record is invalid");
+    const parsed = parseWakeAcceptanceRequest({ token: undefined, agent_id: string(record.agent_id), delivery_id: string(record.delivery_id), event: record.event });
+    const state = string(record.state);
+    if (!["accepted", "running", "completed", "failed", "stopped"].includes(state))
+        throw new Error("wake acceptance record is invalid");
+    const code = record.code === undefined ? undefined : string(record.code);
+    const claimGeneration = record.claim_generation === undefined ? undefined : string(record.claim_generation);
+    const executionId = record.execution_id === undefined ? undefined : string(record.execution_id);
+    if (executionId !== undefined && !uuid(executionId) || record.deferred !== undefined && typeof record.deferred !== "boolean")
+        throw new Error("wake acceptance attention state is invalid");
+    const executionError = record.execution_error === undefined ? undefined : sanitizeExecutionError(string(record.execution_error));
+    if (executionError === "" || record.execution_error !== undefined && Buffer.byteLength(string(record.execution_error)) > MAX_EXECUTION_ERROR_BYTES)
+        throw new Error("wake acceptance execution error is invalid");
+    const completionText = record.text === undefined ? undefined : sanitizeWakeCompletionText(string(record.text));
+    if (claimGeneration !== undefined && !uuid(claimGeneration))
+        throw new Error("wake acceptance record is invalid");
+    if (code !== undefined && !["engine_failed", "host_stopped", "host_stopping", "queued_wake_stopped", "active_wake_aborted", "queue_full", "unknown_agent"].includes(code))
+        throw new Error("wake acceptance record is invalid");
+    // `accepted` is the one non-terminal state a record can be arrived at FROM an ended
+    // execution: the dispatcher returns an undisposed delivery there for restart, and the
+    // outcome that returned it is the only account of why. `running` and `completed` still
+    // refuse a code, where one would be nonsense rather than evidence.
+    if ((state === "running" || state === "completed") && code !== undefined)
+        throw new Error("wake acceptance record is invalid");
+    if ((state === "failed" || state === "stopped") && code === undefined)
+        throw new Error("wake acceptance record is invalid");
+    if ((state !== "completed" && state !== "failed" && completionText !== undefined) || completionText !== record.text)
+        throw new Error("wake acceptance record is invalid");
+    if (string(record.request_digest) !== wakeAcceptanceDigest(parsed) || !uuid(string(record.acceptance_id)))
+        throw new Error("wake acceptance record is invalid");
+    return { acceptance_id: string(record.acceptance_id), agent_id: parsed.agent_id, delivery_id: parsed.delivery_id, request_digest: string(record.request_digest), event: parsed.event, state, accepted_at: timestamp(record.accepted_at), updated_at: timestamp(record.updated_at), ...(claimGeneration === undefined ? {} : { claim_generation: claimGeneration }), ...(executionId === undefined ? {} : { execution_id: executionId }), ...(record.deferred === undefined ? {} : { deferred: record.deferred }), ...(code === undefined ? {} : { code }), ...(completionText === undefined ? {} : { text: completionText }), ...(executionError === undefined ? {} : { execution_error: executionError }) };
+}
+function string(value) { if (typeof value !== "string")
+    throw new Error("wake acceptance record is invalid"); return value; }
+function timestamp(value) { const result = string(value); if (Number.isNaN(Date.parse(result)) || new Date(result).toISOString() !== result)
+    throw new Error("wake acceptance record is invalid"); return result; }
+function uuid(value) { return /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/iu.test(value); }
+const MAX_EXECUTION_ERROR_BYTES = 2048;
+/** Private failure diagnostic, surfaced through the existing availability error. */
+export function sanitizeExecutionError(value) {
+    return redactCredentialText(value, [], MAX_EXECUTION_ERROR_BYTES).trim();
+}

package/dist/runtime/wakeAcceptanceRetention.d.ts

@@ -0,0 +1,12 @@
+export declare const TERMINAL_RECEIPT_IDEMPOTENCY_HORIZON = 2048;
+export declare const WAKE_ACCEPTANCE_COMPACTION_THRESHOLD = 2112;
+export declare const MAX_WAKE_ACCEPTANCE_RECORDS = 2176;
+export type RetentionCandidate = Readonly<{
+    file: string;
+    state: "accepted" | "running" | "completed" | "failed" | "stopped";
+    updatedAt: string;
+    acceptanceId: string;
+}>;
+/** Active work is never eligible; the newest terminal receipt horizon survives. */
+export declare function terminalFilesToCompact(records: readonly RetentionCandidate[]): readonly string[];
+//# sourceMappingURL=wakeAcceptanceRetention.d.ts.map

package/dist/runtime/wakeAcceptanceRetention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wakeAcceptanceRetention.d.ts","sourceRoot":"","sources":["../../src/runtime/wakeAcceptanceRetention.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oCAAoC,OAAQ,CAAC;AAC1D,eAAO,MAAM,oCAAoC,OAAQ,CAAC;AAC1D,eAAO,MAAM,2BAA2B,OAAQ,CAAC;AAEjD,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC,CAAC;AAEH,mFAAmF;AACnF,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,GAAG,SAAS,MAAM,EAAE,CAMhG"}

package/dist/runtime/wakeAcceptanceRetention.js

@@ -0,0 +1,12 @@
+export const TERMINAL_RECEIPT_IDEMPOTENCY_HORIZON = 2_048;
+export const WAKE_ACCEPTANCE_COMPACTION_THRESHOLD = 2_112;
+export const MAX_WAKE_ACCEPTANCE_RECORDS = 2_176;
+/** Active work is never eligible; the newest terminal receipt horizon survives. */
+export function terminalFilesToCompact(records) {
+    if (records.length < WAKE_ACCEPTANCE_COMPACTION_THRESHOLD)
+        return [];
+    const terminal = records
+        .filter((record) => record.state === "completed" || record.state === "failed" || record.state === "stopped")
+        .sort((left, right) => right.updatedAt.localeCompare(left.updatedAt) || right.acceptanceId.localeCompare(left.acceptanceId));
+    return terminal.slice(TERMINAL_RECEIPT_IDEMPOTENCY_HORIZON).map((record) => record.file);
+}

package/dist/runtime/wakeAcceptanceStore.d.ts

@@ -0,0 +1,113 @@
+import { type TransitionLock } from "./wakeAcceptanceProcessIdentity.js";
+import { type OrganizationRuntimeWakeAcceptanceRequest, type OrganizationRuntimeWakeReceiptStatus, type WakeReceiptCode, type WakeReceiptState } from "./wakeAcceptanceTypes.js";
+import { type StoredWakeAcceptanceRecord } from "./wakeAcceptanceRecord.js";
+type Stored = StoredWakeAcceptanceRecord;
+type ActivityRow = OrganizationRuntimeWakeReceiptStatus & Readonly<{
+    active: boolean;
+    queue_position?: number;
+    execution_error?: string;
+}>;
+export type WakeExecutionClaim = Readonly<{
+    acceptance_id: string;
+    owner_id: string;
+    generation: string;
+    expires_at: string;
+    acceptance_ids?: readonly string[];
+    execution_id?: string;
+}>;
+export type WakeExecutionClaimResult = Readonly<{
+    state: "acquired";
+    claim: WakeExecutionClaim;
+}> | Readonly<{
+    state: "held";
+    retry_at: string;
+}> | Readonly<{
+    state: "terminal";
+}>;
+export type WakeAcceptanceStoreTestOptions = Readonly<{
+    claimTtlMs?: number;
+    afterFinalLockAssertion?: () => Promise<void>;
+    nowForTest?: () => number;
+    ownerLiveness?: (lock: TransitionLock) => Promise<boolean>;
+    processIdentity?: () => Promise<Omit<TransitionLock, "owner_id" | "generation">>;
+}>;
+/** Durable, private idempotency authority; callers must pre-create its 0700 root. */
+export declare class WakeAcceptanceStore {
+    private readonly root;
+    private readonly directory;
+    private readonly identity;
+    private readonly registration;
+    private readonly claimTtlMs;
+    private readonly now;
+    private readonly owner;
+    private readonly ownerLiveness;
+    private readonly afterFinalLockAssertion?;
+    private mutations;
+    private readonly acceptanceFiles;
+    private constructor();
+    static open(root: string, options?: WakeAcceptanceStoreTestOptions): Promise<WakeAcceptanceStore>;
+    accept(request: OrganizationRuntimeWakeAcceptanceRequest): Promise<{
+        readonly record: Stored;
+        readonly created: boolean;
+    }>;
+    private acceptNow;
+    status(acceptanceId: string): Promise<OrganizationRuntimeWakeReceiptStatus | undefined>;
+    activity(): Promise<readonly Omit<ActivityRow, "execution_error">[]>;
+    /** Internal availability view; diagnostics never enter the public receipt wire. */
+    activityWithExecutionErrors(): Promise<readonly ActivityRow[]>;
+    private activityRows;
+    recoverable(agentIds: ReadonlySet<string>): Promise<readonly Stored[]>;
+    transition(acceptanceId: string, state: WakeReceiptState, code?: WakeReceiptCode): Promise<Stored>;
+    /** Fuse race seam: never stops a record that was claimed after enumeration. */
+    transitionAcceptedToStopped(acceptanceId: string): Promise<Stored>;
+    acquireClaim(acceptanceId: string, ownerId: string, acceptanceIds?: readonly string[], executionId?: string): Promise<WakeExecutionClaimResult>;
+    claimHeartbeatIntervalMs(): number;
+    renewClaim(acceptanceId: string, claim: WakeExecutionClaim): Promise<WakeExecutionClaim>;
+    /** `text` carries the completion output on success and the engine failure cause on failure. */
+    transitionClaimed(acceptanceId: string, claim: WakeExecutionClaim, state: WakeReceiptState, code?: WakeReceiptCode, completedText?: string, attention?: {
+        execution_id?: string;
+        deferred?: boolean;
+        clear_execution?: boolean;
+        execution_error?: string | null;
+    }): Promise<Stored>;
+    releaseClaim(claim: WakeExecutionClaim): Promise<void>;
+    releaseClaims(ownerId: string): Promise<void>;
+    private transitionNow;
+    close(): Promise<void>;
+    private serialize;
+    private findByAcceptanceId;
+    private pathForAcceptanceId;
+    private claimFor;
+    private lockFor;
+    private acquireTransitionLock;
+    private assertTransitionLock;
+    private releaseTransitionLock;
+    private fileFor;
+    private files;
+    private claimFiles;
+    private readOptional;
+    private read;
+    private readClaimOptional;
+    private readClaim;
+    private readLockOptional;
+    private readLock;
+    private transitionNowClaimed;
+    private compactTerminalRecords;
+    private writeNew;
+    private replace;
+    private replaceValue;
+    private verify;
+}
+export declare class WakeInboxFullError extends Error {
+    constructor();
+}
+export declare class WakeAcceptanceConflictError extends Error {
+    constructor();
+}
+export declare class WakeExecutionClaimLostError extends Error {
+    constructor();
+}
+/** A container boundary requires deployment-authorized offline reconciliation. */
+export { WakeTransitionLockBlockedError } from "./wakeAcceptanceProcessIdentity.js";
+export { publicAcceptance } from "./wakeAcceptanceRecord.js";
+//# sourceMappingURL=wakeAcceptanceStore.d.ts.map

package/dist/runtime/wakeAcceptanceStore.d.ts.map

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