@kbediako/codex-orchestrator 0.1.37 → 0.2.0

package/dist/orchestrator/src/cli/control/controlActionExecution.js

@@ -0,0 +1,142 @@
+import { buildCanonicalTraceability } from './controlActionPreflight.js';
+export function executeControlAction(input) {
+    // Nonce checks can prune expired transport replay entries; read a fresh snapshot before replay lookup.
+    const replaySnapshot = input.readSnapshot();
+    const replay = resolveControlActionReplay({
+        snapshot: replaySnapshot,
+        action: input.action,
+        requestId: input.requestId,
+        intentId: input.intentId,
+        taskId: input.taskId,
+        manifestPath: input.manifestPath,
+        transportMutation: input.transportMutation,
+        isTransportMutation: input.isTransportMutation
+    });
+    if (replay.matched) {
+        return {
+            kind: 'replay',
+            snapshot: replaySnapshot,
+            requestId: replay.requestId,
+            intentId: replay.intentId,
+            traceability: replay.traceability,
+            persistRequired: true,
+            publishRequired: false
+        };
+    }
+    const transportContext = buildTransportContext(input.transportMutation, input.transportIdempotencyWindowMs);
+    const update = input.updateAction({
+        action: input.action,
+        requestedBy: input.requestedBy,
+        requestId: input.requestId,
+        intentId: input.intentId,
+        reason: input.reason ?? null,
+        ...(transportContext ? { transportContext } : {})
+    });
+    return {
+        kind: 'post-update',
+        snapshot: update.snapshot,
+        idempotentReplay: update.idempotentReplay,
+        replayEntry: update.replayEntry ?? null,
+        persistRequired: Boolean(input.transportMutation) || !update.idempotentReplay,
+        publishRequired: !update.idempotentReplay
+    };
+}
+export function resolveControlActionReplay(input) {
+    const transportReplayEntry = input.transportMutation && input.action === 'cancel'
+        ? findTransportIdempotencyReplayEntry({
+            snapshot: input.snapshot,
+            action: input.action,
+            transport: input.transportMutation.transport,
+            requestId: input.requestId,
+            intentId: input.intentId
+        })
+        : null;
+    const genericReplayAllowed = !input.isTransportMutation &&
+        isIdempotentReplay(input.snapshot, input.action, input.requestId, input.intentId) &&
+        (input.action !== 'cancel' || !input.snapshot.latest_action?.transport);
+    if (!transportReplayEntry && !genericReplayAllowed) {
+        return { matched: false };
+    }
+    const replayRequestId = transportReplayEntry
+        ? transportReplayEntry.request_id
+        : withUndefinedFallback(input.snapshot.latest_action?.request_id, input.requestId);
+    const replayIntentId = transportReplayEntry
+        ? transportReplayEntry.intent_id
+        : withUndefinedFallback(input.snapshot.latest_action?.intent_id, input.intentId);
+    const traceability = input.action === 'cancel'
+        ? buildCanonicalTraceability({
+            action: input.action,
+            decision: 'replayed',
+            requestId: replayRequestId,
+            intentId: replayIntentId,
+            taskId: input.taskId,
+            runId: input.snapshot.run_id,
+            manifestPath: input.manifestPath,
+            transport: transportReplayEntry?.transport ??
+                input.snapshot.latest_action?.transport ??
+                input.transportMutation?.transport ??
+                null,
+            actorId: transportReplayEntry?.actor_id ??
+                input.snapshot.latest_action?.actor_id ??
+                input.transportMutation?.actorId ??
+                null,
+            actorSource: transportReplayEntry?.actor_source ??
+                input.snapshot.latest_action?.actor_source ??
+                input.transportMutation?.actorSource ??
+                null,
+            principal: transportReplayEntry?.transport_principal ??
+                input.snapshot.latest_action?.transport_principal ??
+                input.transportMutation?.principal ??
+                null
+        })
+        : null;
+    return {
+        matched: true,
+        requestId: replayRequestId,
+        intentId: replayIntentId,
+        traceability
+    };
+}
+function buildTransportContext(transportMutation, transportIdempotencyWindowMs) {
+    if (!transportMutation || transportIdempotencyWindowMs === null) {
+        return null;
+    }
+    return {
+        transport: transportMutation.transport,
+        actorId: transportMutation.actorId,
+        actorSource: transportMutation.actorSource,
+        principal: transportMutation.principal,
+        idempotencyWindowMs: transportIdempotencyWindowMs
+    };
+}
+function isIdempotentReplay(snapshot, action, requestId, intentId) {
+    const latest = snapshot.latest_action;
+    if (!latest || latest.action !== action) {
+        return false;
+    }
+    if (requestId && latest.request_id === requestId) {
+        return true;
+    }
+    if (intentId && latest.intent_id === intentId) {
+        return true;
+    }
+    return false;
+}
+function findTransportIdempotencyReplayEntry(input) {
+    const index = input.snapshot.transport_mutation?.idempotency_index ?? [];
+    for (const entry of index) {
+        if (entry.action !== input.action || entry.transport !== input.transport) {
+            continue;
+        }
+        if (entry.key_type === 'request' && input.requestId && entry.key === input.requestId) {
+            return entry;
+        }
+        if (entry.key_type === 'intent' && input.intentId && entry.key === input.intentId) {
+            return entry;
+        }
+    }
+    return null;
+}
+function withUndefinedFallback(value, fallback) {
+    return value === undefined ? fallback : value;
+}

package/dist/orchestrator/src/cli/control/controlActionFinalization.js

@@ -0,0 +1,43 @@
+import { buildPostMutationControlActionResponse, buildReplayedControlActionResponse } from './controlActionOutcome.js';
+export function buildReplayControlActionFinalizationPlan(input) {
+    const response = buildReplayedControlActionResponse({
+        snapshot: input.snapshot,
+        requestId: input.requestId,
+        intentId: input.intentId,
+        traceability: input.traceability
+    });
+    return {
+        snapshot: input.snapshot,
+        response,
+        persistRequired: input.persistRequired,
+        publishRequired: false
+    };
+}
+export function buildExecutionControlActionFinalizationPlan(input) {
+    if (input.execution.kind === 'replay') {
+        return buildReplayControlActionFinalizationPlan({
+            snapshot: input.execution.snapshot,
+            requestId: input.execution.requestId,
+            intentId: input.execution.intentId,
+            traceability: input.execution.traceability,
+            persistRequired: input.execution.persistRequired
+        });
+    }
+    const response = buildPostMutationControlActionResponse({
+        action: input.action,
+        snapshot: input.execution.snapshot,
+        requestId: input.requestId,
+        intentId: input.intentId,
+        taskId: input.taskId,
+        manifestPath: input.manifestPath,
+        transportMutation: input.transportMutation,
+        idempotentReplay: input.execution.idempotentReplay,
+        replayEntry: input.execution.replayEntry
+    });
+    return {
+        snapshot: input.execution.snapshot,
+        response,
+        persistRequired: input.execution.persistRequired,
+        publishRequired: input.execution.publishRequired
+    };
+}

package/dist/orchestrator/src/cli/control/controlActionOutcome.js

@@ -0,0 +1,60 @@
+import { buildCanonicalTraceability } from './controlActionPreflight.js';
+export function buildReplayedControlActionResponse(input) {
+    return {
+        status: 200,
+        body: buildSuccessPayload({
+            snapshot: input.snapshot,
+            idempotentReplay: true,
+            traceability: input.traceability
+        }),
+        outcome: 'replayed',
+        requestId: input.requestId,
+        intentId: input.intentId,
+        traceability: input.traceability
+    };
+}
+export function buildPostMutationControlActionResponse(input) {
+    const requestId = input.idempotentReplay
+        ? input.replayEntry
+            ? input.replayEntry.request_id
+            : input.snapshot.latest_action?.request_id ?? input.requestId ?? null
+        : input.requestId ?? input.snapshot.latest_action?.request_id ?? null;
+    const intentId = input.idempotentReplay
+        ? input.replayEntry
+            ? input.replayEntry.intent_id
+            : input.snapshot.latest_action?.intent_id ?? input.intentId ?? null
+        : input.intentId ?? input.snapshot.latest_action?.intent_id ?? null;
+    const traceability = input.transportMutation
+        ? buildCanonicalTraceability({
+            action: input.action,
+            decision: input.idempotentReplay ? 'replayed' : 'applied',
+            requestId,
+            intentId,
+            taskId: input.taskId,
+            runId: input.snapshot.run_id,
+            manifestPath: input.manifestPath,
+            transport: input.transportMutation.transport,
+            actorId: input.replayEntry?.actor_id ?? input.transportMutation.actorId,
+            actorSource: input.replayEntry?.actor_source ?? input.transportMutation.actorSource,
+            principal: input.replayEntry?.transport_principal ?? input.transportMutation.principal
+        })
+        : null;
+    return {
+        status: 200,
+        body: buildSuccessPayload({
+            snapshot: input.snapshot,
+            idempotentReplay: input.idempotentReplay,
+            traceability
+        }),
+        outcome: input.idempotentReplay ? 'replayed' : 'applied',
+        requestId,
+        intentId,
+        traceability
+    };
+}
+function buildSuccessPayload(input) {
+    const payload = input.idempotentReplay
+        ? { ...input.snapshot, idempotent_replay: true }
+        : { ...input.snapshot };
+    return input.traceability ? { ...payload, traceability: input.traceability } : payload;
+}