@xfey/tutti 0.1.95 → 0.1.97

package/dist/collaboration-state/index.d.ts

@@ -2,8 +2,8 @@ export { CollaborationStateCursorError } from "./serialization.js";
 export { createIdleExecutionStatusProjection } from "./execution-status.js";
 export { createMainChatAgentMessage, createMainChatMessage, createMainChatSystemMessage, ensureInitialProjectWelcomeMessage, hasMainChatArtifactPreviewMessage, hasMainChatTaskResultMessage, hasMainChatWorklistCompileMessage, hasMainChatWorklistFeedbackMessage, readCompletedWorklistFeedbackTaskIds, readMessageProjectionById, readMainChatMessageWindow, readMainChatMessagesBeforeCursor, readMainChatMessagesForScratchpadCycle, } from "./messages.js";
 export { createEmptyScratchpadProjection, readScratchpadReceiptSourceRefs, readScratchpadProjection, upsertScratchpadProjection, } from "./scratchpad.js";
-export { markScratchpadRefreshFailed, markScratchpadRefreshStarted, markScratchpadRefreshSucceeded, markScratchpadSourceDirty, readScratchpadSourceState, } from "./scratchpad-source-state.js";
-export { captureTaskCompileContext, completeTaskCompileContext, readActiveTaskCompileContext, readCurrentScratchpadSourceRefs, rollbackTaskCompileContext, taskCompileContextSnapshot, } from "./task-compile-context.js";
+export { markScratchpadRefreshFailed, markScratchpadRefreshStarted, markScratchpadRefreshSucceeded, markScratchpadSourceDirty, recoverStaleScratchpadRefresh, readScratchpadSourceState, } from "./scratchpad-source-state.js";
+export { captureTaskCompileContext, completeTaskCompileContext, readActiveTaskCompileContext, readCurrentScratchpadSourceRefs, readPendingTaskCompileSubmission, recordTaskCompileSubmission, rollbackTaskCompileContext, taskCompileContextSnapshot, } from "./task-compile-context.js";
 export { deleteStaleClarificationSubmitReplayHints, readActiveClarificationProjection, readClarificationRoundProjection, readClarificationRoundsForThread, readClarificationThreadResponse, readTaskCompileClarificationRoundsByWorkflowRef, readSealedClarificationRoundsWithoutSuccessor, } from "./clarification-records.js";
 export { createClarificationRoundAgentMessage, createClarificationRoundMessage, readClarificationRoundMessagesWindow, } from "./clarification-messages.js";
 export { openNextTaskBoundClarificationRound, openNextTaskCompileClarificationRound, openTaskCompileClarificationRound, } from "./clarification-rounds.js";
@@ -12,9 +12,9 @@ export { readRecoverySummariesPage, readRecoverySummaryProjection, readRunResult
 export { recordRunNeedsHumanResult, recordRunResult } from "./run-recording.js";
 export { materializeTaskRetryRun, readMaterializedTaskRetry } from "./task-retry.js";
 export type { MaterializeTaskRetryResult } from "./task-retry.js";
-export { readStaleRunningTaskIdentities, recoverStaleRunningTasksAsFailed, } from "./recovery.js";
+export { readStaleRunningTaskIdentities, recoverStaleRunningTasksAsFailed } from "./recovery.js";
 export { markReadStateScope, readReadStateSummary, recordReadNotificationEvent, } from "./read-state.js";
 export { readTaskDetailProjection } from "./task-details.js";
-export { applyTaskCompileProposal, markTaskRunStarted, readNextRunnableTask, readRecoverableScheduledRun, readCompiledTaskSummariesByWorkflowRef, readTaskProjection, readWorklistProjection, } from "./worklist.js";
-export type { ApplyTaskCompileProposalResult, CloseTaskBoundClarificationRetaskingRequiredInput, CloseTaskBoundClarificationRetaskingRequiredResult, CreateClarificationRoundAgentMessageInput, CreateClarificationRoundMessageInput, CreateMainChatAgentMessageInput, CreateMainChatMessageInput, CreateMainChatSystemMessageInput, CursorPageOptions, MarkReadStateScopeInput, MarkReadStateScopeResult, MarkTaskRunStartedInput, MarkTaskRunStartedResult, MaterializeClarificationSuccessorInput, MaterializeTaskBoundRunSuccessorInput, MaterializeTaskBoundRunSuccessorResult, MessageAuthorInput, NextRunnableTaskResult, OpenNextTaskBoundClarificationRoundInput, OpenNextTaskBoundClarificationRoundResult, OpenNextTaskCompileClarificationRoundInput, OpenNextTaskCompileClarificationRoundResult, OpenTaskCompileClarificationRoundInput, OpenTaskCompileClarificationRoundResult, ReadMessageWindowOptions, ReadReadStateSummaryInput, RecoverStaleRunningTasksResult, RecoverableScheduledRun, RecordReadNotificationEventInput, RecordRecoverySummaryInput, RecordRecoverySummaryResult, RecordRunNeedsHumanResultInput, RecordRunNeedsHumanResultResult, RecordRunResultInput, RecordRunResultResult, RunResultPromotionProjection, ScratchpadSnapshotInput, ScratchpadContentSnapshot, ScratchpadSourceRefInput, CaptureTaskCompileContextInput, CompleteTaskCompileContextInput, RollbackTaskCompileContextInput, TaskCompileContextRecord, SealedClarificationRoundWithoutSuccessor, SubmitClarificationRoundInput, TaskCompileProposalInput, TaskCompileProposalModuleInput, TaskCompileProposalTaskInput, } from "./types.js";
+export { applyTaskCompileProposal, markTaskRunStarted, readNextRunnableTask, readRecoverableScheduledRun, readCompiledTaskSummariesByWorkflowRef, readTaskProjection, readTaskProjectionByActivityRef, readWorklistProjection, } from "./worklist.js";
+export type { ApplyTaskCompileProposalResult, CloseTaskBoundClarificationRetaskingRequiredInput, CloseTaskBoundClarificationRetaskingRequiredResult, CreateClarificationRoundAgentMessageInput, CreateClarificationRoundMessageInput, CreateMainChatAgentMessageInput, CreateMainChatMessageInput, CreateMainChatSystemMessageInput, CursorPageOptions, MarkReadStateScopeInput, MarkReadStateScopeResult, MarkTaskRunStartedInput, MarkTaskRunStartedResult, MaterializeClarificationSuccessorInput, MaterializeTaskBoundRunSuccessorInput, MaterializeTaskBoundRunSuccessorResult, MessageAuthorInput, NextRunnableTaskResult, OpenNextTaskBoundClarificationRoundInput, OpenNextTaskBoundClarificationRoundResult, OpenNextTaskCompileClarificationRoundInput, OpenNextTaskCompileClarificationRoundResult, OpenTaskCompileClarificationRoundInput, OpenTaskCompileClarificationRoundResult, ReadMessageWindowOptions, ReadReadStateSummaryInput, RecoverStaleRunningTasksResult, RecoverableScheduledRun, RecordReadNotificationEventInput, RecordRecoverySummaryInput, RecordRecoverySummaryResult, RecordRunNeedsHumanResultInput, RecordRunNeedsHumanResultResult, RecordRunResultInput, RecordRunResultResult, RunResultPromotionProjection, ScratchpadSnapshotInput, ScratchpadContentSnapshot, ScratchpadSourceRefInput, CaptureTaskCompileContextInput, CompleteTaskCompileContextInput, RecordTaskCompileSubmissionInput, RollbackTaskCompileContextInput, TaskCompileContextRecord, TaskCompileSubmissionRecord, SealedClarificationRoundWithoutSuccessor, SubmitClarificationRoundInput, TaskCompileProposalInput, TaskCompileProposalModuleInput, TaskCompileProposalTaskInput, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/collaboration-state/index.js

@@ -2,8 +2,8 @@ export { CollaborationStateCursorError } from "./serialization.js";
 export { createIdleExecutionStatusProjection } from "./execution-status.js";
 export { createMainChatAgentMessage, createMainChatMessage, createMainChatSystemMessage, ensureInitialProjectWelcomeMessage, hasMainChatArtifactPreviewMessage, hasMainChatTaskResultMessage, hasMainChatWorklistCompileMessage, hasMainChatWorklistFeedbackMessage, readCompletedWorklistFeedbackTaskIds, readMessageProjectionById, readMainChatMessageWindow, readMainChatMessagesBeforeCursor, readMainChatMessagesForScratchpadCycle, } from "./messages.js";
 export { createEmptyScratchpadProjection, readScratchpadReceiptSourceRefs, readScratchpadProjection, upsertScratchpadProjection, } from "./scratchpad.js";
-export { markScratchpadRefreshFailed, markScratchpadRefreshStarted, markScratchpadRefreshSucceeded, markScratchpadSourceDirty, readScratchpadSourceState, } from "./scratchpad-source-state.js";
-export { captureTaskCompileContext, completeTaskCompileContext, readActiveTaskCompileContext, readCurrentScratchpadSourceRefs, rollbackTaskCompileContext, taskCompileContextSnapshot, } from "./task-compile-context.js";
+export { markScratchpadRefreshFailed, markScratchpadRefreshStarted, markScratchpadRefreshSucceeded, markScratchpadSourceDirty, recoverStaleScratchpadRefresh, readScratchpadSourceState, } from "./scratchpad-source-state.js";
+export { captureTaskCompileContext, completeTaskCompileContext, readActiveTaskCompileContext, readCurrentScratchpadSourceRefs, readPendingTaskCompileSubmission, recordTaskCompileSubmission, rollbackTaskCompileContext, taskCompileContextSnapshot, } from "./task-compile-context.js";
 export { deleteStaleClarificationSubmitReplayHints, readActiveClarificationProjection, readClarificationRoundProjection, readClarificationRoundsForThread, readClarificationThreadResponse, readTaskCompileClarificationRoundsByWorkflowRef, readSealedClarificationRoundsWithoutSuccessor, } from "./clarification-records.js";
 export { createClarificationRoundAgentMessage, createClarificationRoundMessage, readClarificationRoundMessagesWindow, } from "./clarification-messages.js";
 export { openNextTaskBoundClarificationRound, openNextTaskCompileClarificationRound, openTaskCompileClarificationRound, } from "./clarification-rounds.js";
@@ -11,8 +11,8 @@ export { closeTaskBoundClarificationAsRetaskingRequired, materializeClarificatio
 export { readRecoverySummariesPage, readRecoverySummaryProjection, readRunResultProjectionByActivityRef, readTaskRunResultsPage, recordRecoverySummary, } from "./run-results.js";
 export { recordRunNeedsHumanResult, recordRunResult } from "./run-recording.js";
 export { materializeTaskRetryRun, readMaterializedTaskRetry } from "./task-retry.js";
-export { readStaleRunningTaskIdentities, recoverStaleRunningTasksAsFailed, } from "./recovery.js";
+export { readStaleRunningTaskIdentities, recoverStaleRunningTasksAsFailed } from "./recovery.js";
 export { markReadStateScope, readReadStateSummary, recordReadNotificationEvent, } from "./read-state.js";
 export { readTaskDetailProjection } from "./task-details.js";
-export { applyTaskCompileProposal, markTaskRunStarted, readNextRunnableTask, readRecoverableScheduledRun, readCompiledTaskSummariesByWorkflowRef, readTaskProjection, readWorklistProjection, } from "./worklist.js";
+export { applyTaskCompileProposal, markTaskRunStarted, readNextRunnableTask, readRecoverableScheduledRun, readCompiledTaskSummariesByWorkflowRef, readTaskProjection, readTaskProjectionByActivityRef, readWorklistProjection, } from "./worklist.js";
 //# sourceMappingURL=index.js.map

package/dist/collaboration-state/scratchpad-source-state.d.ts

@@ -1,4 +1,4 @@
-import type { ActivityRef, MessageId } from "@tutti/shared/ids";
+import type { ActivityRef, ControlPlaneIntentId, MessageId } from "@tutti/shared/ids";
 import type { SqliteDatabase } from "../store/index.js";
 export type ScratchpadMainChatCursor = {
     created_at: string;
@@ -11,6 +11,7 @@ export type ScratchpadSourceState = {
     in_flight?: {
         activity_ref: ActivityRef;
         started_at: string;
+        intent_id?: ControlPlaneIntentId;
     };
     backoff_until?: string;
     last_completed_at?: string;
@@ -26,6 +27,7 @@ export declare function markScratchpadSourceDirty(db: SqliteDatabase, input?: {
 }): ScratchpadSourceState;
 export declare function markScratchpadRefreshStarted(db: SqliteDatabase, input: {
     activityRef: ActivityRef;
+    intentId?: ControlPlaneIntentId;
     now?: () => Date;
 }): ScratchpadSourceState;
 export declare function markScratchpadRefreshSucceeded(db: SqliteDatabase, input: ScratchpadSourceCursorUpdate & {
@@ -35,4 +37,7 @@ export declare function markScratchpadRefreshFailed(db: SqliteDatabase, input?:
     backoffUntil?: string;
     now?: () => Date;
 }): ScratchpadSourceState;
+export declare function recoverStaleScratchpadRefresh(db: SqliteDatabase, input?: {
+    now?: () => Date;
+}): boolean;
 //# sourceMappingURL=scratchpad-source-state.d.ts.map

package/dist/collaboration-state/scratchpad-source-state.js

@@ -4,8 +4,7 @@ function mapScratchpadSourceStateRow(row) {
     if (row === undefined) {
         return state;
     }
-    if (row.cycle_start_cursor_created_at !== null &&
-        row.cycle_start_cursor_message_id !== null) {
+    if (row.cycle_start_cursor_created_at !== null && row.cycle_start_cursor_message_id !== null) {
         state.cycle_start_cursor = {
             created_at: row.cycle_start_cursor_created_at,
             message_id: row.cycle_start_cursor_message_id,
@@ -25,6 +24,9 @@ function mapScratchpadSourceStateRow(row) {
         state.in_flight = {
             activity_ref: row.in_flight_activity_ref,
             started_at: row.in_flight_started_at,
+            ...(row.in_flight_intent_id === null
+                ? {}
+                : { intent_id: row.in_flight_intent_id }),
         };
     }
     if (row.backoff_until !== null) {
@@ -74,6 +76,7 @@ export function readScratchpadSourceState(db) {
           dirty_since,
           in_flight_activity_ref,
           in_flight_started_at,
+          in_flight_intent_id,
           last_completed_at,
           last_failed_at,
           backoff_until,
@@ -107,14 +110,16 @@ export function markScratchpadRefreshStarted(db, input) {
         id,
         in_flight_activity_ref,
         in_flight_started_at,
+        in_flight_intent_id,
         updated_at
       )
-      VALUES ('current', ?, ?, ?)
+      VALUES ('current', ?, ?, ?, ?)
       ON CONFLICT(id) DO UPDATE SET
         in_flight_activity_ref = excluded.in_flight_activity_ref,
         in_flight_started_at = excluded.in_flight_started_at,
+        in_flight_intent_id = excluded.in_flight_intent_id,
         updated_at = excluded.updated_at
-    `).run(input.activityRef, updatedAt, updatedAt);
+    `).run(input.activityRef, updatedAt, input.intentId ?? null, updatedAt);
     return readScratchpadSourceState(db);
 }
 export function markScratchpadRefreshSucceeded(db, input) {
@@ -130,17 +135,19 @@ export function markScratchpadRefreshSucceeded(db, input) {
         dirty_since,
         in_flight_activity_ref,
         in_flight_started_at,
+        in_flight_intent_id,
         last_completed_at,
         backoff_until,
         updated_at
       )
-      VALUES ('current', ?, ?, ?, NULL, NULL, ?, NULL, ?)
+      VALUES ('current', ?, ?, ?, NULL, NULL, NULL, ?, NULL, ?)
       ON CONFLICT(id) DO UPDATE SET
         refreshed_through_cursor_created_at = excluded.refreshed_through_cursor_created_at,
         refreshed_through_cursor_message_id = excluded.refreshed_through_cursor_message_id,
         dirty_since = excluded.dirty_since,
         in_flight_activity_ref = NULL,
         in_flight_started_at = NULL,
+        in_flight_intent_id = NULL,
         last_completed_at = excluded.last_completed_at,
         backoff_until = NULL,
         updated_at = excluded.updated_at
@@ -155,19 +162,43 @@ export function markScratchpadRefreshFailed(db, input = {}) {
         dirty_since,
         in_flight_activity_ref,
         in_flight_started_at,
+        in_flight_intent_id,
         last_failed_at,
         backoff_until,
         updated_at
       )
-      VALUES ('current', ?, NULL, NULL, ?, ?, ?)
+      VALUES ('current', ?, NULL, NULL, NULL, ?, ?, ?)
       ON CONFLICT(id) DO UPDATE SET
         dirty_since = COALESCE(scratchpad_source_state.dirty_since, excluded.dirty_since),
         in_flight_activity_ref = NULL,
         in_flight_started_at = NULL,
+        in_flight_intent_id = NULL,
         last_failed_at = excluded.last_failed_at,
         backoff_until = excluded.backoff_until,
         updated_at = excluded.updated_at
     `).run(updatedAt, updatedAt, input.backoffUntil ?? null, updatedAt);
     return readScratchpadSourceState(db);
 }
+export function recoverStaleScratchpadRefresh(db, input = {}) {
+    const current = readScratchpadSourceState(db);
+    if (current.in_flight === undefined) {
+        return false;
+    }
+    const updatedAt = nowIso(input.now);
+    const result = db
+        .prepare(`
+        UPDATE scratchpad_source_state
+        SET
+          dirty_since = COALESCE(dirty_since, in_flight_started_at, ?),
+          in_flight_activity_ref = NULL,
+          in_flight_started_at = NULL,
+          in_flight_intent_id = NULL,
+          last_failed_at = ?,
+          backoff_until = NULL,
+          updated_at = ?
+        WHERE id = 'current' AND in_flight_activity_ref = ?
+      `)
+        .run(updatedAt, updatedAt, updatedAt, current.in_flight.activity_ref);
+    return result.changes === 1;
+}
 //# sourceMappingURL=scratchpad-source-state.js.map

package/dist/collaboration-state/storage-types.d.ts

@@ -48,6 +48,7 @@ export type ScratchpadSourceStateRow = {
     dirty_since: string | null;
     in_flight_activity_ref: string | null;
     in_flight_started_at: string | null;
+    in_flight_intent_id: string | null;
     last_completed_at: string | null;
     last_failed_at: string | null;
     backoff_until: string | null;
@@ -73,6 +74,15 @@ export type ActiveTaskCompileContextSourceRow = {
     message_id: MessageId;
     created_at: string;
 };
+export type PendingTaskCompileSubmissionRow = {
+    workflow_ref: string;
+    accepted_activity_ref: string;
+    requested_at: string;
+    source_window_after_created_at: string | null;
+    source_window_after_message_id: string | null;
+    source_window_through_created_at: string | null;
+    source_window_through_message_id: string | null;
+};
 export type TaskModuleRow = {
     id: string;
     name: string;

package/dist/collaboration-state/task-compile-context.d.ts

@@ -1,8 +1,13 @@
-import type { WorkflowInvocationRef } from "@tutti/shared/ids";
+import type { MessageId, WorkflowInvocationRef } from "@tutti/shared/ids";
 import { type SqliteDatabase } from "../store/index.js";
-import type { CaptureTaskCompileContextInput, CompleteTaskCompileContextInput, RollbackTaskCompileContextInput, ScratchpadContentSnapshot, ScratchpadSourceRefInput, TaskCompileContextRecord } from "./types.js";
+import type { CaptureTaskCompileContextInput, CompleteTaskCompileContextInput, RecordTaskCompileSubmissionInput, RollbackTaskCompileContextInput, ScratchpadContentSnapshot, ScratchpadSourceRefInput, TaskCompileContextRecord, TaskCompileSubmissionRecord } from "./types.js";
+export declare function readPendingTaskCompileSubmission(db: SqliteDatabase, workflowRef?: WorkflowInvocationRef): TaskCompileSubmissionRecord | null;
+export declare function recordTaskCompileSubmission(db: SqliteDatabase, input: RecordTaskCompileSubmissionInput): TaskCompileSubmissionRecord;
 export declare function readActiveTaskCompileContext(db: SqliteDatabase, workflowRef?: WorkflowInvocationRef): TaskCompileContextRecord | null;
-export declare function readCurrentScratchpadSourceRefs(db: SqliteDatabase): ScratchpadSourceRefInput[];
+export declare function readCurrentScratchpadSourceRefs(db: SqliteDatabase, through?: {
+    created_at: string;
+    message_id: MessageId;
+}): ScratchpadSourceRefInput[];
 export declare function captureTaskCompileContext(db: SqliteDatabase, input: CaptureTaskCompileContextInput): TaskCompileContextRecord;
 export declare function completeTaskCompileContext(db: SqliteDatabase, input: CompleteTaskCompileContextInput): {
     updated_at?: string;

package/dist/collaboration-state/task-compile-context.js

@@ -49,8 +49,7 @@ function readContextRow(db) {
 }
 function mapContextRow(row, sources) {
     const sourceWindow = {};
-    if (row.source_window_after_created_at !== null &&
-        row.source_window_after_message_id !== null) {
+    if (row.source_window_after_created_at !== null && row.source_window_after_message_id !== null) {
         sourceWindow.after = {
             created_at: row.source_window_after_created_at,
             message_id: row.source_window_after_message_id,
@@ -92,6 +91,78 @@ function readContextSources(db, workflowRef) {
       `)
         .all(workflowRef);
 }
+function mapTaskCompileSubmissionRow(row) {
+    const sourceWindow = {};
+    if (row.source_window_after_created_at !== null && row.source_window_after_message_id !== null) {
+        sourceWindow.after = {
+            created_at: row.source_window_after_created_at,
+            message_id: row.source_window_after_message_id,
+        };
+    }
+    if (row.source_window_through_created_at !== null &&
+        row.source_window_through_message_id !== null) {
+        sourceWindow.through = {
+            created_at: row.source_window_through_created_at,
+            message_id: row.source_window_through_message_id,
+        };
+    }
+    return {
+        workflow_ref: row.workflow_ref,
+        accepted_activity_ref: row.accepted_activity_ref,
+        requested_at: row.requested_at,
+        source_window: sourceWindow,
+    };
+}
+export function readPendingTaskCompileSubmission(db, workflowRef) {
+    const row = db
+        .prepare(`
+        SELECT
+          workflow_ref,
+          accepted_activity_ref,
+          requested_at,
+          source_window_after_created_at,
+          source_window_after_message_id,
+          source_window_through_created_at,
+          source_window_through_message_id
+        FROM pending_task_compile_submissions
+        WHERE id = 'current'
+      `)
+        .get();
+    if (row === undefined || (workflowRef !== undefined && row.workflow_ref !== workflowRef)) {
+        return null;
+    }
+    return mapTaskCompileSubmissionRow(row);
+}
+export function recordTaskCompileSubmission(db, input) {
+    const existing = readPendingTaskCompileSubmission(db);
+    if (existing !== null) {
+        if (existing.workflow_ref === input.workflow_ref) {
+            return existing;
+        }
+        throw new Error("A pending Task Compile submission already exists");
+    }
+    if (readActiveTaskCompileContext(db) !== null) {
+        throw new Error("An active Task Compile Context already exists");
+    }
+    db.prepare(`
+      INSERT INTO pending_task_compile_submissions (
+        id,
+        workflow_ref,
+        accepted_activity_ref,
+        requested_at,
+        source_window_after_created_at,
+        source_window_after_message_id,
+        source_window_through_created_at,
+        source_window_through_message_id
+      )
+      VALUES ('current', ?, ?, ?, ?, ?, ?, ?)
+    `).run(input.workflow_ref, input.accepted_activity_ref, nowIso(input.now), input.source_window.after?.created_at ?? null, input.source_window.after?.message_id ?? null, input.source_window.through?.created_at ?? null, input.source_window.through?.message_id ?? null);
+    const recorded = readPendingTaskCompileSubmission(db, input.workflow_ref);
+    if (recorded === null) {
+        throw new Error("Failed to record pending Task Compile submission");
+    }
+    return recorded;
+}
 export function readActiveTaskCompileContext(db, workflowRef) {
     const row = readContextRow(db);
     if (row === undefined || (workflowRef !== undefined && row.workflow_ref !== workflowRef)) {
@@ -99,8 +170,8 @@ export function readActiveTaskCompileContext(db, workflowRef) {
     }
     return mapContextRow(row, readContextSources(db, row.workflow_ref));
 }
-export function readCurrentScratchpadSourceRefs(db) {
-    return db
+export function readCurrentScratchpadSourceRefs(db, through) {
+    const sources = db
         .prepare(`
         SELECT message_id, created_at
         FROM scratchpad_source_refs
@@ -114,6 +185,13 @@ export function readCurrentScratchpadSourceRefs(db) {
         source_scope: "main_chat",
         created_at: source.created_at,
     }));
+    if (through === undefined) {
+        return sources;
+    }
+    return sources.filter((source) => {
+        const timeOrder = source.created_at.localeCompare(through.created_at);
+        return timeOrder < 0 || (timeOrder === 0 && source.message_id <= through.message_id);
+    });
 }
 export function captureTaskCompileContext(db, input) {
     return withHostStoreTransaction(db, (tx) => {
@@ -129,12 +207,15 @@ export function captureTaskCompileContext(db, input) {
             throw new Error("A ready Scratchpad is required to capture Task Compile Context");
         }
         const sourceState = readScratchpadSourceState(tx);
-        const sources = readCurrentScratchpadSourceRefs(tx);
+        const submission = readPendingTaskCompileSubmission(tx, input.workflow_ref);
+        const sources = readCurrentScratchpadSourceRefs(tx, submission?.source_window.through);
         const lastSource = sources.at(-1);
-        const through = sourceState.refreshed_through_cursor ??
+        const through = submission?.source_window.through ??
+            sourceState.refreshed_through_cursor ??
             (lastSource === undefined
                 ? undefined
                 : { created_at: lastSource.created_at, message_id: lastSource.message_id });
+        const after = submission?.source_window.after ?? sourceState.cycle_start_cursor;
         const submittedAt = nowIso(input.now);
         tx.prepare(`
         INSERT INTO active_task_compile_context (
@@ -154,7 +235,7 @@ export function captureTaskCompileContext(db, input) {
           source_window_through_message_id
         )
         VALUES ('current', ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-      `).run(input.workflow_ref, input.captured_by_activity_ref, submittedAt, scratchpad.topic, scratchpad.background_summary, stringifyJson(scratchpad.current_consensus), stringifyJson(scratchpad.open_questions), stringifyJson(scratchpad.task_changes), scratchpad.updated_at, sourceState.cycle_start_cursor?.created_at ?? null, sourceState.cycle_start_cursor?.message_id ?? null, through?.created_at ?? null, through?.message_id ?? null);
+      `).run(input.workflow_ref, input.captured_by_activity_ref, submittedAt, scratchpad.topic, scratchpad.background_summary, stringifyJson(scratchpad.current_consensus), stringifyJson(scratchpad.open_questions), stringifyJson(scratchpad.task_changes), scratchpad.updated_at, after?.created_at ?? null, after?.message_id ?? null, through?.created_at ?? null, through?.message_id ?? null);
         const insertSource = tx.prepare(`
         INSERT INTO active_task_compile_context_sources (
           workflow_ref,
@@ -166,6 +247,9 @@ export function captureTaskCompileContext(db, input) {
         for (const source of sources) {
             insertSource.run(input.workflow_ref, source.message_id, source.created_at);
         }
+        if (submission !== null) {
+            tx.prepare("DELETE FROM pending_task_compile_submissions WHERE workflow_ref = ?").run(input.workflow_ref);
+        }
         tx.prepare(`
         INSERT INTO scratchpad_source_state (
           id,

package/dist/collaboration-state/task-retry.js

@@ -48,7 +48,9 @@ function failedResultCanRetry(row, result) {
 }
 export function materializeTaskRetryRun(db, input) {
     return withHostStoreTransaction(db, (tx) => {
-        const taskRow = tx.prepare("SELECT * FROM tasks WHERE id = ?").get(input.task_id);
+        const taskRow = tx
+            .prepare("SELECT * FROM tasks WHERE id = ?")
+            .get(input.task_id);
         if (taskRow === undefined) {
             return { disposition: { kind: "task_not_failed" } };
         }

package/dist/collaboration-state/types.d.ts

@@ -90,6 +90,18 @@ export type TaskCompileContextRecord = {
         created_at: string;
     }>;
 };
+export type TaskCompileSubmissionRecord = {
+    workflow_ref: WorkflowInvocationRef;
+    accepted_activity_ref: ActivityRef;
+    requested_at: string;
+    source_window: TaskCompileContextRecord["source_window"];
+};
+export type RecordTaskCompileSubmissionInput = {
+    workflow_ref: WorkflowInvocationRef;
+    accepted_activity_ref: ActivityRef;
+    source_window: TaskCompileSubmissionRecord["source_window"];
+    now?: () => Date;
+};
 export type CaptureTaskCompileContextInput = {
     workflow_ref: WorkflowInvocationRef;
     captured_by_activity_ref: ActivityRef;

package/dist/collaboration-state/worklist.d.ts

@@ -1,8 +1,9 @@
-import { type TaskId, type WorkflowInvocationRef } from "@tutti/shared/ids";
+import { type ActivityRef, type TaskId, type WorkflowInvocationRef } from "@tutti/shared/ids";
 import type { TaskProjection, WorklistCompiledTaskSummary, WorklistProjection } from "@tutti/shared/schemas/api";
 import type { SqliteDatabase } from "../store/index.js";
 import type { ApplyTaskCompileProposalResult, MarkTaskRunStartedInput, MarkTaskRunStartedResult, NextRunnableTaskResult, RecoverableScheduledRun, TaskCompileProposalInput } from "./types.js";
 export declare function readTaskProjection(db: SqliteDatabase, taskId: TaskId): TaskProjection | null;
+export declare function readTaskProjectionByActivityRef(db: SqliteDatabase, activityRef: ActivityRef): TaskProjection | null;
 export declare function readCompiledTaskSummariesByWorkflowRef(db: SqliteDatabase, workflowRef: WorkflowInvocationRef): WorklistCompiledTaskSummary[];
 export declare function readWorklistProjection(db: SqliteDatabase): WorklistProjection;
 export declare function readNextRunnableTask(db: SqliteDatabase): NextRunnableTaskResult;

package/dist/collaboration-state/worklist.js

@@ -44,6 +44,12 @@ export function readTaskProjection(db, taskId) {
     const row = db.prepare("SELECT * FROM tasks WHERE id = ?").get(taskId);
     return row === undefined ? null : mapTaskRow(row);
 }
+export function readTaskProjectionByActivityRef(db, activityRef) {
+    const row = db
+        .prepare("SELECT * FROM tasks WHERE current_activity_ref = ? LIMIT 1")
+        .get(activityRef);
+    return row === undefined ? null : mapTaskRow(row);
+}
 export function readCompiledTaskSummariesByWorkflowRef(db, workflowRef) {
     const rows = db
         .prepare(`

package/dist/control-plane/clarification-commands.d.ts

@@ -1,7 +1,7 @@
 import type { ClarificationRoundRef, IdempotencyKey } from "@tutti/shared/ids";
 import type { SendClarificationRoundMessageDisposition, SendClarificationRoundMessagePayload, SendClarificationRoundMessageResult, SubmitClarificationRoundDisposition, SubmitClarificationRoundPayload, SubmitClarificationRoundResult } from "@tutti/shared/schemas/api";
 import type { WorkspaceEventBus } from "../server-shell/http/workspace-events.js";
-import type { HostProjectStore } from "../store/index.js";
+import { type HostProjectStore } from "../store/index.js";
 import type { ControlPlaneCommandResult, TrustedHumanAuthor } from "./types.js";
 export declare function runSendClarificationRoundMessage(options: {
     store: HostProjectStore;
@@ -18,16 +18,20 @@ export declare function runSubmitClarificationRound(options: {
     payload: SubmitClarificationRoundPayload;
     commandId: IdempotencyKey;
     now: () => Date;
-    startTaskCompileContinuation: (owner: {
+    wakeIntentDispatcher: () => void;
+}): ControlPlaneCommandResult<SubmitClarificationRoundDisposition, SubmitClarificationRoundResult>;
+export declare function enqueueClarificationSuccessorIntent(db: HostProjectStore["db"], input: {
+    owner: {
         kind: "task_compile";
         workflow_ref: string;
     } | {
         kind: "task";
         task_id: string;
-    }, roundId: ClarificationRoundRef) => boolean;
-    startTaskBoundFollowUpCheck: (owner: {
-        kind: "task";
-        task_id: string;
-    }, threadId: string, roundId: ClarificationRoundRef) => boolean;
-}): ControlPlaneCommandResult<SubmitClarificationRoundDisposition, SubmitClarificationRoundResult>;
+    };
+    roundId: ClarificationRoundRef;
+    now: () => Date;
+}): {
+    intent: import("./dispatch-intents.js").ControlPlaneIntent;
+    created: boolean;
+};
 //# sourceMappingURL=clarification-commands.d.ts.map

package/dist/control-plane/clarification-commands.js

@@ -1,4 +1,6 @@
 import { createClarificationRoundMessage, readActiveClarificationProjection, submitClarificationRound, } from "../collaboration-state/index.js";
+import { withHostStoreTransaction } from "../store/index.js";
+import { enqueueControlPlaneIntent } from "./dispatch-intents.js";
 import { clarificationInvalidates } from "./invalidations.js";
 export function runSendClarificationRoundMessage(options) {
     const active = readActiveClarificationProjection(options.store.db);
@@ -69,10 +71,20 @@ export function runSubmitClarificationRound(options) {
             result: { round: active.round },
         };
     }
-    const sealed = submitClarificationRound(options.store.db, {
-        round_id: options.roundId,
-        accepted_command_id: options.commandId,
-        now: options.now,
+    const sealed = withHostStoreTransaction(options.store.db, (tx) => {
+        const submitted = submitClarificationRound(tx, {
+            round_id: options.roundId,
+            accepted_command_id: options.commandId,
+            now: options.now,
+        });
+        if (submitted !== null) {
+            enqueueClarificationSuccessorIntent(tx, {
+                owner: active.thread.owner,
+                roundId: options.roundId,
+                now: options.now,
+            });
+        }
+        return submitted;
     });
     if (sealed === null) {
         return { disposition: { kind: "chain_closed" } };
@@ -86,12 +98,7 @@ export function runSubmitClarificationRound(options) {
         },
         invalidates: clarificationInvalidates(options.roundId, active.thread.id),
     });
-    if (active.thread.owner.kind === "task_compile") {
-        options.startTaskCompileContinuation(active.thread.owner, options.roundId);
-    }
-    else {
-        options.startTaskBoundFollowUpCheck(active.thread.owner, active.thread.id, options.roundId);
-    }
+    options.wakeIntentDispatcher();
     return {
         disposition: { kind: "accepted" },
         result: {
@@ -102,4 +109,16 @@ export function runSubmitClarificationRound(options) {
         },
     };
 }
+export function enqueueClarificationSuccessorIntent(db, input) {
+    const kind = input.owner.kind === "task_compile" ? "task_compile_continuation" : "task_bound_follow_up";
+    return enqueueControlPlaneIntent(db, {
+        kind,
+        ownerKind: "clarification_round",
+        ownerRef: input.roundId,
+        dedupeKey: `${kind}:${input.roundId}`,
+        lane: "foreground",
+        priority: 20,
+        now: input.now,
+    });
+}
 //# sourceMappingURL=clarification-commands.js.map

package/dist/control-plane/dispatch-intents.d.ts

@@ -0,0 +1,104 @@
+import { type ControlPlaneIntentId } from "@tutti/shared/ids";
+import type { SqliteDatabase } from "../store/index.js";
+export declare const CONTROL_PLANE_INTENT_KINDS: readonly ["task_compile_start", "task_compile_continuation", "task_bound_follow_up", "scratchpad_refresh", "reference_summary_refresh", "run_dispatch"];
+export type ControlPlaneIntentKind = (typeof CONTROL_PLANE_INTENT_KINDS)[number];
+export declare const CONTROL_PLANE_INTENT_OWNER_KINDS: readonly ["task_compile", "clarification_round", "scratchpad", "reference_summary", "task_run"];
+export type ControlPlaneIntentOwnerKind = (typeof CONTROL_PLANE_INTENT_OWNER_KINDS)[number];
+export type ControlPlaneIntentLane = "foreground" | "scratchpad_background" | "run";
+export type ControlPlaneIntentState = "pending" | "claimed" | "running" | "completed" | "failed" | "cancelled";
+export type ControlPlaneIntentTerminalState = Extract<ControlPlaneIntentState, "completed" | "failed" | "cancelled">;
+export type ControlPlaneIntent = {
+    intent_id: ControlPlaneIntentId;
+    kind: ControlPlaneIntentKind;
+    owner_kind: ControlPlaneIntentOwnerKind;
+    owner_ref: string;
+    dedupe_key: string;
+    lane: ControlPlaneIntentLane;
+    priority: number;
+    state: ControlPlaneIntentState;
+    available_at: string;
+    claim_token?: string;
+    lease_expires_at?: string;
+    attempt_count: number;
+    last_error_code?: string;
+    created_at: string;
+    updated_at: string;
+    completed_at?: string;
+};
+export declare function readControlPlaneIntent(db: SqliteDatabase, intentId: ControlPlaneIntentId): ControlPlaneIntent | null;
+export declare function readControlPlaneIntentByDedupeKey(db: SqliteDatabase, dedupeKey: string): ControlPlaneIntent | null;
+export declare function enqueueControlPlaneIntent(db: SqliteDatabase, input: {
+    kind: ControlPlaneIntentKind;
+    ownerKind: ControlPlaneIntentOwnerKind;
+    ownerRef: string;
+    dedupeKey: string;
+    lane: ControlPlaneIntentLane;
+    priority?: number;
+    availableAt?: string;
+    now?: () => Date;
+}): {
+    intent: ControlPlaneIntent;
+    created: boolean;
+};
+export declare function listPendingControlPlaneIntents(db: SqliteDatabase, input?: {
+    now?: () => Date;
+    limit?: number;
+}): ControlPlaneIntent[];
+export declare function listNonTerminalControlPlaneIntentsByKind(db: SqliteDatabase, kind: ControlPlaneIntentKind): ControlPlaneIntent[];
+export declare function listExpiredControlPlaneIntentClaims(db: SqliteDatabase, input?: {
+    now?: () => Date;
+    limit?: number;
+}): ControlPlaneIntent[];
+export declare function listActiveControlPlaneIntentClaims(db: SqliteDatabase): ControlPlaneIntent[];
+export declare function claimControlPlaneIntent(db: SqliteDatabase, input: {
+    intentId: ControlPlaneIntentId;
+    claimToken: string;
+    leaseExpiresAt: string;
+    now?: () => Date;
+}): ControlPlaneIntent | null;
+export declare function markControlPlaneIntentRunning(db: SqliteDatabase, input: {
+    intentId: ControlPlaneIntentId;
+    claimToken: string;
+    leaseExpiresAt: string;
+    now?: () => Date;
+}): ControlPlaneIntent | null;
+export declare function renewControlPlaneIntentLease(db: SqliteDatabase, input: {
+    intentId: ControlPlaneIntentId;
+    claimToken: string;
+    leaseExpiresAt: string;
+    now?: () => Date;
+}): boolean;
+export declare function releaseControlPlaneIntentClaim(db: SqliteDatabase, input: {
+    intentId: ControlPlaneIntentId;
+    claimToken: string;
+    availableAt?: string;
+    errorCode?: string;
+    now?: () => Date;
+}): ControlPlaneIntent | null;
+export declare function requeueExpiredControlPlaneIntentClaim(db: SqliteDatabase, input: {
+    intentId: ControlPlaneIntentId;
+    expectedClaimToken: string;
+    availableAt?: string;
+    errorCode: string;
+    now?: () => Date;
+}): ControlPlaneIntent | null;
+export declare function requeueOrphanedControlPlaneIntentClaim(db: SqliteDatabase, input: {
+    intentId: ControlPlaneIntentId;
+    expectedClaimToken: string;
+    errorCode: string;
+    now?: () => Date;
+}): ControlPlaneIntent | null;
+export declare function settleClaimedControlPlaneIntent(db: SqliteDatabase, input: {
+    intentId: ControlPlaneIntentId;
+    claimToken: string;
+    state: ControlPlaneIntentTerminalState;
+    errorCode?: string;
+    now?: () => Date;
+}): ControlPlaneIntent | null;
+export declare function settlePendingControlPlaneIntent(db: SqliteDatabase, input: {
+    intentId: ControlPlaneIntentId;
+    state: ControlPlaneIntentTerminalState;
+    errorCode?: string;
+    now?: () => Date;
+}): ControlPlaneIntent | null;
+//# sourceMappingURL=dispatch-intents.d.ts.map