@voyantjs/action-ledger 0.52.2

package/dist/request-context.d.ts.map

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

package/dist/request-context.js

@@ -0,0 +1,237 @@
+import { actionLedgerService } from "./service.js";
+export const ACTION_LEDGER_APPROVAL_ID_HEADER = "action-approval-id";
+export function mapActionLedgerRequestContext(context, options = {}) {
+    const actor = normalizeNullableString(context.actor);
+    const callerType = normalizeNullableString(context.callerType);
+    const userId = normalizeNullableString(context.userId);
+    const agentId = normalizeNullableString(context.agentId);
+    const workflowRunId = normalizeNullableString(context.workflowRunId);
+    const workflowPrincipalId = normalizeNullableString(context.workflowPrincipalId) ?? workflowRunId;
+    const principalSubtype = normalizeNullableString(context.principalSubtype);
+    const sessionId = normalizeNullableString(context.sessionId);
+    const apiTokenId = normalizeNullableString(context.apiTokenId ?? context.apiKeyId);
+    const internalRequest = context.isInternalRequest === true || callerType === "internal";
+    if (apiTokenId && callerType === "api_key") {
+        return {
+            actorType: actor,
+            principalType: "api_key",
+            principalId: apiTokenId,
+            principalSubtype,
+            sessionId,
+            apiTokenId,
+            internalRequest,
+            callerType,
+            organizationId: normalizeNullableString(context.organizationId),
+            workflowRunId,
+            workflowStepId: normalizeNullableString(context.workflowStepId),
+            correlationId: normalizeNullableString(context.correlationId),
+        };
+    }
+    if (agentId && callerType === "agent") {
+        return {
+            actorType: actor,
+            principalType: "agent",
+            principalId: agentId,
+            principalSubtype,
+            sessionId,
+            apiTokenId,
+            internalRequest,
+            callerType,
+            organizationId: normalizeNullableString(context.organizationId),
+            workflowRunId,
+            workflowStepId: normalizeNullableString(context.workflowStepId),
+            correlationId: normalizeNullableString(context.correlationId),
+        };
+    }
+    if (workflowPrincipalId && callerType === "workflow") {
+        return {
+            actorType: actor,
+            principalType: "workflow",
+            principalId: workflowPrincipalId,
+            principalSubtype,
+            sessionId,
+            apiTokenId,
+            internalRequest,
+            callerType,
+            organizationId: normalizeNullableString(context.organizationId),
+            workflowRunId,
+            workflowStepId: normalizeNullableString(context.workflowStepId),
+            correlationId: normalizeNullableString(context.correlationId),
+        };
+    }
+    if (internalRequest) {
+        return {
+            actorType: actor,
+            principalType: "system",
+            principalId: userId ?? apiTokenId ?? options.fallbackPrincipalId ?? "internal_request",
+            principalSubtype,
+            sessionId,
+            apiTokenId,
+            internalRequest,
+            callerType,
+            organizationId: normalizeNullableString(context.organizationId),
+            workflowRunId,
+            workflowStepId: normalizeNullableString(context.workflowStepId),
+            correlationId: normalizeNullableString(context.correlationId),
+        };
+    }
+    return {
+        actorType: actor,
+        principalType: userId ? "user" : "system",
+        principalId: userId ?? options.fallbackPrincipalId ?? "unknown_request",
+        principalSubtype,
+        sessionId,
+        apiTokenId,
+        internalRequest,
+        callerType,
+        organizationId: normalizeNullableString(context.organizationId),
+        workflowRunId,
+        workflowStepId: normalizeNullableString(context.workflowStepId),
+        correlationId: normalizeNullableString(context.correlationId),
+    };
+}
+export function buildActionLedgerSensitiveReadEntryInput(input) {
+    const actorFields = mapActionLedgerRequestContext(input.context, input);
+    return {
+        ...actorFields,
+        actionName: input.actionName,
+        actionVersion: input.actionVersion ?? "v1",
+        actionKind: "read",
+        status: input.status ?? "succeeded",
+        evaluatedRisk: input.evaluatedRisk ?? "high",
+        targetType: input.targetType,
+        targetId: input.targetId,
+        routeOrToolName: input.routeOrToolName ?? null,
+        capabilityId: input.capabilityId ?? null,
+        capabilityVersion: input.capabilityVersion ?? null,
+        authorizationSource: input.authorizationSource ?? null,
+        causationActionId: input.causationActionId ?? null,
+        approvalId: input.approvalId ?? null,
+        idempotencyScope: input.idempotencyScope ?? null,
+        idempotencyKey: input.idempotencyKey ?? null,
+        idempotencyFingerprint: input.idempotencyFingerprint ?? null,
+        payloads: input.payloads,
+        enqueueRelay: input.enqueueRelay,
+        organizationId: input.organizationId ?? actorFields.organizationId,
+        workflowRunId: input.workflowRunId ?? actorFields.workflowRunId,
+        workflowStepId: input.workflowStepId ?? actorFields.workflowStepId,
+        correlationId: input.correlationId ?? actorFields.correlationId,
+        sensitiveReadDetail: {
+            reasonCode: input.reasonCode ?? null,
+            disclosedFieldSet: input.disclosedFieldSet ?? null,
+            disclosureSummary: input.disclosureSummary ?? null,
+            decisionPolicy: input.decisionPolicy ?? null,
+        },
+    };
+}
+export async function appendActionLedgerSensitiveRead(db, input) {
+    return actionLedgerService.appendEntry(db, buildActionLedgerSensitiveReadEntryInput(input));
+}
+export async function ledgerSensitiveRead(db, input, read) {
+    if (typeof input !== "function") {
+        await appendActionLedgerSensitiveRead(db, input);
+        return read();
+    }
+    const value = await read();
+    await appendActionLedgerSensitiveRead(db, input(value));
+    return value;
+}
+export function buildActionLedgerMutationEntryInput(input) {
+    const actorFields = mapActionLedgerRequestContext(input.context, input);
+    return {
+        ...actorFields,
+        actionName: input.actionName,
+        actionVersion: input.actionVersion ?? "v1",
+        actionKind: input.actionKind,
+        status: input.status ?? "succeeded",
+        evaluatedRisk: input.evaluatedRisk ?? "medium",
+        targetType: input.targetType,
+        targetId: input.targetId,
+        routeOrToolName: input.routeOrToolName ?? null,
+        capabilityId: input.capabilityId ?? null,
+        capabilityVersion: input.capabilityVersion ?? null,
+        authorizationSource: input.authorizationSource ?? null,
+        causationActionId: input.causationActionId ?? null,
+        approvalId: input.approvalId ?? null,
+        idempotencyScope: input.idempotencyScope ?? null,
+        idempotencyKey: input.idempotencyKey ?? null,
+        idempotencyFingerprint: input.idempotencyFingerprint ?? null,
+        payloads: input.payloads,
+        enqueueRelay: input.enqueueRelay,
+        organizationId: input.organizationId ?? actorFields.organizationId,
+        workflowRunId: input.workflowRunId ?? actorFields.workflowRunId,
+        workflowStepId: input.workflowStepId ?? actorFields.workflowStepId,
+        correlationId: input.correlationId ?? actorFields.correlationId,
+        mutationDetail: input.mutationDetail,
+    };
+}
+export async function appendActionLedgerMutation(db, input) {
+    return actionLedgerService.appendEntry(db, buildActionLedgerMutationEntryInput(input));
+}
+export function buildActionLedgerApprovalRequestInput(input) {
+    const { status: _status, approvalId: _approvalId, ...requestedAction } = buildActionLedgerMutationEntryInput(input);
+    return {
+        requestedAction,
+        approval: {
+            requestedByPrincipalId: input.approval.requestedByPrincipalId ?? requestedAction.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 ?? requestedAction.evaluatedRisk,
+            reasonCode: input.approval.reasonCode ?? null,
+            expiresAt: input.approval.expiresAt ?? null,
+        },
+    };
+}
+export async function requestActionLedgerApproval(db, input) {
+    return actionLedgerService.requestApproval(db, buildActionLedgerApprovalRequestInput(input));
+}
+export function buildActionLedgerApprovalDecisionInput(input) {
+    const actorFields = mapActionLedgerRequestContext(input.context, input);
+    return {
+        id: input.id,
+        status: input.status,
+        decidedByPrincipalId: input.decidedByPrincipalId ?? actorFields.principalId,
+        decidedAt: input.decidedAt ?? null,
+        decisionAction: {
+            ...actorFields,
+            actionName: input.actionName,
+            actionVersion: input.actionVersion ?? "v1",
+            evaluatedRisk: input.evaluatedRisk,
+            targetType: input.targetType,
+            targetId: input.targetId,
+            routeOrToolName: input.routeOrToolName ?? null,
+            capabilityId: input.capabilityId ?? null,
+            capabilityVersion: input.capabilityVersion ?? null,
+            authorizationSource: input.authorizationSource ?? null,
+            idempotencyScope: input.idempotencyScope ?? null,
+            idempotencyKey: input.idempotencyKey ?? null,
+            idempotencyFingerprint: input.idempotencyFingerprint ?? null,
+            payloads: input.payloads,
+            enqueueRelay: input.enqueueRelay,
+            organizationId: input.organizationId ?? actorFields.organizationId,
+            workflowRunId: input.workflowRunId ?? actorFields.workflowRunId,
+            workflowStepId: input.workflowStepId ?? actorFields.workflowStepId,
+            correlationId: input.correlationId ?? actorFields.correlationId,
+        },
+    };
+}
+export async function decideActionLedgerApproval(db, input) {
+    return actionLedgerService.decideApproval(db, buildActionLedgerApprovalDecisionInput(input));
+}
+export function buildActionLedgerApprovedExecutionFields(input) {
+    return {
+        causationActionId: input.requestedActionId,
+        approvalId: input.approvalId,
+        idempotencyScope: `${input.approvalId}:execution`,
+        idempotencyKey: input.approvalId,
+        idempotencyFingerprint: input.idempotencyFingerprint,
+    };
+}
+function normalizeNullableString(value) {
+    if (value === undefined || value === null || value === "")
+        return null;
+    return value;
+}