@cats-inc/cats-platform 0.1.21 → 0.2.8

package/build/server/products/work/api/goldenPathProjection.js

@@ -0,0 +1,252 @@
+/**
+ * Desktop projection for the transport work-delivery golden path
+ * (SPEC-114 FR-49, FR-50).
+ *
+ * Desktop must be able to explain every Telegram message from durable records:
+ * where the request came in, exactly which scope revision the owner authorized,
+ * what executed, what evidence was accepted, and whether the result actually
+ * reached the owner.
+ *
+ * Like the transport stage, this is a derivation — it holds no state and adds
+ * no authority. Unlike the transport payloads, it may show local paths: Desktop
+ * runs on the owner's own machine, so the FR-44 restriction that applies to a
+ * chat message does not apply here. Secrets are still never included, because
+ * they are never in these records to begin with.
+ */
+import { resolveOutstandingDeliveryGates } from '../../../platform/transports/work-delivery/deliveryGates.js';
+import { projectTransportWorkStage } from '../../../platform/transports/work-delivery/stageProjection.js';
+import { readWorkGoldenPathMetadata } from '../shared/workGoldenPathMetadata.js';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function readString(value) {
+    return typeof value === 'string' && value.trim() !== '' ? value : null;
+}
+function readStringArray(value) {
+    return Array.isArray(value)
+        ? value.filter((entry) => typeof entry === 'string')
+        : [];
+}
+function toAttemptView(row) {
+    return {
+        idempotencyKey: row.idempotencyKey,
+        purpose: row.purpose,
+        state: row.state,
+        attemptCount: row.attemptCount,
+        externalMessageRef: row.externalMessageRef,
+        lastErrorCode: row.lastErrorCode,
+        sentAt: row.sentAt,
+    };
+}
+/**
+ * Reads the authorization stamp the admission command wrote onto the Run.
+ *
+ * Absent means the scope was never authorized, which Desktop shows as an empty
+ * authorization block rather than inventing an actor.
+ */
+function readAuthorization(run) {
+    const envelope = run && isRecord(run.metadata.workGoldenPath)
+        ? run.metadata.workGoldenPath
+        : null;
+    return {
+        authorizedByActorId: readString(envelope?.authorizedByActorId),
+        authorizedAt: readString(envelope?.authorizedAt),
+        bindingId: readString(envelope?.bindingId),
+        proposalRevision: typeof envelope?.proposalRevision === 'number'
+            ? envelope.proposalRevision
+            : null,
+        proposalDigest: readString(envelope?.proposalDigest),
+        admissionKey: readString(envelope?.admissionKey),
+    };
+}
+function readEvidence(input) {
+    const outcome = input.run
+        ? input.core.outcomes.find((candidate) => candidate.runId === input.run.id) ?? null
+        : null;
+    const metadata = outcome?.metadata ?? {};
+    const validation = isRecord(metadata.validation)
+        && typeof metadata.validation.command === 'string'
+        && typeof metadata.validation.passed === 'boolean'
+        ? { command: metadata.validation.command, passed: metadata.validation.passed }
+        : null;
+    const satisfiedCriteria = readStringArray(metadata.satisfiedCriteria);
+    const normalized = new Set(satisfiedCriteria.map((entry) => entry.trim().toLowerCase()));
+    const artifacts = input.core.artifacts.filter((artifact) => artifact.workItemId === input.workItem.id);
+    return {
+        outcomeStatus: outcome?.status ?? null,
+        commitId: readString(metadata.commitId),
+        changeSummary: readString(metadata.changeSummary),
+        validation,
+        artifacts: artifacts.map((artifact) => ({
+            id: artifact.id,
+            title: artifact.title,
+            status: artifact.status,
+            path: artifact.path,
+        })),
+        satisfiedCriteria,
+        unmetCriteria: input.acceptanceCriteria.filter((criterion) => !normalized.has(criterion.trim().toLowerCase())),
+    };
+}
+function readPermissionDenial(run) {
+    const envelope = run && isRecord(run.metadata.workGoldenPathDenial)
+        ? run.metadata.workGoldenPathDenial
+        : null;
+    const toolName = readString(envelope?.toolName);
+    const code = readString(envelope?.code);
+    if (toolName === null || code === null) {
+        return null;
+    }
+    return { toolName, code, deniedAt: readString(envelope?.deniedAt) };
+}
+function readBlockers(input) {
+    const blockers = [];
+    if (!input.bindingPresent) {
+        blockers.push(`The originating Telegram binding ${input.bindingId} no longer exists, so results `
+            + 'cannot be delivered to it.');
+    }
+    if (input.run !== null
+        && (input.stage === 'decision_needed' || input.stage === 'failed')) {
+        blockers.push(input.run.summary ?? `Run is ${input.run.status}.`);
+    }
+    return blockers;
+}
+function resolveRecoveryActions(input) {
+    const failedResult = input.attempts.some((attempt) => (attempt.purpose === 'result' || attempt.purpose === 'publish_result')
+        && attempt.state !== 'sent');
+    // A failed final send is the one case where Desktop can finish the job the
+    // transport could not (FR-46).
+    if (failedResult && (input.stage === 'result_ready' || input.stage === 'publish_authorized')) {
+        return ['retry_delivery', 'cancel'];
+    }
+    if (input.stage === 'delivered' || input.stage === 'cancelled') {
+        return ['none'];
+    }
+    // A stuck run is the case Desktop most needs to unstick.
+    if (input.stage === 'failed' || input.stage === 'decision_needed') {
+        return ['retry_run', 'cancel'];
+    }
+    // A `running` Run may have lost its driver to a host restart.
+    if (input.stage === 'running') {
+        return ['resume_run', 'cancel'];
+    }
+    return ['cancel'];
+}
+/**
+ * Builds the golden-path view for one Work Item, or `null` when the item did not
+ * come in through a transport.
+ */
+export function buildWorkGoldenPathDetailProjection(input) {
+    const workItem = input.core.workItems.find((candidate) => candidate.id === input.workItemId)
+        ?? null;
+    if (workItem === null) {
+        return null;
+    }
+    const metadata = readWorkGoldenPathMetadata(workItem.metadata);
+    const origin = metadata?.origin ?? null;
+    const proposal = metadata?.proposal ?? null;
+    if (origin === null || proposal === null) {
+        return null;
+    }
+    const task = workItem.taskId
+        ? input.core.tasks.find((candidate) => candidate.id === workItem.taskId) ?? null
+        : null;
+    const run = task
+        ? input.core.runs.find((candidate) => candidate.taskId === task.id) ?? null
+        : null;
+    const outcome = run
+        ? input.core.outcomes.find((candidate) => candidate.runId === run.id) ?? null
+        : null;
+    const artifacts = input.core.artifacts.filter((artifact) => artifact.workItemId === workItem.id);
+    const deliveryRows = input.deliveryReader?.list(workItem.id) ?? [];
+    const bindingPresent = input.core.botBindings.some((binding) => binding.id === origin.bindingId && binding.status === 'active');
+    const evidence = readEvidence({
+        core: input.core,
+        workItem,
+        run,
+        acceptanceCriteria: proposal.acceptanceCriteria,
+    });
+    const outstandingGates = resolveOutstandingDeliveryGates({
+        deliveryMode: proposal.deliveryMode,
+        effectiveGates: proposal.deliveryGates,
+        satisfiedGates: [],
+        publishesPublicArtifact: false,
+    });
+    const stageProjection = projectTransportWorkStage({
+        workItem,
+        proposal,
+        task,
+        run,
+        outcome,
+        artifacts,
+        commitId: evidence.commitId,
+        outstandingGates,
+        deliveryRows,
+        awaitingOwnerDecision: task?.approval.status === 'pending' && run !== null,
+    });
+    const attempts = deliveryRows.map(toAttemptView);
+    return {
+        workItemId: workItem.id,
+        source: {
+            transport: origin.transport,
+            bindingId: origin.bindingId,
+            present: bindingPresent,
+            externalConversationRef: origin.externalConversationRef,
+            externalUpdateRef: origin.externalUpdateRef,
+            externalMessageRef: origin.externalMessageRef,
+            conversationId: origin.conversationId,
+            locale: metadata?.locale ?? null,
+        },
+        scope: {
+            revision: proposal.revision,
+            digest: proposal.digest,
+            goal: proposal.goal,
+            targetLabel: proposal.targetLabel,
+            workspacePath: proposal.workspacePath,
+            acceptanceCriteria: [...proposal.acceptanceCriteria],
+            deliveryMode: proposal.deliveryMode,
+            deliveryGates: [...proposal.deliveryGates],
+            sideEffects: [...proposal.sideEffects],
+            openQuestion: proposal.openQuestion,
+            proposedAt: proposal.createdAt,
+        },
+        authorization: readAuthorization(run),
+        taskId: task?.id ?? null,
+        taskStatus: task?.status ?? null,
+        runId: run?.id ?? null,
+        runStatus: run?.status ?? null,
+        stage: stageProjection.stage,
+        stageRationale: stageProjection.rationale,
+        blockers: readBlockers({
+            run,
+            stage: stageProjection.stage,
+            bindingPresent,
+            bindingId: origin.bindingId,
+        }),
+        permissionDenial: readPermissionDenial(run),
+        evidence,
+        outstandingGates,
+        delivery: {
+            attempts,
+            receipt: attempts.find((attempt) => attempt.state === 'sent'
+                && (attempt.purpose === 'result' || attempt.purpose === 'publish_result')) ?? null,
+        },
+        recoveryActions: resolveRecoveryActions({ stage: stageProjection.stage, attempts }),
+    };
+}
+/**
+ * Convenience for the Task detail surface, which knows a Task rather than a
+ * Work Item.
+ */
+export function buildWorkGoldenPathDetailProjectionForTask(input) {
+    const workItem = input.core.workItems.find((candidate) => candidate.taskId === input.taskId)
+        ?? null;
+    if (workItem === null) {
+        return null;
+    }
+    return buildWorkGoldenPathDetailProjection({
+        core: input.core,
+        workItemId: workItem.id,
+        deliveryReader: input.deliveryReader,
+    });
+}
+//# sourceMappingURL=goldenPathProjection.js.map

package/build/server/products/work/api/goldenPathProjection.js.map

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

package/build/server/products/work/api/index.d.ts

@@ -1,3 +1,4 @@
+import { type TransportWorkDeliveryReader, type WorkGoldenPathDetailProjection } from './goldenPathProjection.js';
 import type { CoreStore } from '../../../core/store.js';
 import type { EvidenceEvent } from '../../../core/types.js';
 import { type RuntimeClient } from '../../../platform/runtime/client.js';
@@ -12,6 +13,13 @@ export interface WorkRuntimeTargetOverride {
     model?: string | null;
     cwd?: string | null;
 }
+/**
+ * Re-exported shape rather than an import from `app/server`: products must not
+ * depend on host composition, so the host satisfies this structurally.
+ */
+export interface TransportWorkReadinessReader {
+    describe(): Promise<unknown>;
+}
 export interface WorkApiDependencies {
     coreStore: CoreStore;
     runtimeClient?: RuntimeClient;
@@ -20,12 +28,57 @@ export interface WorkApiDependencies {
     evidenceDataDir?: string;
     readEvidenceEvents?: (conversationId: string) => EvidenceEvent[];
     externalIssueImport?: ExternalIssueImportFetchOptions;
+    /**
+     * Read-only view of the transport delivery outbox (SPEC-114 FR-49).
+     * Absent means Desktop shows work without its transport receipts.
+     */
+    transportWorkDelivery?: TransportWorkDeliveryReader;
+    /**
+     * Delegation readiness, evaluated by the same code the transport uses
+     * (SPEC-114 FR-3). Absent means the golden path is off for this host, which
+     * Desktop reports as "not enabled" rather than as "ready".
+     */
+    transportWorkReadiness?: TransportWorkReadinessReader;
+    /**
+     * Bounded operational counters (PLAN-105 Phase 6). Absent means the host runs
+     * unmeasured, which the endpoint reports as such.
+     */
+    transportWorkTelemetry?: {
+        snapshot(): unknown;
+    };
     now?: () => Date;
 }
 export type WorkApiRouteContext = RouteContext<WorkApiDependencies>;
 export type WorkSupervisedRunLifecycleAction = 'resume' | 'retry';
 export declare function createWorkDashboardPayload(core: Awaited<ReturnType<CoreStore['readCore']>>): WorkDashboardProjection;
-export declare function createWorkTaskDetailPayload(core: Awaited<ReturnType<CoreStore['readCore']>>, taskId: string, evidenceEvents?: EvidenceEvent[]): WorkTaskDetailProjection | null;
+export interface WorkGoldenPathRunLifecycleResult {
+    status: 'redrivable' | 'refused' | 'not_available';
+    action: 'retry' | 'resume';
+    runId: string | null;
+    reason: string | null;
+    goldenPath: WorkGoldenPathDetailProjection | null;
+}
+/**
+ * Retries or resumes a golden-path Run from Desktop (SPEC-114 FR-29, FR-35).
+ *
+ * Desktop performs the state transition; it does not drive the run. The host
+ * that owns the runner picks the Run up, exactly as it does for a Telegram
+ * retry, so there is one driver rather than one per surface.
+ */
+export declare function applyWorkGoldenPathRunLifecycle(dependencies: WorkApiDependencies, taskId: string, action: 'retry' | 'resume'): Promise<WorkGoldenPathRunLifecycleResult>;
+export interface WorkGoldenPathRetryDeliveryResult {
+    status: 'delivered' | 'still_failing' | 'not_available';
+    reason: string | null;
+    goldenPath: WorkGoldenPathDetailProjection | null;
+}
+/**
+ * Re-drives a delivery the transport could not complete (SPEC-114 FR-46).
+ *
+ * The outbox row remains the idempotency record, so a row that already reached
+ * `sent` is returned untouched rather than sent again.
+ */
+export declare function retryWorkGoldenPathDelivery(dependencies: WorkApiDependencies, taskId: string): Promise<WorkGoldenPathRetryDeliveryResult>;
+export declare function createWorkTaskDetailPayload(core: Awaited<ReturnType<CoreStore['readCore']>>, taskId: string, evidenceEvents?: EvidenceEvent[], deliveryReader?: TransportWorkDeliveryReader): WorkTaskDetailProjection | null;
 export declare function createWorkSupervisedRunPayload(dependencies: WorkApiDependencies, taskId: string): Promise<WorkSupervisedRunLaunchProjection>;
 export declare function createWorkSupervisedRunLifecycleActionPayload(dependencies: WorkApiDependencies, taskId: string, action: WorkSupervisedRunLifecycleAction): Promise<WorkSupervisedRunLaunchProjection>;
 export declare function createWorkProjectListPayload(core: Awaited<ReturnType<CoreStore['readCore']>>): import("./projection.js").WorkProjectListProjection;

package/build/server/products/work/api/index.d.ts.map

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

package/build/server/products/work/api/index.js

@@ -1,3 +1,5 @@
+import { applyWorkGoldenPathLifecycleAction } from '../state/workGoldenPathLifecycle.js';
+import { buildWorkGoldenPathDetailProjectionForTask, } from './goldenPathProjection.js';
 import { CoreConflictError, CoreNotFoundError, } from '../../../core/errors.js';
 import { appendCoreTrace, upsertCoreRun } from '../../../core/model/index.js';
 import { handleCoreError } from '../../../core/api/shared.js';
@@ -14,7 +16,7 @@ import { routeWorkProductCrudApi } from './productCrudRoutes.js';
 import { routeWorkRunCancellationApi } from './runCancellationRoutes.js';
 import { routeWorkScheduleApi } from './scheduleRoutes.js';
 import { matchRoute, sendJson, sendMethodNotAllowed, } from '../../../shared/http.js';
-import { WORK_API_MISSION_DETAIL_PATTERN, WORK_API_MISSIONS_PATH, WORK_API_PREFIX, WORK_API_PROJECT_DETAIL_PATTERN, WORK_API_PROJECTS_PATH, WORK_API_RUNS_PATH, WORK_API_TASK_DETAIL_PATTERN, WORK_API_TASK_SUPERVISED_RUN_ACTION_PATTERN, WORK_API_TASK_SUPERVISED_RUN_PATTERN, WORK_API_TASKS_PATH, WORK_API_WORK_ITEM_DETAIL_PATTERN, WORK_API_WORK_ITEMS_PATH, } from '../shared/apiPaths.js';
+import { WORK_API_MISSION_DETAIL_PATTERN, WORK_API_MISSIONS_PATH, WORK_API_PREFIX, WORK_API_PROJECT_DETAIL_PATTERN, WORK_API_PROJECTS_PATH, WORK_API_RUNS_PATH, WORK_API_TASK_DETAIL_PATTERN, WORK_API_TASK_SUPERVISED_RUN_ACTION_PATTERN, WORK_API_TASK_GOLDEN_PATH_LIFECYCLE_PATTERN, WORK_API_TASK_GOLDEN_PATH_RETRY_DELIVERY_PATTERN, WORK_API_TASK_SUPERVISED_RUN_PATTERN, WORK_API_DELIVERY_READINESS_PATH, WORK_API_DELIVERY_TELEMETRY_PATH, WORK_API_TASKS_PATH, WORK_API_WORK_ITEM_DETAIL_PATTERN, WORK_API_WORK_ITEMS_PATH, } from '../shared/apiPaths.js';
 export const WORK_API_SLICE = 'work';
 const WORK_SUPERVISED_RUN_PARENT_BUDGET = {
     maxTokens: 120_000,
@@ -29,9 +31,101 @@ const WORK_SUPERVISED_RUN_DEFAULT_BUDGET = {
 export function createWorkDashboardPayload(core) {
     return buildWorkDashboardProjection(core);
 }
-export function createWorkTaskDetailPayload(core, taskId, evidenceEvents = []) {
+/**
+ * Retries or resumes a golden-path Run from Desktop (SPEC-114 FR-29, FR-35).
+ *
+ * Desktop performs the state transition; it does not drive the run. The host
+ * that owns the runner picks the Run up, exactly as it does for a Telegram
+ * retry, so there is one driver rather than one per surface.
+ */
+export async function applyWorkGoldenPathRunLifecycle(dependencies, taskId, action) {
+    const core = await dependencies.coreStore.readCore();
+    const projection = buildWorkGoldenPathDetailProjectionForTask({
+        core,
+        taskId,
+        deliveryReader: dependencies.transportWorkDelivery,
+    });
+    if (projection === null) {
+        return {
+            status: 'not_available',
+            action,
+            runId: null,
+            reason: `Task ${taskId} did not arrive through a transport.`,
+            goldenPath: null,
+        };
+    }
+    const result = await applyWorkGoldenPathLifecycleAction(dependencies.coreStore, {
+        workItemId: projection.workItemId,
+        action,
+        actorRef: 'actor-work-golden-path',
+        ownerActorId: core.ownerProfile.actorId,
+    }, dependencies.now);
+    return {
+        status: result.status === 'refused' ? 'refused' : 'redrivable',
+        action,
+        runId: result.runId,
+        reason: result.reason,
+        goldenPath: buildWorkGoldenPathDetailProjectionForTask({
+            core: await dependencies.coreStore.readCore(),
+            taskId,
+            deliveryReader: dependencies.transportWorkDelivery,
+        }),
+    };
+}
+/**
+ * Re-drives a delivery the transport could not complete (SPEC-114 FR-46).
+ *
+ * The outbox row remains the idempotency record, so a row that already reached
+ * `sent` is returned untouched rather than sent again.
+ */
+export async function retryWorkGoldenPathDelivery(dependencies, taskId) {
+    const recovery = dependencies.transportWorkDelivery;
+    if (recovery === undefined || typeof recovery.retry !== 'function') {
+        return {
+            status: 'not_available',
+            reason: 'No transport delivery outbox is available on this host.',
+            goldenPath: null,
+        };
+    }
+    const core = await dependencies.coreStore.readCore();
+    const projection = buildWorkGoldenPathDetailProjectionForTask({
+        core,
+        taskId,
+        deliveryReader: recovery,
+    });
+    if (projection === null) {
+        return {
+            status: 'not_available',
+            reason: `Task ${taskId} did not arrive through a transport.`,
+            goldenPath: null,
+        };
+    }
+    const pending = projection.delivery.attempts.find((attempt) => (attempt.purpose === 'result' || attempt.purpose === 'publish_result')
+        && attempt.state !== 'sent');
+    if (pending === undefined) {
+        return {
+            status: 'not_available',
+            reason: 'There is no failed delivery to retry.',
+            goldenPath: projection,
+        };
+    }
+    const flushed = await recovery.retry(pending.idempotencyKey);
+    const refreshed = buildWorkGoldenPathDetailProjectionForTask({
+        core: await dependencies.coreStore.readCore(),
+        taskId,
+        deliveryReader: recovery,
+    });
+    return {
+        status: flushed.row.state === 'sent' ? 'delivered' : 'still_failing',
+        reason: flushed.row.state === 'sent' ? null : flushed.row.lastErrorCode,
+        goldenPath: refreshed,
+    };
+}
+export function createWorkTaskDetailPayload(core, taskId, evidenceEvents = [], deliveryReader) {
     const task = core.tasks.find((candidate) => candidate.id === taskId) ?? null;
-    return task ? buildWorkTaskDetailProjection(core, task, evidenceEvents) : null;
+    return task
+        ? buildWorkTaskDetailProjection(core, task, evidenceEvents, deliveryReader)
+        : null;
 }
 export async function createWorkSupervisedRunPayload(dependencies, taskId) {
     const now = dependencies.now?.() ?? new Date();
@@ -288,6 +382,42 @@ export async function routeWorkApi(context) {
         sendJson(context.response, 200, createWorkWorkItemListPayload(await context.dependencies.coreStore.readCore()));
         return true;
     }
+    if (context.url.pathname === WORK_API_DELIVERY_READINESS_PATH) {
+        if (context.method !== 'GET') {
+            sendMethodNotAllowed(context.response, ['GET']);
+            return true;
+        }
+        const reader = context.dependencies.transportWorkReadiness;
+        if (reader === undefined) {
+            sendJson(context.response, 200, {
+                enabled: false,
+                workspacePath: null,
+                authorizedOwnerCount: 0,
+                localExecution: 'unknown',
+                bindings: [],
+            });
+            return true;
+        }
+        try {
+            sendJson(context.response, 200, await reader.describe());
+        }
+        catch (error) {
+            handleCoreError(context, error);
+        }
+        return true;
+    }
+    if (context.url.pathname === WORK_API_DELIVERY_TELEMETRY_PATH) {
+        if (context.method !== 'GET') {
+            sendMethodNotAllowed(context.response, ['GET']);
+            return true;
+        }
+        const telemetry = context.dependencies.transportWorkTelemetry;
+        sendJson(context.response, 200, {
+            enabled: telemetry !== undefined,
+            snapshot: telemetry?.snapshot() ?? null,
+        });
+        return true;
+    }
     if (context.url.pathname === WORK_API_TASKS_PATH) {
         if (context.method !== 'GET') {
             sendMethodNotAllowed(context.response, ['GET']);
@@ -342,6 +472,54 @@ export async function routeWorkApi(context) {
         sendJson(context.response, 200, detail);
         return true;
     }
+    const goldenPathLifecycleMatch = matchRoute(context.url.pathname, WORK_API_TASK_GOLDEN_PATH_LIFECYCLE_PATTERN);
+    if (goldenPathLifecycleMatch) {
+        if (context.method !== 'POST') {
+            sendMethodNotAllowed(context.response, ['POST']);
+            return true;
+        }
+        const taskId = goldenPathLifecycleMatch[0];
+        const action = goldenPathLifecycleMatch[1];
+        if (!taskId || !action) {
+            sendJson(context.response, 400, {
+                error: {
+                    code: 'invalid_golden_path_lifecycle_action',
+                    message: 'Task id and action are required.',
+                },
+            });
+            return true;
+        }
+        try {
+            const payload = await applyWorkGoldenPathRunLifecycle(context.dependencies, taskId, action);
+            sendJson(context.response, payload.status === 'refused' ? 409 : 200, payload);
+        }
+        catch (error) {
+            handleCoreError(context, error);
+        }
+        return true;
+    }
+    const goldenPathRetryMatch = matchRoute(context.url.pathname, WORK_API_TASK_GOLDEN_PATH_RETRY_DELIVERY_PATTERN);
+    if (goldenPathRetryMatch) {
+        if (context.method !== 'POST') {
+            sendMethodNotAllowed(context.response, ['POST']);
+            return true;
+        }
+        const taskId = goldenPathRetryMatch[0];
+        if (!taskId) {
+            sendJson(context.response, 400, {
+                error: { code: 'invalid_task_id', message: 'Task id is required.' },
+            });
+            return true;
+        }
+        try {
+            const payload = await retryWorkGoldenPathDelivery(context.dependencies, taskId);
+            sendJson(context.response, payload.status === 'not_available' ? 409 : 200, payload);
+        }
+        catch (error) {
+            handleCoreError(context, error);
+        }
+        return true;
+    }
     const supervisedRunActionMatch = matchRoute(context.url.pathname, WORK_API_TASK_SUPERVISED_RUN_ACTION_PATTERN);
     if (supervisedRunActionMatch) {
         if (context.method !== 'POST') {
@@ -409,7 +587,7 @@ export async function routeWorkApi(context) {
             ? context.dependencies.readEvidenceEvents?.(task.conversationId) ?? []
             : [];
         const payload = task
-            ? buildWorkTaskDetailProjection(core, task, evidenceEvents)
+            ? buildWorkTaskDetailProjection(core, task, evidenceEvents, context.dependencies.transportWorkDelivery)
             : null;
         if (!payload) {
             sendJson(context.response, 404, {