@cats-inc/cats-platform 0.1.0

package/build/server/platform/scheduler/validation.js

@@ -0,0 +1,407 @@
+import { randomUUID } from 'node:crypto';
+import { CoreValidationError } from '../../core/errors.js';
+import { SCHEDULER_STATE_VERSION } from './contracts.js';
+const DAILY_TIME_PATTERN = /^([01]\d|2[0-3]):([0-5]\d)$/u;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function readRecord(value, fieldName) {
+    if (!isRecord(value)) {
+        throw new CoreValidationError(`${fieldName} must be an object.`, `${fieldName}_invalid`);
+    }
+    return value;
+}
+function readRequiredString(value, fieldName) {
+    if (typeof value !== 'string' || value.trim().length === 0) {
+        throw new CoreValidationError(`${fieldName} is required.`, `${fieldName}_required`);
+    }
+    return value.trim();
+}
+function readOptionalBoolean(value, fallback, fieldName) {
+    if (value === undefined) {
+        return fallback;
+    }
+    if (typeof value !== 'boolean') {
+        throw new CoreValidationError(`${fieldName} must be a boolean.`, `${fieldName}_invalid`);
+    }
+    return value;
+}
+function readOptionalRecord(value, fieldName) {
+    if (value === undefined) {
+        return undefined;
+    }
+    return structuredClone(readRecord(value, fieldName));
+}
+function readOptionalPositiveIntegerOrNull(value, fallback, fieldName) {
+    if (value === undefined) {
+        return fallback;
+    }
+    if (value === null) {
+        return null;
+    }
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < 1) {
+        throw new CoreValidationError(`${fieldName} must be null or a positive integer.`, `${fieldName}_invalid`);
+    }
+    return parsed;
+}
+function readOptionalStringArray(value, fieldName) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!Array.isArray(value)) {
+        throw new CoreValidationError(`${fieldName} must be an array.`, `${fieldName}_invalid`);
+    }
+    return value
+        .map((item, index) => readRequiredString(item, `${fieldName}.${index}`))
+        .filter((item, index, items) => items.indexOf(item) === index);
+}
+function readOptionalRecordArray(value, fieldName) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!Array.isArray(value)) {
+        throw new CoreValidationError(`${fieldName} must be an array.`, `${fieldName}_invalid`);
+    }
+    return value.map((item, index) => structuredClone(readRecord(item, `${fieldName}.${index}`)));
+}
+function assertSupportedTimezone(timezone) {
+    try {
+        new Intl.DateTimeFormat('en-US', { timeZone: timezone }).format(new Date());
+    }
+    catch {
+        throw new CoreValidationError('Schedule timezone is invalid.', 'schedule_timezone_invalid');
+    }
+}
+function normalizeScheduleTarget(value) {
+    const target = readRecord(value, 'missionTemplate.target');
+    const kind = readRequiredString(target.kind, 'missionTemplate.target.kind');
+    if (kind !== 'cat' && kind !== 'agent') {
+        throw new CoreValidationError('Mission template target kind must be cat or agent.', 'schedule_target_kind_invalid');
+    }
+    return {
+        kind,
+        id: readRequiredString(target.id, 'missionTemplate.target.id'),
+    };
+}
+export function normalizeScheduleDefinition(value) {
+    const schedule = readRecord(value, 'schedule');
+    const kind = readRequiredString(schedule.kind, 'schedule.kind');
+    if (kind === 'cron') {
+        throw new CoreValidationError('Cron schedule rules are not supported in v1.', 'schedule_cron_unsupported');
+    }
+    if (kind === 'once') {
+        const fireAt = readRequiredString(schedule.fireAt, 'schedule.fireAt');
+        const parsed = Date.parse(fireAt);
+        if (!Number.isFinite(parsed)) {
+            throw new CoreValidationError('schedule.fireAt must be an ISO timestamp.', 'schedule_fire_at_invalid');
+        }
+        return { kind, fireAt: new Date(parsed).toISOString() };
+    }
+    if (kind === 'daily') {
+        const time = readRequiredString(schedule.time, 'schedule.time');
+        if (!DAILY_TIME_PATTERN.test(time)) {
+            throw new CoreValidationError('Daily schedule time must be HH:mm in 24-hour local time.', 'schedule_daily_time_invalid');
+        }
+        return { kind, time };
+    }
+    throw new CoreValidationError('Schedule kind must be once or daily.', 'schedule_kind_invalid');
+}
+export function normalizeMissionTemplate(value) {
+    const template = readRecord(value, 'missionTemplate');
+    const originSurface = readRequiredString(template.originSurface, 'missionTemplate.originSurface');
+    if (originSurface !== 'schedule') {
+        throw new CoreValidationError('Mission template originSurface must be schedule.', 'schedule_origin_surface_invalid');
+    }
+    const transportTargetsValue = template.transportTargets;
+    const transportTargets = (() => {
+        if (transportTargetsValue === undefined) {
+            return undefined;
+        }
+        if (!Array.isArray(transportTargetsValue)) {
+            throw new CoreValidationError('missionTemplate.transportTargets must be an array.', 'schedule_transport_targets_invalid');
+        }
+        return transportTargetsValue.map((item, index) => {
+            const target = readRecord(item, `missionTemplate.transportTargets.${index}`);
+            return {
+                platform: readRequiredString(target.platform, `missionTemplate.transportTargets.${index}.platform`),
+                bindingId: readRequiredString(target.bindingId, `missionTemplate.transportTargets.${index}.bindingId`),
+            };
+        });
+    })();
+    const conversationTarget = (() => {
+        if (template.conversationTarget === undefined || template.conversationTarget === null) {
+            return null;
+        }
+        const target = readRecord(template.conversationTarget, 'missionTemplate.conversationTarget');
+        return {
+            conversationId: readRequiredString(target.conversationId, 'missionTemplate.conversationTarget.conversationId'),
+        };
+    })();
+    return {
+        target: normalizeScheduleTarget(template.target),
+        originSurface,
+        intent: readRequiredString(template.intent, 'missionTemplate.intent'),
+        conversationTarget,
+        ...(transportTargets === undefined ? {} : { transportTargets }),
+        ...(readOptionalRecordArray(template.resourceScopes, 'missionTemplate.resourceScopes') === undefined
+            ? {}
+            : {
+                resourceScopes: readOptionalRecordArray(template.resourceScopes, 'missionTemplate.resourceScopes'),
+            }),
+        ...(readOptionalStringArray(template.toolScopes, 'missionTemplate.toolScopes') === undefined
+            ? {}
+            : { toolScopes: readOptionalStringArray(template.toolScopes, 'missionTemplate.toolScopes') }),
+        ...(readOptionalRecord(template.approvalPolicy, 'missionTemplate.approvalPolicy') === undefined
+            ? {}
+            : { approvalPolicy: readOptionalRecord(template.approvalPolicy, 'missionTemplate.approvalPolicy') }),
+        ...(readOptionalRecord(template.outputPolicy, 'missionTemplate.outputPolicy') === undefined
+            ? {}
+            : { outputPolicy: readOptionalRecord(template.outputPolicy, 'missionTemplate.outputPolicy') }),
+    };
+}
+export function createDefaultScheduleExecutionPolicy() {
+    return {
+        missionPolicy: 'per_fire',
+        concurrencyPolicy: 'skip',
+        misfirePolicy: 'skip',
+        retryPolicy: {
+            maxAttempts: 0,
+            backoff: 'none',
+            pauseAfterConsecutiveFailures: 3,
+        },
+    };
+}
+export function normalizeScheduleExecutionPolicy(value) {
+    const defaults = createDefaultScheduleExecutionPolicy();
+    if (value === undefined) {
+        return defaults;
+    }
+    const policy = readRecord(value, 'executionPolicy');
+    const missionPolicy = policy.missionPolicy === undefined
+        ? defaults.missionPolicy
+        : readRequiredString(policy.missionPolicy, 'executionPolicy.missionPolicy');
+    if (missionPolicy !== 'per_fire') {
+        throw new CoreValidationError('Schedule missionPolicy must be per_fire in v1.', 'schedule_mission_policy_invalid');
+    }
+    const concurrencyPolicy = policy.concurrencyPolicy === undefined
+        ? defaults.concurrencyPolicy
+        : readRequiredString(policy.concurrencyPolicy, 'executionPolicy.concurrencyPolicy');
+    if (concurrencyPolicy !== 'skip'
+        && concurrencyPolicy !== 'queue'
+        && concurrencyPolicy !== 'replace') {
+        throw new CoreValidationError('Schedule concurrencyPolicy is invalid.', 'schedule_concurrency_policy_invalid');
+    }
+    const misfirePolicy = policy.misfirePolicy === undefined
+        ? defaults.misfirePolicy
+        : readRequiredString(policy.misfirePolicy, 'executionPolicy.misfirePolicy');
+    if (misfirePolicy !== 'skip' && misfirePolicy !== 'fire_once' && misfirePolicy !== 'fire_all') {
+        throw new CoreValidationError('Schedule misfirePolicy is invalid.', 'schedule_misfire_policy_invalid');
+    }
+    const retryPolicyRecord = policy.retryPolicy === undefined
+        ? {}
+        : readRecord(policy.retryPolicy, 'executionPolicy.retryPolicy');
+    const maxAttempts = retryPolicyRecord.maxAttempts === undefined
+        ? defaults.retryPolicy.maxAttempts
+        : Number(retryPolicyRecord.maxAttempts);
+    if (!Number.isInteger(maxAttempts) || maxAttempts < 0) {
+        throw new CoreValidationError('Schedule retryPolicy.maxAttempts must be a non-negative integer.', 'schedule_retry_max_attempts_invalid');
+    }
+    const backoff = retryPolicyRecord.backoff === undefined
+        ? defaults.retryPolicy.backoff
+        : readRequiredString(retryPolicyRecord.backoff, 'executionPolicy.retryPolicy.backoff');
+    if (backoff !== 'none' && backoff !== 'fixed' && backoff !== 'exponential') {
+        throw new CoreValidationError('Schedule retryPolicy.backoff is invalid.', 'schedule_retry_backoff_invalid');
+    }
+    const pauseAfterConsecutiveFailures = readOptionalPositiveIntegerOrNull(retryPolicyRecord.pauseAfterConsecutiveFailures, defaults.retryPolicy.pauseAfterConsecutiveFailures, 'executionPolicy.retryPolicy.pauseAfterConsecutiveFailures');
+    return {
+        missionPolicy,
+        concurrencyPolicy,
+        misfirePolicy,
+        retryPolicy: {
+            maxAttempts,
+            backoff,
+            pauseAfterConsecutiveFailures,
+        },
+    };
+}
+function serializeAdmissionFields(rule) {
+    return JSON.stringify({
+        timezone: rule.timezone,
+        schedule: rule.schedule,
+        missionTemplate: rule.missionTemplate,
+        executionPolicy: rule.executionPolicy,
+    });
+}
+export function createScheduleRule(input, now = new Date()) {
+    const nowIso = now.toISOString();
+    const title = readRequiredString(input.title, 'title');
+    const timezone = readRequiredString(input.timezone, 'timezone');
+    assertSupportedTimezone(timezone);
+    return {
+        id: input.id?.trim() || `schedule-${randomUUID()}`,
+        title,
+        enabled: readOptionalBoolean(input.enabled, true, 'enabled'),
+        revision: 1,
+        timezone,
+        schedule: normalizeScheduleDefinition(input.schedule),
+        missionTemplate: normalizeMissionTemplate(input.missionTemplate),
+        executionPolicy: normalizeScheduleExecutionPolicy(input.executionPolicy),
+        createdAt: nowIso,
+        updatedAt: nowIso,
+        createdByActorId: readRequiredString(input.createdByActorId, 'createdByActorId'),
+        nextFireAt: null,
+        lastFireAt: null,
+        lastRunId: null,
+        lastFailure: null,
+        consecutiveFailures: 0,
+        retryState: null,
+        pausedAt: null,
+        pauseReason: null,
+    };
+}
+export function updateScheduleRule(existing, input, now = new Date()) {
+    const beforeAdmissionFields = serializeAdmissionFields(existing);
+    const timezone = input.timezone === undefined
+        ? existing.timezone
+        : readRequiredString(input.timezone, 'timezone');
+    assertSupportedTimezone(timezone);
+    const next = {
+        ...existing,
+        title: input.title === undefined ? existing.title : readRequiredString(input.title, 'title'),
+        enabled: readOptionalBoolean(input.enabled, existing.enabled, 'enabled'),
+        timezone,
+        schedule: input.schedule === undefined
+            ? structuredClone(existing.schedule)
+            : normalizeScheduleDefinition(input.schedule),
+        missionTemplate: input.missionTemplate === undefined
+            ? structuredClone(existing.missionTemplate)
+            : normalizeMissionTemplate(input.missionTemplate),
+        executionPolicy: input.executionPolicy === undefined
+            ? structuredClone(existing.executionPolicy)
+            : normalizeScheduleExecutionPolicy(input.executionPolicy),
+        updatedAt: now.toISOString(),
+        lastFailure: input.enabled === true ? null : existing.lastFailure,
+    };
+    const afterAdmissionFields = serializeAdmissionFields(next);
+    const admissionChanged = beforeAdmissionFields !== afterAdmissionFields;
+    return {
+        ...next,
+        revision: admissionChanged ? existing.revision + 1 : existing.revision,
+        consecutiveFailures: input.enabled === true || admissionChanged
+            ? 0
+            : existing.consecutiveFailures ?? 0,
+        retryState: input.enabled === true || admissionChanged
+            ? null
+            : existing.retryState ?? null,
+        pausedAt: input.enabled === true || admissionChanged
+            ? null
+            : existing.pausedAt ?? null,
+        pauseReason: input.enabled === true || admissionChanged
+            ? null
+            : existing.pauseReason ?? null,
+    };
+}
+export function createEmptySchedulerState(now = new Date()) {
+    return {
+        version: SCHEDULER_STATE_VERSION,
+        updatedAt: now.toISOString(),
+        rules: [],
+        triggerReceipts: [],
+    };
+}
+export function normalizeSchedulerState(value, now = new Date()) {
+    if (!isRecord(value)) {
+        return createEmptySchedulerState(now);
+    }
+    const rules = Array.isArray(value.rules)
+        ? value.rules.filter(isScheduleRule)
+            .map(normalizeScheduleRuleRuntimeState)
+        : [];
+    const triggerReceipts = Array.isArray(value.triggerReceipts)
+        ? value.triggerReceipts.filter(isScheduleTriggerReceipt)
+        : [];
+    return {
+        version: SCHEDULER_STATE_VERSION,
+        updatedAt: typeof value.updatedAt === 'string' ? value.updatedAt : now.toISOString(),
+        rules: structuredClone(rules),
+        triggerReceipts: structuredClone(triggerReceipts),
+    };
+}
+function normalizeScheduleRuleRuntimeState(rule) {
+    const consecutiveFailures = rule.consecutiveFailures;
+    const pauseAfterConsecutiveFailures = rule.executionPolicy.retryPolicy.pauseAfterConsecutiveFailures;
+    const normalizedConsecutiveFailures = Number.isInteger(consecutiveFailures) && (consecutiveFailures ?? 0) >= 0
+        ? consecutiveFailures ?? 0
+        : 0;
+    return {
+        ...structuredClone(rule),
+        executionPolicy: {
+            ...rule.executionPolicy,
+            retryPolicy: {
+                ...rule.executionPolicy.retryPolicy,
+                pauseAfterConsecutiveFailures: typeof pauseAfterConsecutiveFailures === 'number'
+                    || pauseAfterConsecutiveFailures === null
+                    ? pauseAfterConsecutiveFailures
+                    : createDefaultScheduleExecutionPolicy().retryPolicy.pauseAfterConsecutiveFailures,
+            },
+        },
+        consecutiveFailures: normalizedConsecutiveFailures,
+        retryState: normalizeScheduleRetryState(rule.retryState),
+        pausedAt: typeof rule.pausedAt === 'string' ? rule.pausedAt : null,
+        pauseReason: typeof rule.pauseReason === 'string' ? rule.pauseReason : null,
+    };
+}
+function normalizeScheduleRetryState(value) {
+    if (!isRecord(value)) {
+        return null;
+    }
+    if (!Number.isInteger(value.attempt)
+        || Number(value.attempt) < 1
+        || !Number.isInteger(value.maxAttempts)
+        || Number(value.maxAttempts) < Number(value.attempt)
+        || typeof value.nextRetryAt !== 'string'
+        || !Number.isFinite(Date.parse(value.nextRetryAt))
+        || typeof value.originalScheduledFireAt !== 'string'
+        || !Number.isFinite(Date.parse(value.originalScheduledFireAt))
+        || typeof value.lastError !== 'string'
+        || typeof value.failedReceiptId !== 'string') {
+        return null;
+    }
+    return {
+        attempt: Number(value.attempt),
+        maxAttempts: Number(value.maxAttempts),
+        nextRetryAt: new Date(value.nextRetryAt).toISOString(),
+        originalScheduledFireAt: new Date(value.originalScheduledFireAt).toISOString(),
+        lastError: value.lastError,
+        failedReceiptId: value.failedReceiptId,
+    };
+}
+function isScheduleRule(value) {
+    return isRecord(value)
+        && typeof value.id === 'string'
+        && typeof value.title === 'string'
+        && typeof value.enabled === 'boolean'
+        && typeof value.revision === 'number'
+        && typeof value.timezone === 'string'
+        && isRecord(value.schedule)
+        && isRecord(value.missionTemplate)
+        && isRecord(value.executionPolicy)
+        && typeof value.createdAt === 'string'
+        && typeof value.updatedAt === 'string'
+        && typeof value.createdByActorId === 'string';
+}
+function isScheduleTriggerReceipt(value) {
+    return isRecord(value)
+        && typeof value.id === 'string'
+        && typeof value.ruleId === 'string'
+        && typeof value.ruleRevision === 'number'
+        && typeof value.scheduledFireAt === 'string'
+        && typeof value.actualFireAt === 'string'
+        && typeof value.idempotencyKey === 'string'
+        && typeof value.reason === 'string'
+        && typeof value.status === 'string'
+        && typeof value.createdAt === 'string'
+        && typeof value.updatedAt === 'string';
+}
+//# sourceMappingURL=validation.js.map

package/build/server/platform/scheduler/validation.js.map

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

package/build/server/platform/supervision/approvalRequests.d.ts

@@ -0,0 +1,36 @@
+import type { CatsCoreState, CoreApprovalBindingRecord, CoreTaskRecord } from '../../core/types.js';
+import type { RunApprovalRequestState } from './runState.js';
+import type { SupervisionFallbackPolicy } from './contracts.js';
+export interface PersistSupervisionApprovalRequestInput {
+    core: CatsCoreState;
+    runId: string;
+    approvalRequestId: string;
+    actionId: string;
+    toolName: string;
+    summary: string;
+    requestedByActorId: string | null;
+    requestedForActorId?: string;
+    now?: Date;
+}
+export interface PersistSupervisionApprovalRequestResult {
+    core: CatsCoreState;
+    task: CoreTaskRecord;
+    approvalBinding: CoreApprovalBindingRecord;
+    created: boolean;
+}
+export interface ApplySupervisionApprovalDecisionInput {
+    core: CatsCoreState;
+    approvalTaskId: string;
+    fallbackPolicy: SupervisionFallbackPolicy;
+    now?: Date;
+}
+export interface ApplySupervisionApprovalDecisionResult {
+    core: CatsCoreState;
+    task: CoreTaskRecord;
+    approvalBinding: CoreApprovalBindingRecord;
+    runId: string;
+    approvalRequest: RunApprovalRequestState;
+}
+export declare function persistSupervisionApprovalRequest(input: PersistSupervisionApprovalRequestInput): PersistSupervisionApprovalRequestResult;
+export declare function applySupervisionApprovalDecision(input: ApplySupervisionApprovalDecisionInput): ApplySupervisionApprovalDecisionResult;
+//# sourceMappingURL=approvalRequests.d.ts.map

package/build/server/platform/supervision/approvalRequests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approvalRequests.d.ts","sourceRoot":"","sources":["../../../../src/platform/supervision/approvalRequests.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,aAAa,EACb,yBAAyB,EACzB,cAAc,EACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,uBAAuB,EACxB,MAAM,eAAe,CAAC;AAMvB,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAEhE,MAAM,WAAW,sCAAsC;IACrD,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,uCAAuC;IACtD,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,cAAc,CAAC;IACrB,eAAe,EAAE,yBAAyB,CAAC;IAC3C,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,qCAAqC;IACpD,IAAI,EAAE,aAAa,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,yBAAyB,CAAC;IAC1C,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,sCAAsC;IACrD,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,cAAc,CAAC;IACrB,eAAe,EAAE,yBAAyB,CAAC;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,uBAAuB,CAAC;CAC1C;AAED,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,sCAAsC,GAC5C,uCAAuC,CAyEzC;AAED,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,qCAAqC,GAC3C,sCAAsC,CA+ExC"}

package/build/server/platform/supervision/approvalRequests.js

@@ -0,0 +1,191 @@
+import { upsertCoreApprovalBinding, upsertCoreRun, upsertCoreTask, writeApprovalDecision, } from '../../core/model/index.js';
+import { CoreConflictError, CoreNotFoundError } from '../../core/errors.js';
+import { applyApprovalDenied, deriveRunState, writeRunStateMetadata, } from './runState.js';
+export function persistSupervisionApprovalRequest(input) {
+    const now = input.now ?? new Date();
+    const run = input.core.runs.find((candidate) => candidate.id === input.runId) ?? null;
+    if (!run) {
+        throw new CoreNotFoundError(`Run not found: ${input.runId}`, 'run_not_found');
+    }
+    const stableId = buildSupervisionApprovalStableId(input);
+    const taskResult = upsertCoreTask(input.core, {
+        id: `task-supervision-approval-${stableId}`,
+        title: `Approval required for ${input.toolName}`,
+        status: 'pending_approval',
+        conversationId: run.conversationId,
+        parentTaskId: run.taskId,
+        ownerActorId: input.requestedForActorId ?? input.core.ownerProfile.actorId,
+        orchestratorActorId: input.requestedByActorId,
+        summary: input.summary,
+        metadata: {
+            supervisionApproval: {
+                source: 'supervision_tool_boundary',
+                runId: input.runId,
+                actionId: input.actionId,
+                approvalRequestId: input.approvalRequestId,
+                toolName: input.toolName,
+            },
+        },
+    }, now);
+    const approvalResult = taskResult.task.approval.status === 'pending'
+        ? taskResult
+        : writeApprovalDecision(taskResult.core, {
+            taskId: taskResult.task.id,
+            status: 'pending',
+            requestedByActorId: input.requestedByActorId,
+        }, now);
+    const bindingResult = upsertCoreApprovalBinding(approvalResult.core, {
+        id: `approval-binding-supervision-${stableId}`,
+        kind: 'owner_decision',
+        approvalTaskId: approvalResult.task.id,
+        subjectKind: 'run',
+        subjectId: run.id,
+        conversationId: run.conversationId,
+        requestedByActorId: input.requestedByActorId,
+        requestedForActorId: input.requestedForActorId ?? input.core.ownerProfile.actorId,
+        metadata: {
+            supervisionApproval: {
+                source: 'supervision_tool_boundary',
+                runId: input.runId,
+                actionId: input.actionId,
+                approvalRequestId: input.approvalRequestId,
+                toolName: input.toolName,
+            },
+        },
+    }, now);
+    return {
+        core: bindingResult.core,
+        task: approvalResult.task,
+        approvalBinding: bindingResult.approvalBinding,
+        created: taskResult.created || bindingResult.created,
+    };
+}
+export function applySupervisionApprovalDecision(input) {
+    const now = input.now ?? new Date();
+    const task = input.core.tasks.find((candidate) => candidate.id === input.approvalTaskId) ?? null;
+    const approvalBinding = input.core.approvalBindings.find((candidate) => candidate.approvalTaskId === input.approvalTaskId &&
+        readSupervisionApprovalMetadata(candidate.metadata) !== null) ?? null;
+    if (!task) {
+        throw new CoreNotFoundError(`Approval task not found: ${input.approvalTaskId}`, 'task_not_found');
+    }
+    if (!approvalBinding) {
+        throw new CoreNotFoundError(`Supervision approval binding not found: ${input.approvalTaskId}`, 'approval_binding_not_found');
+    }
+    const metadata = readSupervisionApprovalMetadata(approvalBinding.metadata);
+    if (!metadata) {
+        throw new CoreConflictError(`Approval binding is not a supervision request: ${approvalBinding.id}`, 'approval_binding_invalid');
+    }
+    const run = input.core.runs.find((candidate) => candidate.id === metadata.runId) ?? null;
+    if (!run) {
+        throw new CoreNotFoundError(`Run not found: ${metadata.runId}`, 'run_not_found');
+    }
+    const approvalRequest = {
+        requestId: metadata.approvalRequestId,
+        state: mapApprovalTaskStatus(task),
+        gating: true,
+    };
+    const evaluation = approvalRequest.state === 'denied'
+        ? applyApprovalDenied({
+            current: {
+                lifecycle: toLifecycle(run.status),
+                approvalRequests: [{
+                        ...approvalRequest,
+                        state: 'pending',
+                    }],
+            },
+            requestId: approvalRequest.requestId,
+            fallbackPolicy: input.fallbackPolicy,
+        })
+        : deriveRunState({
+            lifecycle: toLifecycle(run.status),
+            approvalRequests: [approvalRequest],
+        });
+    const nextStatus = evaluation.primaryState === 'failed'
+        ? 'failed'
+        : run.status;
+    const next = upsertCoreRun(input.core, {
+        id: run.id,
+        title: run.title,
+        status: nextStatus,
+        metadata: writeRunStateMetadata({
+            metadata: run.metadata,
+            evaluation,
+            evaluatedAt: now.toISOString(),
+        }),
+    }, now);
+    return {
+        core: next.core,
+        task,
+        approvalBinding,
+        runId: run.id,
+        approvalRequest,
+    };
+}
+function buildSupervisionApprovalStableId(input) {
+    return normalizeIdSegment(`${input.runId}-${input.actionId}-${input.approvalRequestId}`);
+}
+function normalizeIdSegment(value) {
+    const normalized = value
+        .trim()
+        .replace(/[^A-Za-z0-9_-]+/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+    return normalized.length > 0 ? normalized : 'request';
+}
+function readSupervisionApprovalMetadata(metadata) {
+    const supervisionApproval = asRecord(asRecord(metadata)?.supervisionApproval);
+    const runId = readString(supervisionApproval?.runId);
+    const actionId = readString(supervisionApproval?.actionId);
+    const approvalRequestId = readString(supervisionApproval?.approvalRequestId);
+    const toolName = readString(supervisionApproval?.toolName);
+    return runId && actionId && approvalRequestId && toolName
+        ? {
+            runId,
+            actionId,
+            approvalRequestId,
+            toolName,
+        }
+        : null;
+}
+function mapApprovalTaskStatus(task) {
+    switch (task.approval.status) {
+        case 'pending':
+            return 'pending';
+        case 'approved':
+            return 'approved';
+        case 'rejected':
+            return 'denied';
+        case 'not_requested':
+            throw new CoreConflictError(`Approval task has no pending decision: ${task.id}`, 'approval_state_invalid');
+        default: {
+            const exhaustive = task.approval.status;
+            return exhaustive;
+        }
+    }
+}
+function toLifecycle(status) {
+    switch (status) {
+        case 'queued':
+            return 'queued';
+        case 'running':
+        case 'blocked':
+            return 'active';
+        case 'completed':
+        case 'failed':
+        case 'cancelled':
+            return status;
+        default: {
+            const exhaustive = status;
+            return exhaustive;
+        }
+    }
+}
+function readString(value) {
+    return typeof value === 'string' && value.trim() !== '' ? value : null;
+}
+function asRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : null;
+}
+//# sourceMappingURL=approvalRequests.js.map