@xfey/tutti 0.1.96 → 0.1.97

package/dist/control-plane/dispatch-intents.js

@@ -0,0 +1,276 @@
+import { createControlPlaneIntentId } from "@tutti/shared/ids";
+export const CONTROL_PLANE_INTENT_KINDS = [
+    "task_compile_start",
+    "task_compile_continuation",
+    "task_bound_follow_up",
+    "scratchpad_refresh",
+    "reference_summary_refresh",
+    "run_dispatch",
+];
+export const CONTROL_PLANE_INTENT_OWNER_KINDS = [
+    "task_compile",
+    "clarification_round",
+    "scratchpad",
+    "reference_summary",
+    "task_run",
+];
+const CONTROL_PLANE_INTENT_COLUMNS = `
+  intent_id,
+  kind,
+  owner_kind,
+  owner_ref,
+  dedupe_key,
+  lane,
+  priority,
+  state,
+  available_at,
+  claim_token,
+  lease_expires_at,
+  attempt_count,
+  last_error_code,
+  created_at,
+  updated_at,
+  completed_at
+`;
+function nowIso(now) {
+    return (now?.() ?? new Date()).toISOString();
+}
+function mapIntentRow(row) {
+    return {
+        intent_id: row.intent_id,
+        kind: row.kind,
+        owner_kind: row.owner_kind,
+        owner_ref: row.owner_ref,
+        dedupe_key: row.dedupe_key,
+        lane: row.lane,
+        priority: row.priority,
+        state: row.state,
+        available_at: row.available_at,
+        attempt_count: row.attempt_count,
+        created_at: row.created_at,
+        updated_at: row.updated_at,
+        ...(row.claim_token === null ? {} : { claim_token: row.claim_token }),
+        ...(row.lease_expires_at === null ? {} : { lease_expires_at: row.lease_expires_at }),
+        ...(row.last_error_code === null ? {} : { last_error_code: row.last_error_code }),
+        ...(row.completed_at === null ? {} : { completed_at: row.completed_at }),
+    };
+}
+export function readControlPlaneIntent(db, intentId) {
+    const row = db
+        .prepare(`SELECT ${CONTROL_PLANE_INTENT_COLUMNS} FROM control_plane_intents WHERE intent_id = ?`)
+        .get(intentId);
+    return row === undefined ? null : mapIntentRow(row);
+}
+export function readControlPlaneIntentByDedupeKey(db, dedupeKey) {
+    const row = db
+        .prepare(`SELECT ${CONTROL_PLANE_INTENT_COLUMNS} FROM control_plane_intents WHERE dedupe_key = ?`)
+        .get(dedupeKey);
+    return row === undefined ? null : mapIntentRow(row);
+}
+export function enqueueControlPlaneIntent(db, input) {
+    const createdAt = nowIso(input.now);
+    const intentId = createControlPlaneIntentId();
+    const result = db
+        .prepare(`
+        INSERT INTO control_plane_intents (
+          intent_id,
+          kind,
+          owner_kind,
+          owner_ref,
+          dedupe_key,
+          lane,
+          priority,
+          state,
+          available_at,
+          attempt_count,
+          created_at,
+          updated_at
+        )
+        VALUES (?, ?, ?, ?, ?, ?, ?, 'pending', ?, 0, ?, ?)
+        ON CONFLICT(dedupe_key) DO NOTHING
+      `)
+        .run(intentId, input.kind, input.ownerKind, input.ownerRef, input.dedupeKey, input.lane, input.priority ?? 100, input.availableAt ?? createdAt, createdAt, createdAt);
+    const intent = readControlPlaneIntentByDedupeKey(db, input.dedupeKey);
+    if (intent === null) {
+        throw new Error("Control Plane intent enqueue did not materialize a durable row");
+    }
+    return { intent, created: result.changes === 1 };
+}
+export function listPendingControlPlaneIntents(db, input = {}) {
+    const rows = db
+        .prepare(`
+        SELECT ${CONTROL_PLANE_INTENT_COLUMNS}
+        FROM control_plane_intents
+        WHERE state = 'pending' AND available_at <= ?
+        ORDER BY priority ASC, available_at ASC, created_at ASC, intent_id ASC
+        LIMIT ?
+      `)
+        .all(nowIso(input.now), input.limit ?? 100);
+    return rows.map(mapIntentRow);
+}
+export function listNonTerminalControlPlaneIntentsByKind(db, kind) {
+    const rows = db
+        .prepare(`
+        SELECT ${CONTROL_PLANE_INTENT_COLUMNS}
+        FROM control_plane_intents
+        WHERE kind = ? AND state IN ('pending', 'claimed', 'running')
+        ORDER BY created_at ASC, intent_id ASC
+      `)
+        .all(kind);
+    return rows.map(mapIntentRow);
+}
+export function listExpiredControlPlaneIntentClaims(db, input = {}) {
+    const rows = db
+        .prepare(`
+        SELECT ${CONTROL_PLANE_INTENT_COLUMNS}
+        FROM control_plane_intents
+        WHERE state IN ('claimed', 'running') AND lease_expires_at <= ?
+        ORDER BY lease_expires_at ASC, intent_id ASC
+        LIMIT ?
+      `)
+        .all(nowIso(input.now), input.limit ?? 100);
+    return rows.map(mapIntentRow);
+}
+export function listActiveControlPlaneIntentClaims(db) {
+    const rows = db
+        .prepare(`
+        SELECT ${CONTROL_PLANE_INTENT_COLUMNS}
+        FROM control_plane_intents
+        WHERE state IN ('claimed', 'running')
+        ORDER BY updated_at ASC, intent_id ASC
+      `)
+        .all();
+    return rows.map(mapIntentRow);
+}
+export function claimControlPlaneIntent(db, input) {
+    const updatedAt = nowIso(input.now);
+    const row = db
+        .prepare(`
+        UPDATE control_plane_intents
+        SET
+          state = 'claimed',
+          claim_token = ?,
+          lease_expires_at = ?,
+          attempt_count = attempt_count + 1,
+          last_error_code = NULL,
+          updated_at = ?
+        WHERE intent_id = ? AND state = 'pending' AND available_at <= ?
+        RETURNING ${CONTROL_PLANE_INTENT_COLUMNS}
+      `)
+        .get(input.claimToken, input.leaseExpiresAt, updatedAt, input.intentId, updatedAt);
+    return row === undefined ? null : mapIntentRow(row);
+}
+export function markControlPlaneIntentRunning(db, input) {
+    const updatedAt = nowIso(input.now);
+    const row = db
+        .prepare(`
+        UPDATE control_plane_intents
+        SET state = 'running', lease_expires_at = ?, updated_at = ?
+        WHERE intent_id = ? AND state = 'claimed' AND claim_token = ?
+        RETURNING ${CONTROL_PLANE_INTENT_COLUMNS}
+      `)
+        .get(input.leaseExpiresAt, updatedAt, input.intentId, input.claimToken);
+    return row === undefined ? null : mapIntentRow(row);
+}
+export function renewControlPlaneIntentLease(db, input) {
+    const result = db
+        .prepare(`
+        UPDATE control_plane_intents
+        SET lease_expires_at = ?, updated_at = ?
+        WHERE intent_id = ? AND state = 'running' AND claim_token = ?
+      `)
+        .run(input.leaseExpiresAt, nowIso(input.now), input.intentId, input.claimToken);
+    return result.changes === 1;
+}
+export function releaseControlPlaneIntentClaim(db, input) {
+    const updatedAt = nowIso(input.now);
+    const row = db
+        .prepare(`
+        UPDATE control_plane_intents
+        SET
+          state = 'pending',
+          available_at = ?,
+          claim_token = NULL,
+          lease_expires_at = NULL,
+          last_error_code = ?,
+          updated_at = ?
+        WHERE intent_id = ? AND state = 'claimed' AND claim_token = ?
+        RETURNING ${CONTROL_PLANE_INTENT_COLUMNS}
+      `)
+        .get(input.availableAt ?? updatedAt, input.errorCode ?? null, updatedAt, input.intentId, input.claimToken);
+    return row === undefined ? null : mapIntentRow(row);
+}
+export function requeueExpiredControlPlaneIntentClaim(db, input) {
+    const updatedAt = nowIso(input.now);
+    const row = db
+        .prepare(`
+        UPDATE control_plane_intents
+        SET
+          state = 'pending',
+          available_at = ?,
+          claim_token = NULL,
+          lease_expires_at = NULL,
+          last_error_code = ?,
+          updated_at = ?
+        WHERE
+          intent_id = ?
+          AND state IN ('claimed', 'running')
+          AND claim_token = ?
+          AND lease_expires_at <= ?
+        RETURNING ${CONTROL_PLANE_INTENT_COLUMNS}
+      `)
+        .get(input.availableAt ?? updatedAt, input.errorCode, updatedAt, input.intentId, input.expectedClaimToken, updatedAt);
+    return row === undefined ? null : mapIntentRow(row);
+}
+export function requeueOrphanedControlPlaneIntentClaim(db, input) {
+    const updatedAt = nowIso(input.now);
+    const row = db
+        .prepare(`
+        UPDATE control_plane_intents
+        SET
+          state = 'pending',
+          available_at = ?,
+          claim_token = NULL,
+          lease_expires_at = NULL,
+          last_error_code = ?,
+          updated_at = ?
+        WHERE
+          intent_id = ?
+          AND state IN ('claimed', 'running')
+          AND claim_token = ?
+        RETURNING ${CONTROL_PLANE_INTENT_COLUMNS}
+      `)
+        .get(updatedAt, input.errorCode, updatedAt, input.intentId, input.expectedClaimToken);
+    return row === undefined ? null : mapIntentRow(row);
+}
+export function settleClaimedControlPlaneIntent(db, input) {
+    const completedAt = nowIso(input.now);
+    const row = db
+        .prepare(`
+        UPDATE control_plane_intents
+        SET
+          state = ?,
+          claim_token = NULL,
+          lease_expires_at = NULL,
+          last_error_code = ?,
+          updated_at = ?,
+          completed_at = ?
+        WHERE intent_id = ? AND state IN ('claimed', 'running') AND claim_token = ?
+        RETURNING ${CONTROL_PLANE_INTENT_COLUMNS}
+      `)
+        .get(input.state, input.errorCode ?? null, completedAt, completedAt, input.intentId, input.claimToken);
+    return row === undefined ? null : mapIntentRow(row);
+}
+export function settlePendingControlPlaneIntent(db, input) {
+    const completedAt = nowIso(input.now);
+    const row = db
+        .prepare(`
+        UPDATE control_plane_intents
+        SET state = ?, last_error_code = ?, updated_at = ?, completed_at = ?
+        WHERE intent_id = ? AND state = 'pending'
+        RETURNING ${CONTROL_PLANE_INTENT_COLUMNS}
+      `)
+        .get(input.state, input.errorCode ?? null, completedAt, completedAt, input.intentId);
+    return row === undefined ? null : mapIntentRow(row);
+}
+//# sourceMappingURL=dispatch-intents.js.map

package/dist/control-plane/follow-up-run.d.ts

@@ -1,6 +1,6 @@
 import { type ClarificationRoundRef, type TaskId } from "@tutti/shared/ids";
 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 { RunPipelineResolver } from "./types.js";
 import type { StartRunForTaskInput } from "./run-start.js";
 type StartRunForTask = (input: StartRunForTaskInput) => void;

package/dist/control-plane/follow-up-run.js

@@ -1,8 +1,10 @@
 import { createActivityRef, } from "@tutti/shared/ids";
 import { materializeTaskBoundRunSuccessor, readNextRunnableTask, readTaskDetailProjection, readTaskRunResultsPage, } from "../collaboration-state/index.js";
+import { withHostStoreTransaction } from "../store/index.js";
 import { readRunContinuationContextFromStore } from "./follow-up-context.js";
 import { clarificationInvalidates } from "./invalidations.js";
 import { toDomainRunLineage } from "./run-lineage.js";
+import { enqueueRunDispatchIntent } from "./run-dispatch-intents.js";
 export function startRunFromFollowUp(input) {
     const pipelineResolution = input.resolveRunPipeline?.();
     if (pipelineResolution === undefined || pipelineResolution.kind !== "ready") {
@@ -27,10 +29,16 @@ export function startRunFromFollowUp(input) {
         return;
     }
     const activityRef = createActivityRef();
-    const materialized = materializeTaskBoundRunSuccessor(input.store.db, {
-        round_id: input.roundId,
-        activity_ref: activityRef,
-        now: input.now,
+    const materialized = withHostStoreTransaction(input.store.db, (tx) => {
+        const successor = materializeTaskBoundRunSuccessor(tx, {
+            round_id: input.roundId,
+            activity_ref: activityRef,
+            now: input.now,
+        });
+        if (successor?.kind === "materialized") {
+            enqueueRunDispatchIntent(tx, { activityRef, now: input.now });
+        }
+        return successor;
     });
     if (materialized === null || materialized.kind !== "materialized") {
         return;

package/dist/control-plane/follow-up-start.d.ts

@@ -4,6 +4,7 @@ import type { WorkspaceEventBus } from "../server-shell/http/workspace-events.js
 import type { HostProjectStore } from "../store/index.js";
 import type { StartRunForTaskInput } from "./run-start.js";
 import type { ControlPlaneLogger, Phase5ControlPlaneOptions, RunPipelineResolver } from "./types.js";
+import type { IntentRuntimeStartResult, IntentRuntimeTerminal } from "./intent-dispatcher.js";
 import type { ProcedureWorkflowRunnerResolver } from "./workflows/index.js";
 export declare function startControlPlaneTaskBoundFollowUpCheck(options: {
     engine: ProcedureEngine;
@@ -23,5 +24,6 @@ export declare function startControlPlaneTaskBoundFollowUpCheck(options: {
     publishProcedureTransition: (state: ProcedureEngineState) => void;
     startRunForTask: (runInput: StartRunForTaskInput) => void;
     shouldContinue?: () => boolean;
-}): boolean;
+    onTerminal?: (result?: IntentRuntimeTerminal) => void;
+}): IntentRuntimeStartResult;
 //# sourceMappingURL=follow-up-start.d.ts.map

package/dist/control-plane/follow-up-start.js

@@ -6,7 +6,7 @@ import { logProcedureExecutionError } from "./procedure-logging.js";
 export function startControlPlaneTaskBoundFollowUpCheck(options) {
     const runnerResolution = options.resolveWorkflowRunner();
     if (runnerResolution.kind !== "ready" || runnerResolution.runner.runFollowUpCheck === undefined) {
-        return false;
+        return { kind: "not_ready", errorCode: "follow_up_runner_unavailable" };
     }
     const workflowRef = createWorkflowInvocationRef();
     let output;
@@ -37,6 +37,11 @@ export function startControlPlaneTaskBoundFollowUpCheck(options) {
                     now: options.now,
                 });
             }
+            if (state.transition_kind === "terminal") {
+                options.onTerminal?.(state.activity.status === "failed"
+                    ? { state: "failed", errorCode: "procedure_failed" }
+                    : undefined);
+            }
         },
         onError: ({ context, error }) => logProcedureExecutionError({
             logger: options.logger,
@@ -98,6 +103,6 @@ export function startControlPlaneTaskBoundFollowUpCheck(options) {
             });
         },
     });
-    return start.kind === "accepted";
+    return start.kind === "accepted" ? { kind: "accepted" } : { kind: "busy" };
 }
 //# sourceMappingURL=follow-up-start.js.map

package/dist/control-plane/formatters.d.ts

@@ -6,5 +6,7 @@ export declare function formatStartupRecoverySummary(input: {
     replayedRoundCount: number;
     interruptedCommandCount: number;
     staleReplayHintCount: number;
+    recoveredTaskCompileCount: number;
+    recoveredScratchpadRefreshCount: number;
 }): string;
 //# sourceMappingURL=formatters.d.ts.map

package/dist/control-plane/formatters.js

@@ -34,6 +34,12 @@ export function formatStartupRecoverySummary(input) {
     if (input.staleReplayHintCount > 0) {
         parts.push(`${countNoun(input.staleReplayHintCount, "stale replay hint")} cleared`);
     }
+    if (input.recoveredTaskCompileCount > 0) {
+        parts.push(`${countNoun(input.recoveredTaskCompileCount, "Task Compile chain")} requeued`);
+    }
+    if (input.recoveredScratchpadRefreshCount > 0) {
+        parts.push(`${countNoun(input.recoveredScratchpadRefreshCount, "Scratchpad refresh")} requeued`);
+    }
     return parts.length === 0
         ? "Startup recovery completed."
         : `Startup recovery completed: ${parts.join("; ")}.`;

package/dist/control-plane/index.d.ts

@@ -18,6 +18,7 @@ export declare class Phase5ControlPlane {
     private readonly runLifecycle;
     private readonly now;
     private readonly scratchpadAutoRefreshScheduler;
+    private readonly intentDispatcher;
     private pendingWorklistCompletionContextSyncTimer;
     private readonly pendingReferenceSummaryPaths;
     private readonly referenceSummaryWaiters;
@@ -25,6 +26,8 @@ export declare class Phase5ControlPlane {
     private referenceSummaryStartScheduled;
     private closing;
     private readonly asyncOwners;
+    private readonly pendingRunInputs;
+    private readonly runIntentTerminals;
     private lastRecoveryConclusion;
     constructor(options: Phase5ControlPlaneOptions);
     getExecutionStatus(): ExecutionStatusProjection;
@@ -73,6 +76,12 @@ export declare class Phase5ControlPlane {
     private cancelPendingWorklistCompletionContextSync;
     private startTaskCompileContinuation;
     private startTaskBoundFollowUpCheck;
+    private dispatchDurableIntent;
+    private dispatchRunIntent;
+    private dispatchScratchpadIntent;
+    private dispatchReferenceSummaryIntent;
+    private dispatchTaskCompileStartIntent;
+    private dispatchClarificationSuccessorIntent;
     private publishProcedureTransition;
     private logProcedureTransition;
 }