@voyant-travel/action-ledger 0.104.10

package/dist/service/types.d.ts

@@ -0,0 +1,249 @@
+import type { ActionApproval, ActionDelegation, ActionLedgerEntry, ActionLedgerPayload, ActionLedgerRelayOutbox, ActionMutationDetail, ActionSensitiveReadDetail, NewActionLedgerEntry, NewActionLedgerPayload, NewActionMutationDetail, NewActionSensitiveReadDetail } from "../schema.js";
+export interface AppendActionLedgerEntryInput extends Omit<NewActionLedgerEntry, "id" | "createdAt" | "occurredAt"> {
+    occurredAt?: Date;
+    mutationDetail?: Omit<NewActionMutationDetail, "actionId">;
+    sensitiveReadDetail?: Omit<NewActionSensitiveReadDetail, "actionId">;
+    payloads?: Omit<NewActionLedgerPayload, "id" | "actionId">[];
+    enqueueRelay?: boolean | {
+        payloadRef?: string | null;
+    };
+}
+export interface AppendActionLedgerEntryResult {
+    entry: ActionLedgerEntry;
+    replayed: boolean;
+}
+export interface RequestActionApprovalInput {
+    requestedAction: Omit<AppendActionLedgerEntryInput, "approvalId" | "status">;
+    approval: {
+        requestedByPrincipalId?: string | null;
+        assignedToPrincipalId?: string | null;
+        delegatedFromPrincipalId?: string | null;
+        policyName: string;
+        policyVersion: string;
+        targetSnapshotRef?: string | null;
+        riskSnapshot?: ActionApproval["riskSnapshot"] | null;
+        reasonCode?: string | null;
+        expiresAt?: Date | string | null;
+    };
+}
+export interface RequestActionApprovalResult {
+    requestedAction: ActionLedgerEntry;
+    approval: ActionApproval;
+    replayed: boolean;
+}
+export type ApprovalDecisionStatus = Exclude<ActionApproval["status"], "pending">;
+export interface DecideActionApprovalInput {
+    id: string;
+    status: ApprovalDecisionStatus;
+    decidedByPrincipalId: string;
+    decidedAt?: Date | string | null;
+    decisionAction: Omit<AppendActionLedgerEntryInput, "actionKind" | "approvalId" | "causationActionId" | "evaluatedRisk" | "status" | "targetId" | "targetType"> & Partial<Pick<AppendActionLedgerEntryInput, "actionKind" | "evaluatedRisk" | "status" | "targetId" | "targetType">>;
+}
+export interface DecideActionApprovalResult {
+    approval: ActionApproval;
+    decisionAction: ActionLedgerEntry;
+}
+type ActionLedgerReversalState = NonNullable<ActionMutationDetail["reversalStateProjection"]>;
+type ActionLedgerReversalOutcome = NonNullable<ActionMutationDetail["reversalOutcomeProjection"]>;
+export interface RecordActionLedgerReversalInput {
+    originalActionId: string;
+    reversalAction: Omit<AppendActionLedgerEntryInput, "causationActionId" | "mutationDetail"> & {
+        mutationDetail?: Omit<NewActionMutationDetail, "actionId" | "reversesActionId">;
+    };
+    projection?: {
+        reversalState?: ActionLedgerReversalState | null;
+        reversalOutcome?: ActionLedgerReversalOutcome | null;
+    };
+}
+export interface RecordActionLedgerReversalResult {
+    originalAction: ActionLedgerEntry;
+    originalMutationDetail: ActionMutationDetail;
+    reversalAction: ActionLedgerEntry;
+    replayed: boolean;
+}
+export interface ActionLedgerListCursor {
+    occurredAt: string;
+    id: string;
+}
+export interface ActionLedgerRelayOutboxListCursor {
+    createdAt: string;
+    id: string;
+}
+export interface ActionApprovalListCursor {
+    createdAt: string;
+    id: string;
+}
+export interface ActionDelegationListCursor {
+    createdAt: string;
+    id: string;
+}
+export interface ListActionLedgerEntriesInput {
+    actionName?: string | null;
+    actionKind?: ActionLedgerEntry["actionKind"];
+    actorType?: string | null;
+    principalType?: ActionLedgerEntry["principalType"];
+    principalId?: string | null;
+    apiTokenId?: string | null;
+    sessionId?: string | null;
+    callerType?: string | null;
+    organizationId?: string | null;
+    targetType?: string | null;
+    targetId?: string | null;
+    targetIds?: string[] | null;
+    routeOrToolName?: string | null;
+    workflowRunId?: string | null;
+    workflowStepId?: string | null;
+    correlationId?: string | null;
+    causationActionId?: string | null;
+    capabilityId?: string | null;
+    capabilityVersion?: string | null;
+    authorizationSource?: string | null;
+    approvalId?: string | null;
+    amendsActionId?: string | null;
+    idempotencyScope?: string | null;
+    idempotencyKey?: string | null;
+    evaluatedRisk?: ActionLedgerEntry["evaluatedRisk"] | ActionLedgerEntry["evaluatedRisk"][];
+    status?: ActionLedgerEntry["status"] | ActionLedgerEntry["status"][];
+    reversalKind?: ActionMutationDetail["reversalKind"] | ActionMutationDetail["reversalKind"][];
+    reversalState?: NonNullable<ActionMutationDetail["reversalStateProjection"]> | NonNullable<ActionMutationDetail["reversalStateProjection"]>[];
+    reversalOutcome?: NonNullable<ActionMutationDetail["reversalOutcomeProjection"]> | NonNullable<ActionMutationDetail["reversalOutcomeProjection"]>[];
+    reversesActionId?: string | null;
+    reversedByActionId?: string | null;
+    sensitiveReasonCode?: string | null;
+    decisionPolicy?: string | null;
+    occurredAtFrom?: Date | string | null;
+    occurredAtTo?: Date | string | null;
+    cursor?: ActionLedgerListCursor | null;
+    sortDir?: "asc" | "desc";
+    limit?: number;
+}
+export interface ListActionLedgerEntriesResult {
+    entries: ActionLedgerEntry[];
+    nextCursor: ActionLedgerListCursor | null;
+}
+export interface ListActionLedgerRelayOutboxInput {
+    actionId?: string | null;
+    organizationId?: string | null;
+    relayStatus?: ActionLedgerRelayOutbox["relayStatus"] | ActionLedgerRelayOutbox["relayStatus"][];
+    dueBefore?: Date | string | null;
+    createdAtFrom?: Date | string | null;
+    createdAtTo?: Date | string | null;
+    processedAtFrom?: Date | string | null;
+    processedAtTo?: Date | string | null;
+    cursor?: ActionLedgerRelayOutboxListCursor | null;
+    limit?: number;
+}
+export interface ListActionLedgerRelayOutboxResult {
+    rows: ActionLedgerRelayOutbox[];
+    nextCursor: ActionLedgerRelayOutboxListCursor | null;
+}
+export interface ListActionApprovalsInput {
+    requestedActionId?: string | null;
+    status?: ActionApproval["status"] | ActionApproval["status"][];
+    requestedByPrincipalId?: string | null;
+    assignedToPrincipalId?: string | null;
+    decidedByPrincipalId?: string | null;
+    delegatedFromPrincipalId?: string | null;
+    policyName?: string | null;
+    policyVersion?: string | null;
+    riskSnapshot?: ActionApproval["riskSnapshot"] | ActionApproval["riskSnapshot"][];
+    reasonCode?: string | null;
+    expiresAtFrom?: Date | string | null;
+    expiresAtTo?: Date | string | null;
+    decidedAtFrom?: Date | string | null;
+    decidedAtTo?: Date | string | null;
+    createdAtFrom?: Date | string | null;
+    createdAtTo?: Date | string | null;
+    cursor?: ActionApprovalListCursor | null;
+    limit?: number;
+}
+export interface ListActionApprovalsResult {
+    approvals: ActionApproval[];
+    nextCursor: ActionApprovalListCursor | null;
+}
+export interface ListActionDelegationsInput {
+    rootPrincipalType?: ActionDelegation["rootPrincipalType"];
+    rootPrincipalId?: string | null;
+    parentPrincipalType?: ActionDelegation["parentPrincipalType"];
+    parentPrincipalId?: string | null;
+    childPrincipalType?: ActionDelegation["childPrincipalType"];
+    childPrincipalId?: string | null;
+    grantSource?: string | null;
+    capabilityScopeRef?: string | null;
+    budgetScopeRef?: string | null;
+    expiresAtFrom?: Date | string | null;
+    expiresAtTo?: Date | string | null;
+    createdAtFrom?: Date | string | null;
+    createdAtTo?: Date | string | null;
+    cursor?: ActionDelegationListCursor | null;
+    limit?: number;
+}
+export interface ListActionDelegationsResult {
+    delegations: ActionDelegation[];
+    nextCursor: ActionDelegationListCursor | null;
+}
+export interface ClaimActionLedgerRelayOutboxInput {
+    organizationId?: string | null;
+    dueAt?: Date | string | null;
+    limit?: number;
+}
+export interface ClaimActionLedgerRelayOutboxResult {
+    rows: ActionLedgerRelayOutbox[];
+}
+export interface MarkActionLedgerRelayOutboxSucceededInput {
+    id: string;
+    processedAt?: Date | string | null;
+}
+export interface MarkActionLedgerRelayOutboxFailedInput {
+    id: string;
+    lastError: string;
+    nextRetryAt?: Date | string | null;
+    deadLetter?: boolean;
+    processedAt?: Date | string | null;
+}
+export interface GetActionLedgerEntryResult {
+    entry: ActionLedgerEntry;
+    mutationDetail: ActionMutationDetail | null;
+    sensitiveReadDetail: ActionSensitiveReadDetail | null;
+    payloads: ActionLedgerPayload[];
+    relayOutbox: ActionLedgerRelayOutbox[];
+}
+export interface GetActionApprovalResult {
+    approval: ActionApproval;
+    requestedAction: GetActionLedgerEntryResult | null;
+}
+export type ValidateApprovedActionFailureReason = "not_found" | "not_approved" | "expired" | "mismatched_action" | "already_executed" | "missing_fingerprint" | "fingerprint_mismatch" | "principal_mismatch";
+export interface ValidateApprovedActionInput {
+    approvalId: string;
+    actionName: string;
+    actionVersion: string;
+    requestedActionKind?: ActionLedgerEntry["actionKind"] | null;
+    requestedActionStatus?: ActionLedgerEntry["status"] | ActionLedgerEntry["status"][] | null;
+    targetType: string;
+    targetId: string;
+    routeOrToolName?: string | null;
+    principalType?: ActionLedgerEntry["principalType"] | null;
+    principalId?: string | null;
+    idempotencyFingerprint: string;
+    executionActionKind?: ActionLedgerEntry["actionKind"];
+    executionStatus?: ActionLedgerEntry["status"];
+    now?: Date | string | null;
+}
+export type ValidateApprovedActionResult = {
+    ok: true;
+    approval: ActionApproval;
+    requestedAction: ActionLedgerEntry;
+    idempotencyFingerprint: string;
+} | {
+    ok: false;
+    reason: ValidateApprovedActionFailureReason;
+    approval?: ActionApproval;
+    requestedAction?: ActionLedgerEntry;
+    status?: ActionApproval["status"];
+    existingActionId?: string;
+};
+export interface GetActionDelegationResult {
+    delegation: ActionDelegation;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/service/types.d.ts.map

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

package/dist/service/types.js

@@ -0,0 +1 @@
+export {};

package/dist/service.d.ts

@@ -0,0 +1,40 @@
+import type { AnyDrizzleDb } from "@voyant-travel/db";
+import { withOptionalTransaction } from "@voyant-travel/db/transaction";
+import { normalizeListLimit, toActionApprovalListCursor, toActionDelegationListCursor, toActionLedgerListCursor, toActionLedgerRelayOutboxListCursor } from "./service/cursors.js";
+import { listApprovals, listDelegations, listEntries, listRelayOutbox } from "./service/listing.js";
+import { buildActionApprovalsPredicate, buildActionDelegationsPredicate, buildActionLedgerEntriesPredicate, buildActionLedgerRelayOutboxPredicate } from "./service/predicates.js";
+import { getApproval, getDelegation, getEntry } from "./service/records.js";
+import { claimRelayOutbox, markRelayOutboxFailed, markRelayOutboxSucceeded } from "./service/relay-lifecycle.js";
+import type { AppendActionLedgerEntryInput, AppendActionLedgerEntryResult, DecideActionApprovalInput, DecideActionApprovalResult, RecordActionLedgerReversalInput, RecordActionLedgerReversalResult, RequestActionApprovalInput, RequestActionApprovalResult, ValidateApprovedActionInput, ValidateApprovedActionResult } from "./service/types.js";
+export { ActionApprovalDecisionConflictError, ActionApprovalDecisionStatusError, ActionLedgerIdempotencyConflictError, ActionLedgerReversalTargetError, } from "./service/errors.js";
+export type { ActionApprovalListCursor, ActionDelegationListCursor, ActionLedgerListCursor, ActionLedgerRelayOutboxListCursor, AppendActionLedgerEntryInput, AppendActionLedgerEntryResult, ClaimActionLedgerRelayOutboxInput, ClaimActionLedgerRelayOutboxResult, DecideActionApprovalInput, DecideActionApprovalResult, GetActionApprovalResult, GetActionDelegationResult, GetActionLedgerEntryResult, ListActionApprovalsInput, ListActionApprovalsResult, ListActionDelegationsInput, ListActionDelegationsResult, ListActionLedgerEntriesInput, ListActionLedgerEntriesResult, ListActionLedgerRelayOutboxInput, ListActionLedgerRelayOutboxResult, MarkActionLedgerRelayOutboxFailedInput, MarkActionLedgerRelayOutboxSucceededInput, RecordActionLedgerReversalInput, RecordActionLedgerReversalResult, RequestActionApprovalInput, RequestActionApprovalResult, ValidateApprovedActionFailureReason, ValidateApprovedActionInput, ValidateApprovedActionResult, } from "./service/types.js";
+export declare const actionLedgerService: {
+    appendEntry(db: AnyDrizzleDb, input: AppendActionLedgerEntryInput): Promise<AppendActionLedgerEntryResult>;
+    requestApproval(db: AnyDrizzleDb, input: RequestActionApprovalInput): Promise<RequestActionApprovalResult>;
+    decideApproval(db: AnyDrizzleDb, input: DecideActionApprovalInput): Promise<DecideActionApprovalResult | null>;
+    recordReversal(db: AnyDrizzleDb, input: RecordActionLedgerReversalInput): Promise<RecordActionLedgerReversalResult | null>;
+    listEntries: typeof listEntries;
+    listRelayOutbox: typeof listRelayOutbox;
+    listApprovals: typeof listApprovals;
+    listDelegations: typeof listDelegations;
+    getApproval: typeof getApproval;
+    validateApprovedAction(db: AnyDrizzleDb, input: ValidateApprovedActionInput): Promise<ValidateApprovedActionResult>;
+    getDelegation: typeof getDelegation;
+    claimRelayOutbox: typeof claimRelayOutbox;
+    markRelayOutboxSucceeded: typeof markRelayOutboxSucceeded;
+    markRelayOutboxFailed: typeof markRelayOutboxFailed;
+    getEntry: typeof getEntry;
+};
+export declare const __test__: {
+    buildActionApprovalsPredicate: typeof buildActionApprovalsPredicate;
+    buildActionDelegationsPredicate: typeof buildActionDelegationsPredicate;
+    buildActionLedgerEntriesPredicate: typeof buildActionLedgerEntriesPredicate;
+    buildActionLedgerRelayOutboxPredicate: typeof buildActionLedgerRelayOutboxPredicate;
+    withOptionalTransaction: typeof withOptionalTransaction;
+    normalizeListLimit: typeof normalizeListLimit;
+    toActionApprovalListCursor: typeof toActionApprovalListCursor;
+    toActionDelegationListCursor: typeof toActionDelegationListCursor;
+    toActionLedgerListCursor: typeof toActionLedgerListCursor;
+    toActionLedgerRelayOutboxListCursor: typeof toActionLedgerRelayOutboxListCursor;
+};
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAA;AAKvE,OAAO,EACL,kBAAkB,EAElB,0BAA0B,EAC1B,4BAA4B,EAC5B,wBAAwB,EACxB,mCAAmC,EACpC,MAAM,sBAAsB,CAAA;AAY7B,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACnG,OAAO,EACL,6BAA6B,EAC7B,+BAA+B,EAC/B,iCAAiC,EACjC,qCAAqC,EACtC,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAC3E,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,EACzB,MAAM,8BAA8B,CAAA;AACrC,OAAO,KAAK,EACV,4BAA4B,EAC5B,6BAA6B,EAC7B,yBAAyB,EACzB,0BAA0B,EAC1B,+BAA+B,EAC/B,gCAAgC,EAChC,0BAA0B,EAC1B,2BAA2B,EAC3B,2BAA2B,EAC3B,4BAA4B,EAC7B,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EACL,mCAAmC,EACnC,iCAAiC,EACjC,oCAAoC,EACpC,+BAA+B,GAChC,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,sBAAsB,EACtB,iCAAiC,EACjC,4BAA4B,EAC5B,6BAA6B,EAC7B,iCAAiC,EACjC,kCAAkC,EAClC,yBAAyB,EACzB,0BAA0B,EAC1B,uBAAuB,EACvB,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC1B,2BAA2B,EAC3B,4BAA4B,EAC5B,6BAA6B,EAC7B,gCAAgC,EAChC,iCAAiC,EACjC,sCAAsC,EACtC,yCAAyC,EACzC,+BAA+B,EAC/B,gCAAgC,EAChC,0BAA0B,EAC1B,2BAA2B,EAC3B,mCAAmC,EACnC,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,oBAAoB,CAAA;AAE3B,eAAO,MAAM,mBAAmB;oBAExB,YAAY,SACT,4BAA4B,GAClC,OAAO,CAAC,6BAA6B,CAAC;wBAoBnC,YAAY,SACT,0BAA0B,GAChC,OAAO,CAAC,2BAA2B,CAAC;uBAuDjC,YAAY,SACT,yBAAyB,GAC/B,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC;uBA8CvC,YAAY,SACT,+BAA+B,GACrC,OAAO,CAAC,gCAAgC,GAAG,IAAI,CAAC;;;;;;+BAiE7C,YAAY,SACT,2BAA2B,GACjC,OAAO,CAAC,4BAA4B,CAAC;;;;;;CAoHzC,CAAA;AAED,eAAO,MAAM,QAAQ;;;;;;;;;;;CAWpB,CAAA"}

package/dist/service.js

@@ -0,0 +1,283 @@
+import { newId } from "@voyant-travel/db/lib/typeid";
+import { withOptionalTransaction } from "@voyant-travel/db/transaction";
+import { and, eq } from "drizzle-orm";
+import { actionApprovals, actionMutationDetails } from "./schema.js";
+import { assertApprovalDecisionStatus } from "./service/approval-status.js";
+import { normalizeListLimit, parseCursorDate, toActionApprovalListCursor, toActionDelegationListCursor, toActionLedgerListCursor, toActionLedgerRelayOutboxListCursor, } from "./service/cursors.js";
+import { assertSameFingerprint, findApprovalById, findApprovalForRequestedAction, findExistingIdempotentEntry, insertEntry, } from "./service/entries.js";
+import { ActionApprovalDecisionConflictError, ActionLedgerReversalTargetError, } from "./service/errors.js";
+import { listApprovals, listDelegations, listEntries, listRelayOutbox } from "./service/listing.js";
+import { buildActionApprovalsPredicate, buildActionDelegationsPredicate, buildActionLedgerEntriesPredicate, buildActionLedgerRelayOutboxPredicate, } from "./service/predicates.js";
+import { getApproval, getDelegation, getEntry } from "./service/records.js";
+import { claimRelayOutbox, markRelayOutboxFailed, markRelayOutboxSucceeded, } from "./service/relay-lifecycle.js";
+export { ActionApprovalDecisionConflictError, ActionApprovalDecisionStatusError, ActionLedgerIdempotencyConflictError, ActionLedgerReversalTargetError, } from "./service/errors.js";
+export const actionLedgerService = {
+    async appendEntry(db, input) {
+        const existing = await findExistingIdempotentEntry(db, input);
+        if (existing) {
+            assertSameFingerprint(existing, input.idempotencyFingerprint ?? null);
+            return { entry: existing, replayed: true };
+        }
+        try {
+            return await withOptionalTransaction(db, (tx) => insertEntry(tx, input));
+        }
+        catch (error) {
+            const racedExisting = await findExistingIdempotentEntry(db, input);
+            if (racedExisting) {
+                assertSameFingerprint(racedExisting, input.idempotencyFingerprint ?? null);
+                return { entry: racedExisting, replayed: true };
+            }
+            throw error;
+        }
+    },
+    async requestApproval(db, input) {
+        return withOptionalTransaction(db, async (tx) => {
+            const approvalId = newId("action_approvals");
+            const requestedActionResult = await actionLedgerService.appendEntry(tx, {
+                ...input.requestedAction,
+                status: "awaiting_approval",
+                approvalId,
+            });
+            if (!requestedActionResult.entry.approvalId) {
+                throw new Error("Action approval requested action is missing its approval id");
+            }
+            const existingApproval = await findApprovalForRequestedAction(tx, requestedActionResult.entry.id);
+            if (existingApproval) {
+                return {
+                    requestedAction: requestedActionResult.entry,
+                    approval: existingApproval,
+                    replayed: requestedActionResult.replayed,
+                };
+            }
+            const [approval] = await tx
+                .insert(actionApprovals)
+                .values({
+                id: requestedActionResult.entry.approvalId,
+                requestedActionId: requestedActionResult.entry.id,
+                status: "pending",
+                requestedByPrincipalId: input.approval.requestedByPrincipalId ?? requestedActionResult.entry.principalId,
+                assignedToPrincipalId: input.approval.assignedToPrincipalId ?? null,
+                delegatedFromPrincipalId: input.approval.delegatedFromPrincipalId ?? null,
+                policyName: input.approval.policyName,
+                policyVersion: input.approval.policyVersion,
+                targetSnapshotRef: input.approval.targetSnapshotRef ?? null,
+                riskSnapshot: input.approval.riskSnapshot ?? requestedActionResult.entry.evaluatedRisk,
+                reasonCode: input.approval.reasonCode ?? null,
+                expiresAt: input.approval.expiresAt ? parseCursorDate(input.approval.expiresAt) : null,
+            })
+                .returning();
+            if (!approval) {
+                throw new Error("Action approval insert did not return an approval");
+            }
+            return {
+                requestedAction: requestedActionResult.entry,
+                approval,
+                replayed: requestedActionResult.replayed,
+            };
+        });
+    },
+    async decideApproval(db, input) {
+        assertApprovalDecisionStatus(input.status);
+        return withOptionalTransaction(db, async (tx) => {
+            const approval = await findApprovalById(tx, input.id);
+            if (!approval)
+                return null;
+            if (approval.status !== "pending") {
+                throw new ActionApprovalDecisionConflictError(approval.id, approval.status);
+            }
+            const decidedAt = input.decidedAt ? parseCursorDate(input.decidedAt) : new Date();
+            const [updatedApproval] = await tx
+                .update(actionApprovals)
+                .set({
+                status: input.status,
+                decidedByPrincipalId: input.decidedByPrincipalId,
+                decidedAt,
+            })
+                .where(and(eq(actionApprovals.id, input.id), eq(actionApprovals.status, "pending")))
+                .returning();
+            if (!updatedApproval) {
+                const current = await findApprovalById(tx, input.id);
+                if (!current)
+                    return null;
+                throw new ActionApprovalDecisionConflictError(current.id, current.status);
+            }
+            const decisionAction = await actionLedgerService.appendEntry(tx, {
+                ...input.decisionAction,
+                actionKind: input.status === "approved" ? "approve" : "reject",
+                status: input.status,
+                evaluatedRisk: input.decisionAction.evaluatedRisk ?? updatedApproval.riskSnapshot,
+                targetType: input.decisionAction.targetType ?? "action_approval",
+                targetId: input.decisionAction.targetId ?? updatedApproval.id,
+                causationActionId: updatedApproval.requestedActionId,
+                approvalId: updatedApproval.id,
+            });
+            return {
+                approval: updatedApproval,
+                decisionAction: decisionAction.entry,
+            };
+        });
+    },
+    async recordReversal(db, input) {
+        return withOptionalTransaction(db, async (tx) => {
+            const original = await actionLedgerService.getEntry(tx, input.originalActionId);
+            if (!original)
+                return null;
+            if (!original.mutationDetail) {
+                throw new ActionLedgerReversalTargetError(input.originalActionId, "missing_mutation_detail");
+            }
+            if (original.mutationDetail.reversalKind === "none") {
+                throw new ActionLedgerReversalTargetError(input.originalActionId, "not_reversible");
+            }
+            const reversalResult = await actionLedgerService.appendEntry(tx, {
+                ...input.reversalAction,
+                causationActionId: original.entry.id,
+                mutationDetail: {
+                    commandInputRef: input.reversalAction.mutationDetail?.commandInputRef ?? null,
+                    commandResultRef: input.reversalAction.mutationDetail?.commandResultRef ?? null,
+                    summary: input.reversalAction.mutationDetail?.summary ?? null,
+                    reversalKind: input.reversalAction.mutationDetail?.reversalKind ?? "none",
+                    reversalCommandId: input.reversalAction.mutationDetail?.reversalCommandId ?? null,
+                    reversalCommandVersion: input.reversalAction.mutationDetail?.reversalCommandVersion ?? null,
+                    reversalArgsRef: input.reversalAction.mutationDetail?.reversalArgsRef ?? null,
+                    reversalStateProjection: input.reversalAction.mutationDetail?.reversalStateProjection ?? null,
+                    reversalOutcomeProjection: input.reversalAction.mutationDetail?.reversalOutcomeProjection ?? null,
+                    reversesActionId: original.entry.id,
+                    reversedByActionIdProjection: input.reversalAction.mutationDetail?.reversedByActionIdProjection ?? null,
+                },
+            });
+            const defaultProjection = input.reversalAction.status === "failed"
+                ? { reversalState: "failed", reversalOutcome: "failed" }
+                : { reversalState: "completed", reversalOutcome: "full" };
+            await tx
+                .update(actionMutationDetails)
+                .set({
+                reversalStateProjection: input.projection?.reversalState ?? defaultProjection.reversalState,
+                reversalOutcomeProjection: input.projection?.reversalOutcome ?? defaultProjection.reversalOutcome,
+                reversedByActionIdProjection: reversalResult.entry.id,
+            })
+                .where(eq(actionMutationDetails.actionId, original.entry.id));
+            return {
+                originalAction: original.entry,
+                originalMutationDetail: original.mutationDetail,
+                reversalAction: reversalResult.entry,
+                replayed: reversalResult.replayed,
+            };
+        });
+    },
+    listEntries,
+    listRelayOutbox,
+    listApprovals,
+    listDelegations,
+    getApproval,
+    async validateApprovedAction(db, input) {
+        const result = await actionLedgerService.getApproval(db, input.approvalId);
+        if (!result) {
+            return { ok: false, reason: "not_found" };
+        }
+        if (result.approval.status !== "approved") {
+            return {
+                ok: false,
+                reason: "not_approved",
+                approval: result.approval,
+                status: result.approval.status,
+            };
+        }
+        const now = input.now ? parseCursorDate(input.now) : new Date();
+        if (result.approval.expiresAt && result.approval.expiresAt < now) {
+            return {
+                ok: false,
+                reason: "expired",
+                approval: result.approval,
+            };
+        }
+        const requestedAction = result.requestedAction?.entry;
+        if (!requestedAction ||
+            requestedAction.actionName !== input.actionName ||
+            requestedAction.actionVersion !== input.actionVersion ||
+            (input.requestedActionKind && requestedAction.actionKind !== input.requestedActionKind) ||
+            (input.requestedActionStatus &&
+                !(Array.isArray(input.requestedActionStatus)
+                    ? input.requestedActionStatus
+                    : [input.requestedActionStatus]).includes(requestedAction.status)) ||
+            requestedAction.targetType !== input.targetType ||
+            requestedAction.targetId !== input.targetId ||
+            requestedAction.routeOrToolName !== (input.routeOrToolName ?? null) ||
+            requestedAction.approvalId !== result.approval.id) {
+            return {
+                ok: false,
+                reason: "mismatched_action",
+                approval: result.approval,
+                requestedAction: requestedAction ?? undefined,
+            };
+        }
+        const existingExecution = await actionLedgerService.listEntries(db, {
+            actionName: input.actionName,
+            actionKind: input.executionActionKind,
+            targetType: input.targetType,
+            targetId: input.targetId,
+            causationActionId: requestedAction.id,
+            approvalId: result.approval.id,
+            status: input.executionStatus ?? "succeeded",
+            limit: 1,
+        });
+        if (existingExecution.entries.length > 0) {
+            return {
+                ok: false,
+                reason: "already_executed",
+                approval: result.approval,
+                requestedAction,
+                existingActionId: existingExecution.entries[0]?.id,
+            };
+        }
+        if (!requestedAction.idempotencyFingerprint) {
+            return {
+                ok: false,
+                reason: "missing_fingerprint",
+                approval: result.approval,
+                requestedAction,
+            };
+        }
+        if (input.idempotencyFingerprint !== requestedAction.idempotencyFingerprint) {
+            return {
+                ok: false,
+                reason: "fingerprint_mismatch",
+                approval: result.approval,
+                requestedAction,
+            };
+        }
+        if (input.principalType &&
+            input.principalId &&
+            (requestedAction.principalType !== input.principalType ||
+                requestedAction.principalId !== input.principalId)) {
+            return {
+                ok: false,
+                reason: "principal_mismatch",
+                approval: result.approval,
+                requestedAction,
+            };
+        }
+        return {
+            ok: true,
+            approval: result.approval,
+            requestedAction,
+            idempotencyFingerprint: requestedAction.idempotencyFingerprint,
+        };
+    },
+    getDelegation,
+    claimRelayOutbox,
+    markRelayOutboxSucceeded,
+    markRelayOutboxFailed,
+    getEntry,
+};
+export const __test__ = {
+    buildActionApprovalsPredicate,
+    buildActionDelegationsPredicate,
+    buildActionLedgerEntriesPredicate,
+    buildActionLedgerRelayOutboxPredicate,
+    withOptionalTransaction,
+    normalizeListLimit,
+    toActionApprovalListCursor,
+    toActionDelegationListCursor,
+    toActionLedgerListCursor,
+    toActionLedgerRelayOutboxListCursor,
+};

package/dist/timeline.d.ts

@@ -0,0 +1,67 @@
+import { z } from "zod";
+import type { ActionLedgerEntry } from "./schema.js";
+export type ActionLedgerTimelineCursor = {
+    occurredAt: string;
+    id: string;
+};
+export type ActionLedgerSerializedEntry = Omit<ActionLedgerEntry, "occurredAt" | "createdAt"> & {
+    occurredAt: string;
+    createdAt: string;
+};
+export type ActionLedgerTargetTimelineEntry = ActionLedgerSerializedEntry & {
+    mutationSummary: string | null;
+};
+export interface ActionLedgerTargetTimelinePage {
+    data: ActionLedgerTargetTimelineEntry[];
+    pageInfo: {
+        nextCursor: ActionLedgerTimelineCursor | null;
+    };
+}
+export declare const actionLedgerTargetTimelineQuerySchema: z.ZodPipe<z.ZodObject<{
+    cursorOccurredAt: z.ZodOptional<z.ZodString>;
+    cursorId: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>, z.ZodTransform<{
+    cursor: {
+        occurredAt: string;
+        id: string;
+    } | undefined;
+    limit?: number | undefined;
+}, {
+    cursorOccurredAt?: string | undefined;
+    cursorId?: string | undefined;
+    limit?: number | undefined;
+}>>;
+export type ActionLedgerTargetTimelineQuery = z.infer<typeof actionLedgerTargetTimelineQuerySchema>;
+export declare function serializeActionLedgerDate(value: Date | string): string;
+export declare function serializeActionLedgerEntry(entry: ActionLedgerEntry): ActionLedgerSerializedEntry;
+export declare function toActionLedgerTimelineCursor(entry: Pick<ActionLedgerEntry, "occurredAt" | "id">): ActionLedgerTimelineCursor;
+export declare function sortActionLedgerTimelineEntries(entries: ActionLedgerEntry[]): ActionLedgerEntry[];
+export declare function buildActionLedgerTargetTimelinePage({ entries, limit, mutationSummariesByActionId, }: {
+    entries: ActionLedgerEntry[];
+    limit: number;
+    mutationSummariesByActionId?: ReadonlyMap<string, string | null>;
+}): ActionLedgerTargetTimelinePage;
+export declare const __test__: {
+    actionLedgerTargetTimelineQuerySchema: z.ZodPipe<z.ZodObject<{
+        cursorOccurredAt: z.ZodOptional<z.ZodString>;
+        cursorId: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    }, z.core.$strip>, z.ZodTransform<{
+        cursor: {
+            occurredAt: string;
+            id: string;
+        } | undefined;
+        limit?: number | undefined;
+    }, {
+        cursorOccurredAt?: string | undefined;
+        cursorId?: string | undefined;
+        limit?: number | undefined;
+    }>>;
+    buildActionLedgerTargetTimelinePage: typeof buildActionLedgerTargetTimelinePage;
+    serializeActionLedgerDate: typeof serializeActionLedgerDate;
+    serializeActionLedgerEntry: typeof serializeActionLedgerEntry;
+    sortActionLedgerTimelineEntries: typeof sortActionLedgerTimelineEntries;
+    toActionLedgerTimelineCursor: typeof toActionLedgerTimelineCursor;
+};
+//# sourceMappingURL=timeline.d.ts.map