@xfey/tutti 0.1.94 → 0.1.95

package/dist/server-shell/http/routes/project-api/execution-routes.js

@@ -1,9 +1,11 @@
-import { CursorPageRequestSchema, ExecutionStatusProjectionSchema, GetRecoverySummariesRequestSchema, GetRecoverySummariesResponseSchema, GetRecoverySummaryResponseSchema, TaskDetailProjectionSchema, TaskProjectionSchema, TaskRunResultsPageSchema, } from "@tutti/shared/schemas/api";
+import { CursorPageRequestSchema, ExecutionStatusProjectionSchema, GetRecoverySummariesRequestSchema, GetRecoverySummariesResponseSchema, GetRecoverySummaryResponseSchema, TaskDetailProjectionSchema, TaskProjectionSchema, TaskRunResultsPageSchema, RetryTaskBodySchema, RetryTaskResponseSchema, } from "@tutti/shared/schemas/api";
 import { createIdleExecutionStatusProjection, readRecoverySummariesPage, readRecoverySummaryProjection, readTaskDetailProjection, readTaskProjection, readTaskRunResultsPage, } from "../../../../collaboration-state/index.js";
+import { executeIdempotentCommand } from "../../../command-idempotency/index.js";
 import { HOST_PROJECT_API_BASE_PATH } from "./constants.js";
 import { HostProjectNotFoundError } from "./errors.js";
 import { RecoverySummaryParamsSchema, TaskParamsSchema, } from "./schemas.js";
-import { requireHostProjectSession, requireProjectStore, } from "./session-requirements.js";
+import { requireControlPlane, requireHostProjectSession, requireProjectStore, } from "./session-requirements.js";
+import { taskRetryInvalidates } from "./invalidations.js";
 export function registerExecutionRoutes(app, options) {
     app.get(`${HOST_PROJECT_API_BASE_PATH}/tasks/:taskId/detail`, {
         schema: {
@@ -36,6 +38,34 @@ export function registerExecutionRoutes(app, options) {
         }
         return page;
     });
+    app.post(`${HOST_PROJECT_API_BASE_PATH}/tasks/:taskId/retry`, {
+        schema: {
+            params: TaskParamsSchema,
+            body: RetryTaskBodySchema,
+            response: { 200: RetryTaskResponseSchema },
+        },
+    }, (request) => {
+        requireHostProjectSession(request, options);
+        const store = requireProjectStore(options);
+        const controlPlane = requireControlPlane(options);
+        const execution = executeIdempotentCommand({
+            db: store.db,
+            command_id: request.body.command_id,
+            command_name: "task.retry",
+            target_ref: request.body.payload.expected_latest_run_result_id,
+            payload: {
+                task_id: request.params.taskId,
+                ...request.body.payload,
+            },
+            ...(options.now === undefined ? {} : { now: options.now }),
+            execute: () => controlPlane.retryTask(request.params.taskId, request.body.payload),
+        });
+        return {
+            command_id: execution.command_id,
+            disposition: execution.disposition,
+            invalidates: taskRetryInvalidates(request.params.taskId),
+        };
+    });
     app.get(`${HOST_PROJECT_API_BASE_PATH}/recovery-summaries`, {
         schema: {
             querystring: GetRecoverySummariesRequestSchema,

package/dist/server-shell/http/routes/project-api/invalidations.d.ts

@@ -1,8 +1,9 @@
-import type { ClarificationRoundRef } from "@tutti/shared/ids";
+import type { ClarificationRoundRef, TaskId } from "@tutti/shared/ids";
 import type { QueryInvalidationHint, RunSchedulerNowDisposition } from "@tutti/shared/schemas/api";
 export declare function mainChatMessageInvalidates(): QueryInvalidationHint[];
 export declare function worklistSubmitInvalidates(): QueryInvalidationHint[];
 export declare function schedulerRunNowInvalidates(disposition: RunSchedulerNowDisposition): QueryInvalidationHint[];
+export declare function taskRetryInvalidates(taskId: TaskId): QueryInvalidationHint[];
 export declare function clarificationRoundInvalidates(roundId: ClarificationRoundRef): QueryInvalidationHint[];
 export declare function approvalInvalidates(): QueryInvalidationHint[];
 export declare function readStateInvalidates(): QueryInvalidationHint[];

package/dist/server-shell/http/routes/project-api/invalidations.js

@@ -31,6 +31,19 @@ export function schedulerRunNowInvalidates(disposition) {
         { kind: "task_run_results", task_id: disposition.task_id },
     ];
 }
+export function taskRetryInvalidates(taskId) {
+    return [
+        { kind: "worklist" },
+        { kind: "task", task_id: taskId },
+        { kind: "task_detail", task_id: taskId },
+        { kind: "task_run_results", task_id: taskId },
+        { kind: "execution_status" },
+        { kind: "messages", scope: "main_chat" },
+        { kind: "project_timeline" },
+        { kind: "read_state" },
+        { kind: "bootstrap" },
+    ];
+}
 export function clarificationRoundInvalidates(roundId) {
     return [
         { kind: "clarification", round_id: roundId },

package/dist/server-shell/http/routes/project-api/openapi-execution-routes.d.ts

@@ -24,6 +24,7 @@ export declare const HOST_PROJECT_EXECUTION_OPENAPI_ROUTES: ({
         };
     };
     querystring?: never;
+    requestBody?: never;
 } | {
     method: "get";
     path: string;
@@ -87,6 +88,7 @@ export declare const HOST_PROJECT_EXECUTION_OPENAPI_ROUTES: ({
                         }>>;
                         error_code: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                         retryable: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+                        retry_action: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"retryable">, import("@sinclair/typebox").TLiteral<"retried">]>>;
                         updated_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                     }>;
                     frozen_contract_since_activity_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
@@ -96,6 +98,7 @@ export declare const HOST_PROJECT_EXECUTION_OPENAPI_ROUTES: ({
         };
     };
     querystring?: never;
+    requestBody?: never;
 } | {
     method: "get";
     path: string;
@@ -112,6 +115,21 @@ export declare const HOST_PROJECT_EXECUTION_OPENAPI_ROUTES: ({
             schema: import("@sinclair/typebox").TSchema;
         };
     };
+    requestBody?: never;
+} | {
+    method: "post";
+    path: string;
+    summary: string;
+    tags: string[];
+    parameters: import("@tutti/shared/schemas/api").BrowserFacingOpenApiParameter[];
+    requestBody: import("@sinclair/typebox").TSchema;
+    responses: {
+        200: {
+            description: string;
+            schema: import("@sinclair/typebox").TSchema;
+        };
+    };
+    querystring?: never;
 } | {
     method: "get";
     path: string;
@@ -128,6 +146,7 @@ export declare const HOST_PROJECT_EXECUTION_OPENAPI_ROUTES: ({
         };
     };
     parameters?: never;
+    requestBody?: never;
 } | {
     method: "get";
     path: string;
@@ -149,6 +168,7 @@ export declare const HOST_PROJECT_EXECUTION_OPENAPI_ROUTES: ({
         };
     };
     querystring?: never;
+    requestBody?: never;
 } | {
     method: "get";
     path: string;
@@ -228,5 +248,6 @@ export declare const HOST_PROJECT_EXECUTION_OPENAPI_ROUTES: ({
     };
     parameters?: never;
     querystring?: never;
+    requestBody?: never;
 })[];
 //# sourceMappingURL=openapi-execution-routes.d.ts.map

package/dist/server-shell/http/routes/project-api/openapi-execution-routes.js

@@ -1,4 +1,4 @@
-import { CursorPageRequestSchema, ExecutionStatusProjectionSchema, GetRecoverySummariesRequestSchema, GetRecoverySummariesResponseSchema, GetRecoverySummaryResponseSchema, TaskDetailProjectionSchema, TaskProjectionSchema, TaskRunResultsPageSchema, } from "@tutti/shared/schemas/api";
+import { CursorPageRequestSchema, ExecutionStatusProjectionSchema, GetRecoverySummariesRequestSchema, GetRecoverySummariesResponseSchema, GetRecoverySummaryResponseSchema, RetryTaskBodySchema, RetryTaskResponseSchema, TaskDetailProjectionSchema, TaskProjectionSchema, TaskRunResultsPageSchema, } from "@tutti/shared/schemas/api";
 import { HOST_PROJECT_API_BASE_PATH } from "./constants.js";
 import { RecoverySummaryIdPathParameter, TaskIdPathParameter, } from "./openapi-path-parameters.js";
 export const HOST_PROJECT_EXECUTION_OPENAPI_ROUTES = [
@@ -33,6 +33,17 @@ export const HOST_PROJECT_EXECUTION_OPENAPI_ROUTES = [
             200: { description: "Task run result history page.", schema: TaskRunResultsPageSchema },
         },
     },
+    {
+        method: "post",
+        path: `${HOST_PROJECT_API_BASE_PATH}/tasks/{task_id}/retry`,
+        summary: "Retry the latest safely recoverable terminal failed task result.",
+        tags: ["tasks"],
+        parameters: [TaskIdPathParameter],
+        requestBody: RetryTaskBodySchema,
+        responses: {
+            200: { description: "Task Retry command response.", schema: RetryTaskResponseSchema },
+        },
+    },
     {
         method: "get",
         path: `${HOST_PROJECT_API_BASE_PATH}/recovery-summaries`,

package/dist/server-shell/http/routes/project-api/openapi.d.ts

@@ -653,6 +653,7 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
         };
     };
     querystring?: never;
+    requestBody?: never;
 } | {
     method: "get";
     path: string;
@@ -716,6 +717,7 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
                         }>>;
                         error_code: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                         retryable: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+                        retry_action: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"retryable">, import("@sinclair/typebox").TLiteral<"retried">]>>;
                         updated_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                     }>;
                     frozen_contract_since_activity_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
@@ -725,6 +727,7 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
         };
     };
     querystring?: never;
+    requestBody?: never;
 } | {
     method: "get";
     path: string;
@@ -741,6 +744,7 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
             schema: import("@sinclair/typebox").TSchema;
         };
     };
+    requestBody?: never;
 } | {
     method: "get";
     path: string;
@@ -757,6 +761,7 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
         };
     };
     parameters?: never;
+    requestBody?: never;
 } | {
     method: "get";
     path: string;
@@ -778,6 +783,7 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
         };
     };
     querystring?: never;
+    requestBody?: never;
 } | {
     method: "get";
     path: string;
@@ -857,6 +863,7 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
     };
     parameters?: never;
     querystring?: never;
+    requestBody?: never;
 } | {
     method: "get";
     path: string;

package/node_modules/@tutti/shared/dist/schemas/api/clarifications.d.ts

@@ -589,6 +589,7 @@ export declare const SendClarificationRoundMessageResultSchema: import("@sinclai
                     media_type: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                 }>>>;
                 error_code: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                retry_action: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"retryable">, import("@sinclair/typebox").TLiteral<"retried">]>>;
             }>>;
             artifact_preview: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
                 kind: import("@sinclair/typebox").TLiteral<"artifact_preview">;

package/node_modules/@tutti/shared/dist/schemas/api/index.d.ts

@@ -16,5 +16,5 @@ export { GetProjectDocRequestSchema, GetProjectDocResponseSchema, GetProjectDocs
 export { ArtifactKindSchema, ArtifactManifestSchema, ArtifactPreviewProjectionSchema, ArtifactPreviewStatusSchema, ArtifactServerManifestSchema, ArtifactStaticManifestSchema, ArtifactSummaryProjectionSchema, ArtifactTitleSchema, ArtifactProjectionSchema, GetArtifactsResponseSchema, IssueArtifactPreviewSessionBodySchema, IssueArtifactPreviewSessionDispositionSchema, IssueArtifactPreviewSessionPayloadSchema, IssueArtifactPreviewSessionResponseSchema, IssueArtifactPreviewSessionResultSchema, } from "./artifacts.js";
 export { DeleteSkillBodySchema, DeleteSkillDispositionSchema, DeleteSkillPayloadSchema, DeleteSkillResponseSchema, GetSkillParamsSchema, GetSkillResponseSchema, GetSkillsResponseSchema, ImportSkillZipBodySchema, ImportSkillZipDispositionSchema, ImportSkillZipPayloadSchema, ImportSkillZipResponseSchema, ImportSkillZipResultSchema, SkillDetailProjectionSchema, SkillNameSchema, SkillProjectionSchema, } from "./skills.js";
 export { ActivityEventProjectionSchema, ActivityEventSsePayloadSchema, ApprovalChangedEventPayloadSchema, ActivityProjectionSchema, ConnectionReadyEventPayloadSchema, ExecutionActivitySummarySchema, ExecutionStatusChangedEventPayloadSchema, ExecutionStatusKindSchema, ExecutionStatusProjectionSchema, ProcedureLaneSchema, ProviderConfigChangedEventPayloadSchema, QueryInvalidateEventPayloadSchema, ScratchpadUpdatedEventPayloadSchema, TaskDetailUpdatedEventPayloadSchema, TaskUpdatedEventPayloadSchema, WorklistChangedEventPayloadSchema, WorkspaceRecoveredEventPayloadSchema, } from "./runtime-events.js";
-export { ContextSyncBodySchema, ContextSyncDispositionSchema, ContextSyncPayloadSchema, ContextSyncResponseSchema, ContextSyncResultSchema, InitializeProjectDocsBodySchema, InitializeProjectDocsDispositionSchema, InitializeProjectDocsPayloadSchema, InitializeProjectDocsResponseSchema, InitializeProjectDocsResultSchema, ProjectDocsProcedureStartResultSchema, RefreshScratchpadDispositionSchema, RefreshScratchpadResultSchema, RunSchedulerNowBodySchema, RunSchedulerNowDispositionSchema, RunSchedulerNowPayloadSchema, RunSchedulerNowResponseSchema, SubmitWorklistBodySchema, SubmitWorklistDispositionSchema, SubmitWorklistPayloadSchema, SubmitWorklistResponseSchema, SubmitWorklistResultSchema, UpdateProjectDescriptionBodySchema, UpdateProjectDescriptionDispositionSchema, UpdateProjectDescriptionPayloadSchema, UpdateProjectDescriptionResponseSchema, UpdateProjectDescriptionResultSchema, UpdateProjectDisplayNameBodySchema, UpdateProjectDisplayNameDispositionSchema, UpdateProjectDisplayNamePayloadSchema, UpdateProjectDisplayNameResponseSchema, UpdateProjectDisplayNameResultSchema, } from "./workspace-commands.js";
+export { ContextSyncBodySchema, ContextSyncDispositionSchema, ContextSyncPayloadSchema, ContextSyncResponseSchema, ContextSyncResultSchema, InitializeProjectDocsBodySchema, InitializeProjectDocsDispositionSchema, InitializeProjectDocsPayloadSchema, InitializeProjectDocsResponseSchema, InitializeProjectDocsResultSchema, ProjectDocsProcedureStartResultSchema, RefreshScratchpadDispositionSchema, RefreshScratchpadResultSchema, RunSchedulerNowBodySchema, RunSchedulerNowDispositionSchema, RunSchedulerNowPayloadSchema, RunSchedulerNowResponseSchema, RetryTaskBodySchema, RetryTaskDispositionSchema, RetryTaskPayloadSchema, RetryTaskResponseSchema, SubmitWorklistBodySchema, SubmitWorklistDispositionSchema, SubmitWorklistPayloadSchema, SubmitWorklistResponseSchema, SubmitWorklistResultSchema, UpdateProjectDescriptionBodySchema, UpdateProjectDescriptionDispositionSchema, UpdateProjectDescriptionPayloadSchema, UpdateProjectDescriptionResponseSchema, UpdateProjectDescriptionResultSchema, UpdateProjectDisplayNameBodySchema, UpdateProjectDisplayNameDispositionSchema, UpdateProjectDisplayNamePayloadSchema, UpdateProjectDisplayNameResponseSchema, UpdateProjectDisplayNameResultSchema, } from "./workspace-commands.js";
 //# sourceMappingURL=index.d.ts.map

package/node_modules/@tutti/shared/dist/schemas/api/index.js

@@ -14,5 +14,5 @@ export { GetProjectDocRequestSchema, GetProjectDocResponseSchema, GetProjectDocs
 export { ArtifactKindSchema, ArtifactManifestSchema, ArtifactPreviewProjectionSchema, ArtifactPreviewStatusSchema, ArtifactServerManifestSchema, ArtifactStaticManifestSchema, ArtifactSummaryProjectionSchema, ArtifactTitleSchema, ArtifactProjectionSchema, GetArtifactsResponseSchema, IssueArtifactPreviewSessionBodySchema, IssueArtifactPreviewSessionDispositionSchema, IssueArtifactPreviewSessionPayloadSchema, IssueArtifactPreviewSessionResponseSchema, IssueArtifactPreviewSessionResultSchema, } from "./artifacts.js";
 export { DeleteSkillBodySchema, DeleteSkillDispositionSchema, DeleteSkillPayloadSchema, DeleteSkillResponseSchema, GetSkillParamsSchema, GetSkillResponseSchema, GetSkillsResponseSchema, ImportSkillZipBodySchema, ImportSkillZipDispositionSchema, ImportSkillZipPayloadSchema, ImportSkillZipResponseSchema, ImportSkillZipResultSchema, SkillDetailProjectionSchema, SkillNameSchema, SkillProjectionSchema, } from "./skills.js";
 export { ActivityEventProjectionSchema, ActivityEventSsePayloadSchema, ApprovalChangedEventPayloadSchema, ActivityProjectionSchema, ConnectionReadyEventPayloadSchema, ExecutionActivitySummarySchema, ExecutionStatusChangedEventPayloadSchema, ExecutionStatusKindSchema, ExecutionStatusProjectionSchema, ProcedureLaneSchema, ProviderConfigChangedEventPayloadSchema, QueryInvalidateEventPayloadSchema, ScratchpadUpdatedEventPayloadSchema, TaskDetailUpdatedEventPayloadSchema, TaskUpdatedEventPayloadSchema, WorklistChangedEventPayloadSchema, WorkspaceRecoveredEventPayloadSchema, } from "./runtime-events.js";
-export { ContextSyncBodySchema, ContextSyncDispositionSchema, ContextSyncPayloadSchema, ContextSyncResponseSchema, ContextSyncResultSchema, InitializeProjectDocsBodySchema, InitializeProjectDocsDispositionSchema, InitializeProjectDocsPayloadSchema, InitializeProjectDocsResponseSchema, InitializeProjectDocsResultSchema, ProjectDocsProcedureStartResultSchema, RefreshScratchpadDispositionSchema, RefreshScratchpadResultSchema, RunSchedulerNowBodySchema, RunSchedulerNowDispositionSchema, RunSchedulerNowPayloadSchema, RunSchedulerNowResponseSchema, SubmitWorklistBodySchema, SubmitWorklistDispositionSchema, SubmitWorklistPayloadSchema, SubmitWorklistResponseSchema, SubmitWorklistResultSchema, UpdateProjectDescriptionBodySchema, UpdateProjectDescriptionDispositionSchema, UpdateProjectDescriptionPayloadSchema, UpdateProjectDescriptionResponseSchema, UpdateProjectDescriptionResultSchema, UpdateProjectDisplayNameBodySchema, UpdateProjectDisplayNameDispositionSchema, UpdateProjectDisplayNamePayloadSchema, UpdateProjectDisplayNameResponseSchema, UpdateProjectDisplayNameResultSchema, } from "./workspace-commands.js";
+export { ContextSyncBodySchema, ContextSyncDispositionSchema, ContextSyncPayloadSchema, ContextSyncResponseSchema, ContextSyncResultSchema, InitializeProjectDocsBodySchema, InitializeProjectDocsDispositionSchema, InitializeProjectDocsPayloadSchema, InitializeProjectDocsResponseSchema, InitializeProjectDocsResultSchema, ProjectDocsProcedureStartResultSchema, RefreshScratchpadDispositionSchema, RefreshScratchpadResultSchema, RunSchedulerNowBodySchema, RunSchedulerNowDispositionSchema, RunSchedulerNowPayloadSchema, RunSchedulerNowResponseSchema, RetryTaskBodySchema, RetryTaskDispositionSchema, RetryTaskPayloadSchema, RetryTaskResponseSchema, SubmitWorklistBodySchema, SubmitWorklistDispositionSchema, SubmitWorklistPayloadSchema, SubmitWorklistResponseSchema, SubmitWorklistResultSchema, UpdateProjectDescriptionBodySchema, UpdateProjectDescriptionDispositionSchema, UpdateProjectDescriptionPayloadSchema, UpdateProjectDescriptionResponseSchema, UpdateProjectDescriptionResultSchema, UpdateProjectDisplayNameBodySchema, UpdateProjectDisplayNameDispositionSchema, UpdateProjectDisplayNamePayloadSchema, UpdateProjectDisplayNameResponseSchema, UpdateProjectDisplayNameResultSchema, } from "./workspace-commands.js";
 //# sourceMappingURL=index.js.map

package/node_modules/@tutti/shared/dist/schemas/api/messages.d.ts

@@ -109,6 +109,7 @@ export declare const TaskResultRefSchema: import("@sinclair/typebox").TObject<{
         media_type: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     }>>>;
     error_code: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    retry_action: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"retryable">, import("@sinclair/typebox").TLiteral<"retried">]>>;
 }>;
 export declare const WorklistCompileRefSchema: import("@sinclair/typebox").TObject<{
     kind: import("@sinclair/typebox").TLiteral<"worklist_compile">;
@@ -214,6 +215,7 @@ export declare const MessageRefsSchema: import("@sinclair/typebox").TObject<{
             media_type: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
         }>>>;
         error_code: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        retry_action: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"retryable">, import("@sinclair/typebox").TLiteral<"retried">]>>;
     }>>;
     artifact_preview: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
         kind: import("@sinclair/typebox").TLiteral<"artifact_preview">;
@@ -331,6 +333,7 @@ export declare const MessageProjectionSchema: import("@sinclair/typebox").TObjec
                 media_type: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
             }>>>;
             error_code: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            retry_action: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"retryable">, import("@sinclair/typebox").TLiteral<"retried">]>>;
         }>>;
         artifact_preview: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
             kind: import("@sinclair/typebox").TLiteral<"artifact_preview">;
@@ -472,6 +475,7 @@ export declare const SendMainChatMessageResultSchema: import("@sinclair/typebox"
                     media_type: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                 }>>>;
                 error_code: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                retry_action: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"retryable">, import("@sinclair/typebox").TLiteral<"retried">]>>;
             }>>;
             artifact_preview: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
                 kind: import("@sinclair/typebox").TLiteral<"artifact_preview">;
@@ -610,6 +614,7 @@ export declare const MessageCreatedEventPayloadSchema: import("@sinclair/typebox
                     media_type: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                 }>>>;
                 error_code: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                retry_action: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"retryable">, import("@sinclair/typebox").TLiteral<"retried">]>>;
             }>>;
             artifact_preview: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
                 kind: import("@sinclair/typebox").TLiteral<"artifact_preview">;

package/node_modules/@tutti/shared/dist/schemas/api/messages.js

@@ -106,6 +106,7 @@ export const TaskResultRefSchema = Type.Object({
     final_note: Type.Optional(Type.String()),
     generated_files: Type.Optional(Type.Array(WorklistFeedbackGeneratedFileSchema)),
     error_code: Type.Optional(NonEmptyStringSchema),
+    retry_action: Type.Optional(Type.Union([Type.Literal("retryable"), Type.Literal("retried")])),
 }, { additionalProperties: false });
 export const WorklistCompileRefSchema = Type.Object({
     kind: Type.Literal("worklist_compile"),

package/node_modules/@tutti/shared/dist/schemas/api/runtime-events.d.ts

@@ -490,6 +490,7 @@ export declare const TaskDetailUpdatedEventPayloadSchema: import("@sinclair/type
                 }>>;
                 error_code: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                 retryable: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+                retry_action: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"retryable">, import("@sinclair/typebox").TLiteral<"retried">]>>;
                 updated_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
             }>;
             frozen_contract_since_activity_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;

package/node_modules/@tutti/shared/dist/schemas/api/types.d.ts

@@ -14,7 +14,7 @@ import type { GetProjectDocRequestSchema, GetProjectDocResponseSchema, GetProjec
 import type { ArtifactKindSchema, ArtifactManifestSchema, ArtifactPreviewProjectionSchema, ArtifactPreviewStatusSchema, ArtifactProjectionSchema, ArtifactServerManifestSchema, ArtifactStaticManifestSchema, ArtifactSummaryProjectionSchema, GetArtifactsResponseSchema, IssueArtifactPreviewSessionDispositionSchema, IssueArtifactPreviewSessionPayloadSchema, IssueArtifactPreviewSessionResultSchema } from "./artifacts.js";
 import type { DeleteSkillDispositionSchema, DeleteSkillPayloadSchema, GetSkillParamsSchema, GetSkillResponseSchema, GetSkillsResponseSchema, ImportSkillZipDispositionSchema, ImportSkillZipPayloadSchema, ImportSkillZipResultSchema, SkillDetailProjectionSchema, SkillNameSchema, SkillProjectionSchema } from "./skills.js";
 import type { ActivityEventProjectionSchema, ActivityEventSsePayloadSchema, ApprovalChangedEventPayloadSchema, ActivityProjectionSchema, ConnectionReadyEventPayloadSchema, ExecutionActivitySummarySchema, ExecutionRuntimeActionSchema, ExecutionRuntimeSnapshotSchema, ExecutionRuntimeTokenUsageSchema, ExecutionStatusChangedEventPayloadSchema, ExecutionStatusKindSchema, ExecutionStatusProjectionSchema, ProcedureLaneSchema, ProviderConfigChangedEventPayloadSchema, QueryInvalidateEventPayloadSchema, ScratchpadUpdatedEventPayloadSchema, TaskDetailUpdatedEventPayloadSchema, TaskUpdatedEventPayloadSchema, WorklistChangedEventPayloadSchema, WorkspaceRecoveredEventPayloadSchema } from "./runtime-events.js";
-import type { ContextSyncDispositionSchema, ContextSyncPayloadSchema, ContextSyncResultSchema, InitializeProjectDocsDispositionSchema, InitializeProjectDocsPayloadSchema, InitializeProjectDocsResultSchema, RefreshScratchpadDispositionSchema, RefreshScratchpadResultSchema, RunSchedulerNowDispositionSchema, RunSchedulerNowPayloadSchema, SubmitWorklistDispositionSchema, SubmitWorklistPayloadSchema, SubmitWorklistResultSchema, UpdateProjectDescriptionDispositionSchema, UpdateProjectDescriptionPayloadSchema, UpdateProjectDescriptionResultSchema, UpdateProjectDisplayNameDispositionSchema, UpdateProjectDisplayNamePayloadSchema, UpdateProjectDisplayNameResultSchema } from "./workspace-commands.js";
+import type { ContextSyncDispositionSchema, ContextSyncPayloadSchema, ContextSyncResultSchema, InitializeProjectDocsDispositionSchema, InitializeProjectDocsPayloadSchema, InitializeProjectDocsResultSchema, RefreshScratchpadDispositionSchema, RefreshScratchpadResultSchema, RunSchedulerNowDispositionSchema, RunSchedulerNowPayloadSchema, RetryTaskDispositionSchema, RetryTaskPayloadSchema, SubmitWorklistDispositionSchema, SubmitWorklistPayloadSchema, SubmitWorklistResultSchema, UpdateProjectDescriptionDispositionSchema, UpdateProjectDescriptionPayloadSchema, UpdateProjectDescriptionResultSchema, UpdateProjectDisplayNameDispositionSchema, UpdateProjectDisplayNamePayloadSchema, UpdateProjectDisplayNameResultSchema } from "./workspace-commands.js";
 export type CursorPageRequest = Static<typeof CursorPageRequestSchema>;
 export type CursorPage<TItem> = {
     items: TItem[];
@@ -225,6 +225,9 @@ export type IssueArtifactPreviewSessionResponse = CommandResponse<IssueArtifactP
 export type RunSchedulerNowPayload = Static<typeof RunSchedulerNowPayloadSchema>;
 export type RunSchedulerNowDisposition = Static<typeof RunSchedulerNowDispositionSchema>;
 export type RunSchedulerNowResponse = CommandResponse<RunSchedulerNowDisposition>;
+export type RetryTaskPayload = Static<typeof RetryTaskPayloadSchema>;
+export type RetryTaskDisposition = Static<typeof RetryTaskDispositionSchema>;
+export type RetryTaskResponse = CommandResponse<RetryTaskDisposition>;
 export type UpdateProjectDisplayNamePayload = Static<typeof UpdateProjectDisplayNamePayloadSchema>;
 export type UpdateProjectDisplayNameDisposition = Static<typeof UpdateProjectDisplayNameDispositionSchema>;
 export type UpdateProjectDisplayNameResult = Static<typeof UpdateProjectDisplayNameResultSchema>;

package/node_modules/@tutti/shared/dist/schemas/api/viewer-reference.d.ts

@@ -487,6 +487,7 @@ export declare const UploadReferenceFileResultSchema: import("@sinclair/typebox"
                     media_type: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                 }>>>;
                 error_code: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                retry_action: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"retryable">, import("@sinclair/typebox").TLiteral<"retried">]>>;
             }>>;
             artifact_preview: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
                 kind: import("@sinclair/typebox").TLiteral<"artifact_preview">;

package/node_modules/@tutti/shared/dist/schemas/api/work-items.d.ts

@@ -171,6 +171,7 @@ export declare const TaskDetailResultProjectionSchema: import("@sinclair/typebox
     }>>;
     error_code: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     retryable: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    retry_action: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"retryable">, import("@sinclair/typebox").TLiteral<"retried">]>>;
     updated_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
 }>;
 export declare const TaskDetailProjectionSchema: import("@sinclair/typebox").TObject<{
@@ -227,6 +228,7 @@ export declare const TaskDetailProjectionSchema: import("@sinclair/typebox").TOb
             }>>;
             error_code: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
             retryable: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+            retry_action: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"retryable">, import("@sinclair/typebox").TLiteral<"retried">]>>;
             updated_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
         }>;
         frozen_contract_since_activity_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
@@ -272,6 +274,7 @@ export declare const RunResultProjectionSchema: import("@sinclair/typebox").TUni
         started_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
         finished_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     }>>>;
+    retry_action: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"retryable">, import("@sinclair/typebox").TLiteral<"retried">]>>;
     created_at: import("@sinclair/typebox").TString;
 }>, import("@sinclair/typebox").TObject<{
     id: import("@sinclair/typebox").TString;
@@ -287,6 +290,7 @@ export declare const RunResultProjectionSchema: import("@sinclair/typebox").TUni
     summary: import("@sinclair/typebox").TString;
     error_code: import("@sinclair/typebox").TString;
     retryable: import("@sinclair/typebox").TBoolean;
+    retry_action: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"retryable">, import("@sinclair/typebox").TLiteral<"retried">]>>;
     created_at: import("@sinclair/typebox").TString;
 }>]>;
 export declare const TaskRunResultsPageSchema: import("@sinclair/typebox").TSchema;

package/node_modules/@tutti/shared/dist/schemas/api/work-items.js

@@ -149,6 +149,7 @@ export const TaskDetailResultProjectionSchema = Type.Object({
     }, { additionalProperties: false })),
     error_code: Type.Optional(NonEmptyStringSchema),
     retryable: Type.Optional(Type.Boolean()),
+    retry_action: Type.Optional(Type.Union([Type.Literal("retryable"), Type.Literal("retried")])),
     updated_at: Type.Optional(IsoDateTimeStringSchema),
 }, { additionalProperties: false });
 export const TaskDetailProjectionSchema = Type.Object({
@@ -191,6 +192,7 @@ export const RunResultProjectionSchema = Type.Union([
         skip_reason_code: Type.Optional(CheckSkipReasonCodeSchema),
         skip_reason_summary: Type.Optional(Type.String()),
         external_side_effects: Type.Optional(Type.Array(ExternalSideEffectSummaryProjectionSchema)),
+        retry_action: Type.Optional(Type.Union([Type.Literal("retryable"), Type.Literal("retried")])),
         created_at: IsoDateTimeStringSchema,
     }, { additionalProperties: false }),
     Type.Object({
@@ -202,6 +204,7 @@ export const RunResultProjectionSchema = Type.Union([
         summary: Type.String(),
         error_code: NonEmptyStringSchema,
         retryable: Type.Boolean(),
+        retry_action: Type.Optional(Type.Union([Type.Literal("retryable"), Type.Literal("retried")])),
         created_at: IsoDateTimeStringSchema,
     }, { additionalProperties: false }),
 ]);

package/node_modules/@tutti/shared/dist/schemas/api/workspace-commands.d.ts

@@ -145,6 +145,39 @@ export declare const RunSchedulerNowDispositionSchema: import("@sinclair/typebox
 }>]>;
 export declare const RunSchedulerNowBodySchema: import("@sinclair/typebox").TSchema;
 export declare const RunSchedulerNowResponseSchema: import("@sinclair/typebox").TSchema;
+export declare const RetryTaskPayloadSchema: import("@sinclair/typebox").TObject<{
+    expected_latest_run_result_id: import("@sinclair/typebox").TString;
+}>;
+export declare const RetryTaskDispositionSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+    kind: import("@sinclair/typebox").TLiteral<"accepted">;
+    task_id: import("@sinclair/typebox").TString;
+    activity_ref: import("@sinclair/typebox").TString;
+    retried_run_result_id: import("@sinclair/typebox").TString;
+}>, import("@sinclair/typebox").TObject<{
+    kind: import("@sinclair/typebox").TLiteral<"already_running">;
+    activity_ref: import("@sinclair/typebox").TString;
+}>, import("@sinclair/typebox").TObject<{
+    kind: import("@sinclair/typebox").TLiteral<"task_not_failed">;
+}>, import("@sinclair/typebox").TObject<{
+    kind: import("@sinclair/typebox").TLiteral<"latest_run_result_changed">;
+    latest_run_result_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>, import("@sinclair/typebox").TObject<{
+    kind: import("@sinclair/typebox").TLiteral<"retry_already_started">;
+    activity_ref: import("@sinclair/typebox").TString;
+}>, import("@sinclair/typebox").TObject<{
+    kind: import("@sinclair/typebox").TLiteral<"retry_requires_resolution">;
+}>, import("@sinclair/typebox").TObject<{
+    kind: import("@sinclair/typebox").TLiteral<"provider_not_configured">;
+}>, import("@sinclair/typebox").TObject<{
+    kind: import("@sinclair/typebox").TLiteral<"provider_unavailable">;
+    reason: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"provider_auth_invalid">, import("@sinclair/typebox").TLiteral<"provider_quota_or_billing_required">, import("@sinclair/typebox").TLiteral<"provider_rate_limited">, import("@sinclair/typebox").TLiteral<"provider_model_unavailable">, import("@sinclair/typebox").TLiteral<"provider_network_error">, import("@sinclair/typebox").TLiteral<"unknown">]>;
+    retryable: import("@sinclair/typebox").TBoolean;
+}>, import("@sinclair/typebox").TObject<{
+    kind: import("@sinclair/typebox").TLiteral<"interrupted">;
+    retry_with_new_command_id: import("@sinclair/typebox").TLiteral<true>;
+}>]>;
+export declare const RetryTaskBodySchema: import("@sinclair/typebox").TSchema;
+export declare const RetryTaskResponseSchema: import("@sinclair/typebox").TSchema;
 export declare const UpdateProjectDisplayNamePayloadSchema: import("@sinclair/typebox").TObject<{
     display_name: import("@sinclair/typebox").TString;
 }>;

package/node_modules/@tutti/shared/dist/schemas/api/workspace-commands.js

@@ -1,5 +1,5 @@
 import { Type } from "@sinclair/typebox";
-import { ActivityRefSchema, ClarificationRoundRefSchema, ClarificationThreadRefSchema, IsoDateTimeStringSchema, TaskIdSchema, WorkflowInvocationRefSchema, } from "../domain/index.js";
+import { ActivityRefSchema, ClarificationRoundRefSchema, ClarificationThreadRefSchema, IsoDateTimeStringSchema, TaskIdSchema, RunResultIdSchema, WorkflowInvocationRefSchema, } from "../domain/index.js";
 import { ProviderUnavailableReasonCodeSchema } from "./provider-config.js";
 import { InterruptedCommandDispositionSchema, NonEmptyStringSchema, commandEnvelopeSchema, commandResponseSchema, commandResponseWithResultSchema, } from "./primitives.js";
 import { ProjectDocSummaryProjectionSchema, ViewerPathSchema, } from "./viewer-reference.js";
@@ -84,6 +84,40 @@ export const RunSchedulerNowDispositionSchema = Type.Union([
 ]);
 export const RunSchedulerNowBodySchema = commandEnvelopeSchema(RunSchedulerNowPayloadSchema);
 export const RunSchedulerNowResponseSchema = commandResponseSchema(RunSchedulerNowDispositionSchema);
+export const RetryTaskPayloadSchema = Type.Object({
+    expected_latest_run_result_id: RunResultIdSchema,
+}, { additionalProperties: false });
+export const RetryTaskDispositionSchema = Type.Union([
+    Type.Object({
+        kind: Type.Literal("accepted"),
+        task_id: TaskIdSchema,
+        activity_ref: ActivityRefSchema,
+        retried_run_result_id: RunResultIdSchema,
+    }, { additionalProperties: false }),
+    Type.Object({
+        kind: Type.Literal("already_running"),
+        activity_ref: ActivityRefSchema,
+    }, { additionalProperties: false }),
+    Type.Object({ kind: Type.Literal("task_not_failed") }, { additionalProperties: false }),
+    Type.Object({
+        kind: Type.Literal("latest_run_result_changed"),
+        latest_run_result_id: Type.Optional(RunResultIdSchema),
+    }, { additionalProperties: false }),
+    Type.Object({
+        kind: Type.Literal("retry_already_started"),
+        activity_ref: ActivityRefSchema,
+    }, { additionalProperties: false }),
+    Type.Object({ kind: Type.Literal("retry_requires_resolution") }, { additionalProperties: false }),
+    Type.Object({ kind: Type.Literal("provider_not_configured") }, { additionalProperties: false }),
+    Type.Object({
+        kind: Type.Literal("provider_unavailable"),
+        reason: ProviderUnavailableReasonCodeSchema,
+        retryable: Type.Boolean(),
+    }, { additionalProperties: false }),
+    InterruptedCommandDispositionSchema,
+]);
+export const RetryTaskBodySchema = commandEnvelopeSchema(RetryTaskPayloadSchema);
+export const RetryTaskResponseSchema = commandResponseSchema(RetryTaskDispositionSchema);
 export const UpdateProjectDisplayNamePayloadSchema = Type.Object({
     display_name: Type.String({ minLength: 1, maxLength: 80 }),
 }, { additionalProperties: false });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xfey/tutti",
-  "version": "0.1.94",
+  "version": "0.1.95",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/prompts/runs/README.md

@@ -1,21 +1,16 @@
 # runs
 
-These templates are used by task `Run` execution.
+Formal Task execution uses one durable Task-scoped Codex Thread and four templates:
 
-- `task-run.md` is rendered for initial task Runs.
-- `task-continuation.md` is rendered for Phase 8 continuation Runs after task-bound clarification.
-- `task-retry.md` is rendered for bounded Run pipeline self-correction retries after feedback such as no candidate diff before or after checks, Artifact validation failure, failed checks, or accepted-checkpoint failure. It is not a failed-task follow-up path and does not resurrect `Task.failed`.
-  Templates in this directory may describe task contracts, repo evidence, check expectations, artifact declaration rules, and documentation update responsibilities. They must never include provider credentials or host-local secret material.
+- `task-execute.md` supplies the Task goal, scope, pinned source material, workspace rules, documentation rules, Artifact contract, and safety boundary. It runs with workspace write access and no structured output schema.
+- `task-finalize.md` is a short read-only instruction that asks Codex to describe the work already completed using `task-result-contract.md` and the current turn output schema.
+- `task-recovery.md` combines the concrete bounded failure evidence with the complete result contract. Output-only failures run read-only; candidate, Artifact, or checks failures may run with workspace write access.
+- `task-result-contract.md` is the single human-readable definition of the four mutually exclusive Task result branches and must stay aligned with `TASK_RUN_OUTPUT_SCHEMA`.
 
-`task-run.md` keeps implementation judgment inside the frozen contract with Codex. Human clarification is reserved for interpreting contract intent, choosing among incompatible requirements or source facts, supplying required non-secret context, relaxing an explicit constraint, or accepting a material risk or external effect. Technical difficulty, tooling failure, and validation failure stay with the Run when they can be handled; otherwise the result is `failed`, not a question for the user. If the task contract does not require repository file changes, the output can use `completed_no_repo_changes`; otherwise a completed implementation is expected to produce a candidate diff. If the candidate is complete but Codex self-validation commands are unavailable or blocked, the task-run output should still be `completed`; Tutti checks are the authoritative validation gate.
-Initial `task-run.md`, active `task-continuation.md`, and active pipeline `task-retry.md` receive the compact task contract fields `title / goal / scope` plus optional receipt-derived `source_messages`, completed Task Compile `clarification_rounds`, and `recent_references`. Source messages and clarification answers preserve the exact submitted material in ordered `role / optional author_display_name / text` entries; each reference includes only path, final name and available/unavailable summary. The contract defines execution scope, while these fields supply exact content referenced by it. Continuation adds the required task-bound `continuation` block, and pipeline self-correction retry adds the required `correction` block with the previous failure summary, machine-generated reason code, correction guidance, a required redacted / bounded diagnostic, and `promotion_failure` as either a complete object or explicit `null`. Provider transient retry and self-correction both preserve all compile-time source context. Provider-facing prompts do not receive task ids, task summaries, Run lineage, workflow anchors, blob ids, message ids, changed paths, docs status, checks status, or the safety audit context entry.
-All three Run templates use a slim mutually exclusive structured output schema under `result`: exactly one of `completed.{summary,user_note_candidate}`, `completed_no_repo_changes.{summary,user_note_candidate}`, `needs_human.{title,summary,request}`, or `failed.summary`. The `summary` is a concise, human-readable result note for project members who may not inspect the code. Completed branches also require `user_note_candidate`, which is either a short user-facing final-card sentence or `null`; it must not repeat `summary` or include file paths. Checks, docs, promotion, changed paths, and other Tutti status stay in structured fields derived by the Run pipeline. They do not ask Codex to self-report docs status or changed paths; both come from Run pipeline Git diff and derived projection.
-Run templates describe `docs/reference/` as a user-visible file exchange area. Human uploads remain under `docs/reference/files/` and `docs/reference/images/`; `docs/reference/tutti/**` is for Tutti-generated files intended for direct member review in References, not temporary output, internal notes, logs, or canonical project documentation. Generated user-visible files must be written under `docs/reference/tutti/`, with `docs/reference/tutti/<meaningful-folder>/...` used when the folder name should be shown as a References UI group. Generated files under `docs/reference/tutti/` are discovered from promoted changed paths, rendered by References automatically, and may be listed in completed task result cards.
-Initial `task-run.md`, active `task-continuation.md`, and active pipeline `task-retry.md` also instruct Codex to write or update the single active `tutti.artifact.json` manifest only when the task creates or updates a member-viewable visual artifact. Each template includes the complete strict static and server JSON shapes: every behavior field is required, `network` is always an explicit boolean, and server `script / ready_path / port` fields are forbidden. A server package instead declares the fixed `artifact:preview` npm script in its own `package.json` and listens on the injected `HOST / PORT`. The manifest remains repo truth and is not reported through the structured output schema.
-Active task-bound follow-up still only starts continuation Runs from `Run.needs_human`. `follow_up_check` resumes when the identified human decision is resolved in the same contract, asks for more input only while that same decision remains unresolved, and requires retasking when honoring the answer would change goal or scope; it does not delegate Run-owned implementation choices. Continuation applies the same Run boundary after considering the answers and never repeats a resolved question. Pipeline self-correction retry happens before a terminal Run result is recorded; it treats correction as machine feedback, repairs it inside the frozen contract by default, and only returns `needs_human` when the feedback exposes a genuinely unresolved human decision under the normal Run boundary.
-All three templates state that cwd is the persistent project workspace, may contain unaccepted source and project-local runtime/dependency state from earlier failed attempts, and must not be reset, checked out, stashed, cleaned, or otherwise discarded. Continuation, provider transient retry, and self-correction reuse that same directory and accumulated state.
-All three templates require a final Git status inspection and make the Agent responsible for maintaining the repository's own `.gitignore` according to project conventions. They do not prescribe runtime path names or force intentional generated source out of Git.
+Initial Execute receives compact `title / goal / scope` plus pinned `source_messages`, completed Task Compile `clarification_rounds`, and `recent_references` when present. Continuation Execute reuses the same Thread and adds only the sealed clarification outcome and resume summary. Finalize does not repeat Task context or implementation instructions.
 
-Provider transient retry is separate from self-correction. If a retryable Codex app-server workspace-write failure occurs before usable structured output, Run pipeline may rerun the same prompt family once in the same project workspace: initial Runs stay on `task-run.md`, continuation Runs stay on `task-continuation.md`, and self-correction attempts stay on `task-retry.md`. This retry does not add `RunCorrectionContext` unless the failed attempt was already a self-correction attempt.
-Run templates are responsible for telling Codex to update related project documentation in the same candidate workspace whenever implementation changes stable project facts. Broader cleanup, fact reconciliation, and phase-level documentation maintenance belong to the independent `context_sync` Procedure.
-Successful source-changing Runs create an accepted commit and immutable `tutti/accepted/<activity_ref>` tag after Artifact validation and checks. Prompt templates do not own staging, commit/tag creation, recovery, or promotion semantics.
+Recovery retains the previous valid Task result or bounded raw final output together with the actual parser, Artifact, candidate, or checks diagnostic. Failure evidence never replaces the complete result contract. Attempt numbers, command ids, member identity, Activity ids, session paths, and Thread lifecycle details stay outside model context.
+
+Only a schema-valid Finalize or Recovery `needs_human` result can open task-bound clarification. Execute handoff text never opens clarification by itself.
+
+Task session state is machine-local and outside the repository. Prompt templates must never include provider credentials, Host-local session paths, raw secrets, or browser capability tokens. Checks, changed paths, documentation status, and accepted checkpoint state remain Host-derived facts rather than model claims.