@xfey/tutti 0.1.26 → 0.1.28

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

@@ -1,6 +1,6 @@
 export { CollaborationStateCursorError } from "./serialization.js";
 export { createIdleExecutionStatusProjection } from "./execution-status.js";
-export { createMainChatAgentMessage, createMainChatMessage, createMainChatSystemMessage, hasMainChatWorklistFeedbackMessage, readCompletedWorklistFeedbackTaskIds, readMessageProjectionById, readMainChatMessageWindow, readMainChatMessagesAfter, readMainChatMessagesAfterCursor, readMainChatMessagesBeforeCursor, } from "./messages.js";
+export { createMainChatAgentMessage, createMainChatMessage, createMainChatSystemMessage, hasMainChatArtifactPreviewMessage, hasMainChatWorklistCompileMessage, hasMainChatWorklistFeedbackMessage, readCompletedWorklistFeedbackTaskIds, readMessageProjectionById, readMainChatMessageWindow, readMainChatMessagesAfter, readMainChatMessagesAfterCursor, readMainChatMessagesBeforeCursor, } from "./messages.js";
 export { createEmptyScratchpadProjection, readScratchpadReceiptSourceRefs, readScratchpadProjection, submitScratchpadProjection, upsertScratchpadProjection, } from "./scratchpad.js";
 export { advanceScratchpadTaskCompileSourceCursor, markScratchpadRefreshFailed, markScratchpadRefreshStarted, markScratchpadRefreshSucceeded, markScratchpadSourceDirty, readScratchpadSourceState, } from "./scratchpad-source-state.js";
 export { deleteStaleClarificationSubmitReplayHints, readActiveClarificationProjection, readClarificationRoundProjection, readClarificationRoundsForThread, readClarificationThreadResponse, readSealedClarificationRoundsWithoutSuccessor, readSubmittedTaskCompileClarificationRounds, readSubmittedTaskCompileClarificationRoundsAfterCursor, } from "./clarification-records.js";
@@ -12,6 +12,6 @@ export { recordRunNeedsHumanResult, recordRunResult } from "./run-recording.js";
 export { recoverStaleRunningTasksAsFailed } from "./recovery.js";
 export { markReadStateScope, readReadStateSummary, recordReadNotificationEvent, } from "./read-state.js";
 export { readTaskDetailProjection } from "./task-details.js";
-export { applyTaskCompileProposal, markTaskRunStarted, readNextRunnableTask, readRecoverableScheduledRun, readTaskProjection, readWorklistProjection, } from "./worklist.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, ReadMainChatMessagesAfterOptions, ReadMessageWindowOptions, ReadReadStateSummaryInput, RecoverStaleRunningTasksResult, RecoverableScheduledRun, RecordReadNotificationEventInput, RecordRecoverySummaryInput, RecordRecoverySummaryResult, RecordRunNeedsHumanResultInput, RecordRunNeedsHumanResultResult, RecordRunResultInput, RecordRunResultResult, RunResultPromotionProjection, ScratchpadSnapshotInput, SubmitScratchpadInput, SubmitScratchpadResult, SealedClarificationRoundWithoutSuccessor, SubmitClarificationRoundInput, TaskCompileProposalInput, TaskCompileProposalModuleInput, TaskCompileProposalTaskInput, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/collaboration-state/index.js

@@ -1,6 +1,6 @@
 export { CollaborationStateCursorError } from "./serialization.js";
 export { createIdleExecutionStatusProjection } from "./execution-status.js";
-export { createMainChatAgentMessage, createMainChatMessage, createMainChatSystemMessage, hasMainChatWorklistFeedbackMessage, readCompletedWorklistFeedbackTaskIds, readMessageProjectionById, readMainChatMessageWindow, readMainChatMessagesAfter, readMainChatMessagesAfterCursor, readMainChatMessagesBeforeCursor, } from "./messages.js";
+export { createMainChatAgentMessage, createMainChatMessage, createMainChatSystemMessage, hasMainChatArtifactPreviewMessage, hasMainChatWorklistCompileMessage, hasMainChatWorklistFeedbackMessage, readCompletedWorklistFeedbackTaskIds, readMessageProjectionById, readMainChatMessageWindow, readMainChatMessagesAfter, readMainChatMessagesAfterCursor, readMainChatMessagesBeforeCursor, } from "./messages.js";
 export { createEmptyScratchpadProjection, readScratchpadReceiptSourceRefs, readScratchpadProjection, submitScratchpadProjection, upsertScratchpadProjection, } from "./scratchpad.js";
 export { advanceScratchpadTaskCompileSourceCursor, markScratchpadRefreshFailed, markScratchpadRefreshStarted, markScratchpadRefreshSucceeded, markScratchpadSourceDirty, readScratchpadSourceState, } from "./scratchpad-source-state.js";
 export { deleteStaleClarificationSubmitReplayHints, readActiveClarificationProjection, readClarificationRoundProjection, readClarificationRoundsForThread, readClarificationThreadResponse, readSealedClarificationRoundsWithoutSuccessor, readSubmittedTaskCompileClarificationRounds, readSubmittedTaskCompileClarificationRoundsAfterCursor, } from "./clarification-records.js";
@@ -12,5 +12,5 @@ export { recordRunNeedsHumanResult, recordRunResult } from "./run-recording.js";
 export { recoverStaleRunningTasksAsFailed } from "./recovery.js";
 export { markReadStateScope, readReadStateSummary, recordReadNotificationEvent, } from "./read-state.js";
 export { readTaskDetailProjection } from "./task-details.js";
-export { applyTaskCompileProposal, markTaskRunStarted, readNextRunnableTask, readRecoverableScheduledRun, readTaskProjection, readWorklistProjection, } from "./worklist.js";
+export { applyTaskCompileProposal, markTaskRunStarted, readNextRunnableTask, readRecoverableScheduledRun, readCompiledTaskSummariesByWorkflowRef, readTaskProjection, readWorklistProjection, } from "./worklist.js";
 //# sourceMappingURL=index.js.map

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

@@ -1,4 +1,4 @@
-import { type MessageId, type TaskId } from "@tutti/shared/ids";
+import { type MessageId, type RunResultId, type TaskId, type WorkflowInvocationRef } from "@tutti/shared/ids";
 import type { MessageProjection, MessageWindow } from "@tutti/shared/schemas/api";
 import type { SqliteDatabase } from "../store/index.js";
 import type { CreateMainChatAgentMessageInput, CreateMainChatMessageInput, CreateMainChatSystemMessageInput, ReadMainChatMessagesAfterOptions, ReadMessageWindowOptions } from "./types.js";
@@ -9,6 +9,8 @@ export declare function createMainChatSystemMessage(db: SqliteDatabase, input: C
 export declare function createMainChatAgentMessage(db: SqliteDatabase, input: CreateMainChatAgentMessageInput): MessageProjection;
 export declare function readMessageProjectionById(db: SqliteDatabase, messageId: MessageId): MessageProjection | null;
 export declare function hasMainChatWorklistFeedbackMessage(db: SqliteDatabase, feedbackKey: string): boolean;
+export declare function hasMainChatWorklistCompileMessage(db: SqliteDatabase, workflowRef: WorkflowInvocationRef): boolean;
+export declare function hasMainChatArtifactPreviewMessage(db: SqliteDatabase, runResultId: RunResultId): boolean;
 export declare function readCompletedWorklistFeedbackTaskIds(db: SqliteDatabase): Set<TaskId>;
 export declare function readMainChatMessageWindow(db: SqliteDatabase, options?: ReadMessageWindowOptions): MessageWindow;
 export declare function readMainChatMessagesAfter(db: SqliteDatabase, options: ReadMainChatMessagesAfterOptions): MessageProjection[];

package/dist/collaboration-state/messages.js

@@ -1,4 +1,4 @@
-import { createMessageId } from "@tutti/shared/ids";
+import { createMessageId, } from "@tutti/shared/ids";
 import { clampLimit, decodeCursor, messageCursor, nowIso, parseJson, stringifyJson, } from "./serialization.js";
 import { recordReadNotificationEvent } from "./read-state.js";
 function readClarificationCardForMessage(db, messageId) {
@@ -207,6 +207,30 @@ export function hasMainChatWorklistFeedbackMessage(db, feedbackKey) {
         .get(feedbackKey);
     return row !== undefined;
 }
+export function hasMainChatWorklistCompileMessage(db, workflowRef) {
+    const row = db
+        .prepare(`
+        SELECT 1 AS exists_flag
+        FROM messages
+        WHERE scope_kind = 'main_chat'
+          AND json_extract(refs_json, '$.worklist_compile.workflow_ref') = ?
+        LIMIT 1
+      `)
+        .get(workflowRef);
+    return row !== undefined;
+}
+export function hasMainChatArtifactPreviewMessage(db, runResultId) {
+    const row = db
+        .prepare(`
+        SELECT 1 AS exists_flag
+        FROM messages
+        WHERE scope_kind = 'main_chat'
+          AND json_extract(refs_json, '$.artifact_preview.run_result_id') = ?
+        LIMIT 1
+      `)
+        .get(runResultId);
+    return row !== undefined;
+}
 export function readCompletedWorklistFeedbackTaskIds(db) {
     const rows = db
         .prepare(`

package/dist/collaboration-state/scratchpad.js

@@ -1,4 +1,5 @@
 import { nowIso, parseJson, stringifyJson } from "./serialization.js";
+import { readCompiledTaskSummariesByWorkflowRef } from "./worklist.js";
 const SCRATCHPAD_RECEIPT_LIMIT = 100;
 function normalizeSourceRefs(sourceRefs = []) {
     const byMessageId = new Map();
@@ -80,16 +81,20 @@ function readScratchpadReceipts(db) {
         LIMIT ${SCRATCHPAD_RECEIPT_LIMIT}
       `)
         .all();
-    return rows.map((row) => ({
-        workflow_ref: row.workflow_ref,
-        activity_ref: row.activity_ref,
-        topic: row.topic,
-        background_summary: row.background_summary,
-        current_consensus: parseJson(row.current_consensus_json, []),
-        open_questions: parseJson(row.open_questions_json, []),
-        task_changes: parseJson(row.task_changes_json, []),
-        submitted_at: row.submitted_at,
-    }));
+    return rows.map((row) => {
+        const compiledTasks = readCompiledTaskSummariesByWorkflowRef(db, row.workflow_ref);
+        return {
+            workflow_ref: row.workflow_ref,
+            activity_ref: row.activity_ref,
+            topic: row.topic,
+            background_summary: row.background_summary,
+            current_consensus: parseJson(row.current_consensus_json, []),
+            open_questions: parseJson(row.open_questions_json, []),
+            task_changes: parseJson(row.task_changes_json, []),
+            submitted_at: row.submitted_at,
+            ...(compiledTasks.length === 0 ? {} : { compiled_tasks: compiledTasks }),
+        };
+    });
 }
 export function upsertScratchpadProjection(db, input) {
     const updatedAt = nowIso(input.now);

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

@@ -1,8 +1,9 @@
-import { type TaskId } from "@tutti/shared/ids";
-import type { TaskProjection, WorklistProjection } from "@tutti/shared/schemas/api";
+import { 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 readCompiledTaskSummariesByWorkflowRef(db: SqliteDatabase, workflowRef: WorkflowInvocationRef): WorklistCompiledTaskSummary[];
 export declare function readWorklistProjection(db: SqliteDatabase): WorklistProjection;
 export declare function readNextRunnableTask(db: SqliteDatabase): NextRunnableTaskResult;
 export declare function readRecoverableScheduledRun(db: SqliteDatabase): RecoverableScheduledRun | null;

package/dist/collaboration-state/worklist.js

@@ -44,6 +44,30 @@ export function readTaskProjection(db, taskId) {
     const row = db.prepare("SELECT * FROM tasks WHERE id = ?").get(taskId);
     return row === undefined ? null : mapTaskRow(row);
 }
+export function readCompiledTaskSummariesByWorkflowRef(db, workflowRef) {
+    const rows = db
+        .prepare(`
+        SELECT
+          tasks.*,
+          task_modules.name AS module_name
+        FROM tasks
+        JOIN task_modules ON task_modules.id = tasks.module_id
+        WHERE tasks.created_from_workflow_ref = ?
+        ORDER BY task_modules.sort_order ASC,
+                 task_modules.id ASC,
+                 tasks.sort_order ASC,
+                 tasks.id ASC
+      `)
+        .all(workflowRef);
+    return rows.map((row) => ({
+        task_id: row.id,
+        title: row.title,
+        summary: row.summary,
+        status: row.status,
+        module_id: row.module_id,
+        module_name: row.module_name,
+    }));
+}
 export function readWorklistProjection(db) {
     const moduleRows = db
         .prepare(`

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

@@ -48,6 +48,7 @@ export declare class Phase5ControlPlane {
     private readScratchpadRefreshBlocker;
     private publishTaskRunStarted;
     private publishRunResultRecorded;
+    private maybePublishArtifactPreviewMessage;
     private publishRunTransition;
     private handleRunTerminalTransition;
     private tryRunTaskArrivalScheduler;

package/dist/control-plane/index.js

@@ -1,4 +1,4 @@
-import { readWorklistProjection } from "../collaboration-state/index.js";
+import { createMainChatAgentMessage, hasMainChatArtifactPreviewMessage, readWorklistProjection, } from "../collaboration-state/index.js";
 import { ProcedureEngine } from "../procedure-engine/index.js";
 import { RunEngine } from "../run-engine/index.js";
 import { publishProcedureTransition as publishProcedureTransitionEvent, publishRunResultRecorded as publishRunResultRecordedEvent, publishRunTransition as publishRunTransitionEvent, publishTaskRunStarted as publishTaskRunStartedEvent, } from "./event-publishers.js";
@@ -16,6 +16,10 @@ import { runControlPlaneSchedulerForTaskArrival, runControlPlaneSchedulerNow, }
 import { startControlPlaneRunForTask } from "./run-start.js";
 import { runSendClarificationRoundMessage, runSubmitClarificationRound, } from "./clarification-commands.js";
 import { emitWorklistCompletedFeedback, emitWorklistFailedFeedback, } from "./worklist-terminal-feedback.js";
+import { mainChatInvalidates } from "./invalidations.js";
+function artifactPreviewChangedPaths(paths) {
+    return paths?.some((path) => path === "tutti.artifact.json") ?? false;
+}
 export class Phase5ControlPlane {
     engine;
     runEngine;
@@ -270,6 +274,40 @@ export class Phase5ControlPlane {
     }
     publishRunResultRecorded(recorded) {
         publishRunResultRecordedEvent(this.events, recorded);
+        this.maybePublishArtifactPreviewMessage(recorded);
+    }
+    maybePublishArtifactPreviewMessage(recorded) {
+        const result = recorded.task_detail.detail.result;
+        if (result.promotion?.status !== "promoted" ||
+            !artifactPreviewChangedPaths(result.changed_paths)) {
+            return;
+        }
+        const runResultId = recorded.run_result.id;
+        if (hasMainChatArtifactPreviewMessage(this.store.db, runResultId)) {
+            return;
+        }
+        const title = "Preview updated";
+        const message = createMainChatAgentMessage(this.store.db, {
+            body: `${title}\n\nThe current artifact preview was updated by "${recorded.task.title}". Open Artifacts to review the latest preview.`,
+            refs: {
+                scratchpad_source: "exclude",
+                task_id: recorded.task.id,
+                activity_ref: recorded.run_result.activity_ref,
+                artifact_preview: {
+                    kind: "artifact_preview",
+                    title,
+                    status: "updated",
+                    task_id: recorded.task.id,
+                    run_result_id: runResultId,
+                },
+            },
+            now: this.now,
+        });
+        this.events.publish({
+            event_type: "message.created",
+            payload: { message },
+            invalidates: mainChatInvalidates(),
+        });
     }
     publishRunTransition(state) {
         publishRunTransitionEvent({

package/dist/control-plane/task-compile-output.js

@@ -1,5 +1,5 @@
-import { applyTaskCompileProposal, openNextTaskCompileClarificationRound, openTaskCompileClarificationRound, readWorklistProjection, submitScratchpadProjection, } from "../collaboration-state/index.js";
-import { clarificationInvalidates, taskCompileInvalidates, } from "./invalidations.js";
+import { applyTaskCompileProposal, createMainChatAgentMessage, hasMainChatWorklistCompileMessage, readCompiledTaskSummariesByWorkflowRef, openNextTaskCompileClarificationRound, openTaskCompileClarificationRound, readWorklistProjection, submitScratchpadProjection, } from "../collaboration-state/index.js";
+import { clarificationInvalidates, mainChatInvalidates, taskCompileInvalidates, } from "./invalidations.js";
 import { normalizeTaskCompileProposal } from "./task-proposal.js";
 const EMPTY_INITIAL_WORKLIST_CLARIFICATION = {
     title: "Worklist scope needed",
@@ -9,6 +9,51 @@ const EMPTY_INITIAL_WORKLIST_CLARIFICATION = {
 function countWorklistTasks(worklist) {
     return worklist.modules.reduce((count, module) => count + module.tasks.length, 0);
 }
+function taskCountLabel(count) {
+    return count === 1 ? "1 task" : `${count} tasks`;
+}
+function worklistCompileFallback(input) {
+    const lines = [input.title, ""];
+    for (const task of input.tasks) {
+        lines.push(`- ${task.title} (${task.module_name})`);
+        if (task.summary.trim().length > 0) {
+            lines.push(`  ${task.summary}`);
+        }
+    }
+    lines.push("", "Open Worklist to review the compiled tasks.");
+    return lines.join("\n");
+}
+function publishWorklistCompileMessage(input) {
+    if (hasMainChatWorklistCompileMessage(input.store.db, input.workflowRef)) {
+        return;
+    }
+    const tasks = readCompiledTaskSummariesByWorkflowRef(input.store.db, input.workflowRef);
+    if (tasks.length === 0) {
+        return;
+    }
+    const title = `Compiled ${taskCountLabel(tasks.length)} into Worklist`;
+    const message = createMainChatAgentMessage(input.store.db, {
+        body: worklistCompileFallback({ title, tasks }),
+        refs: {
+            scratchpad_source: "exclude",
+            workflow_ref: input.workflowRef,
+            activity_ref: input.activityRef,
+            worklist_compile: {
+                kind: "worklist_compile",
+                workflow_ref: input.workflowRef,
+                title,
+                task_count: tasks.length,
+                tasks,
+            },
+        },
+        now: input.now,
+    });
+    input.events.publish({
+        event_type: "message.created",
+        payload: { message },
+        invalidates: mainChatInvalidates(),
+    });
+}
 function openTaskCompileNeedsHuman(input) {
     const opened = input.continueFromRoundId === undefined
         ? openTaskCompileClarificationRound(input.store.db, {
@@ -110,6 +155,13 @@ export function applyTaskCompileProcedureOutput(input) {
         },
         invalidates: taskCompileInvalidates(),
     });
+    publishWorklistCompileMessage({
+        store: input.store,
+        events: input.events,
+        workflowRef: input.workflowRef,
+        activityRef: input.activityRef,
+        now: input.now,
+    });
     if (input.continueFromRoundId !== undefined) {
         return {
             kind: "completed",

package/dist/server-shell/cli/host-runtime-endpoint.d.ts

@@ -3,6 +3,9 @@ import type { MachineRuntimeEndpointRecord } from "./machine-local.js";
 export type FetchLike = (input: string | URL, init?: RequestInit) => Promise<Response>;
 export type HostRuntimeEndpointProbeResult = {
     kind: "alive";
+    readiness?: {
+        relay?: "not_connected" | "connected";
+    };
 } | {
     kind: "stale";
     reason: string;

package/dist/server-shell/cli/host-runtime-endpoint.js

@@ -5,12 +5,23 @@ function delay(ms) {
         setTimeout(resolve, ms);
     });
 }
-function isHostHealthPayload(value) {
+function parseHostHealthPayload(value) {
     if (typeof value !== "object" || value === null || Array.isArray(value)) {
-        return false;
+        return null;
     }
     const record = value;
-    return record.service === "tutti-host" && record.status === "ok";
+    if (record.service !== "tutti-host" || record.status !== "ok") {
+        return null;
+    }
+    if (typeof record.readiness !== "object" ||
+        record.readiness === null ||
+        Array.isArray(record.readiness)) {
+        return {};
+    }
+    const readiness = record.readiness;
+    return readiness.relay === "connected" || readiness.relay === "not_connected"
+        ? { relay: readiness.relay }
+        : {};
 }
 async function fetchWithTimeout(fetchImpl, url, init = {}, timeoutMs = DEFAULT_PROBE_TIMEOUT_MS) {
     const controller = new AbortController();
@@ -38,11 +49,14 @@ export function createRuntimeEndpointProbe(fetchImpl = fetch) {
             if (!response.ok) {
                 return { kind: "stale", reason: `health returned HTTP ${response.status}` };
             }
-            const payload = await response.json();
-            if (!isHostHealthPayload(payload)) {
+            const readiness = parseHostHealthPayload(await response.json());
+            if (readiness === null) {
                 return { kind: "stale", reason: "health response is not a Tutti host" };
             }
-            return { kind: "alive" };
+            return {
+                kind: "alive",
+                ...(readiness.relay === undefined ? {} : { readiness }),
+            };
         }
         catch (error) {
             const reason = error instanceof Error ? error.message : "health check failed";

package/dist/server-shell/cli/runtime-commands.d.ts

@@ -4,7 +4,7 @@ import { type MachineRuntimeEndpointRecord } from "./machine-local.js";
 import type { LocalControlFetch } from "./local-control-client.js";
 export type RuntimeProjectRow = {
     project_id: ProjectId;
-    status: "online" | "stale";
+    status: "online" | "offline" | "stale";
     display_name: string;
     workspace_root: string;
     endpoint?: string;

package/dist/server-shell/cli/runtime-commands.js

@@ -11,6 +11,7 @@ import { resolveManagedProjectContext } from "./project-resolver.js";
 import { formatJoinLinkValidity, renderTerminalQr } from "./terminal-qr.js";
 import { resolveTuttiHome } from "../../providers/openai/index.js";
 import { readCliVersion } from "./version.js";
+import { readProjectIdentity } from "./project-identity.js";
 const PROJECT_ID_DISPLAY_MIN_LENGTH = 12;
 function resolveProject(target, options = {}) {
     return resolveManagedProjectContext({
@@ -45,6 +46,30 @@ function readBindingFile(tuttiHome, projectId) {
         return null;
     }
 }
+function workspaceBelongsToProject(workspaceRoot, projectId) {
+    if (!existsSync(workspaceRoot)) {
+        return false;
+    }
+    try {
+        const identity = readProjectIdentity(workspaceRoot);
+        return identity.kind === "present" && identity.project_id === projectId;
+    }
+    catch {
+        return false;
+    }
+}
+async function cleanupOrphanedRuntimeProject(options) {
+    if (options.hostAlive) {
+        await requestHostLocalShutdown({
+            endpoint: options.endpoint,
+            ...(options.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+        }).catch(() => undefined);
+    }
+    deleteMachineProjectLocalState({
+        tuttiHome: options.tuttiHome,
+        projectId: options.projectId,
+    });
+}
 export function formatProjectIdForDisplay(projectId, projectIds) {
     for (let length = Math.min(PROJECT_ID_DISPLAY_MIN_LENGTH, projectId.length); length <= projectId.length; length += 1) {
         const prefix = projectId.slice(0, length);
@@ -65,13 +90,27 @@ export async function listRuntimeProjects(options = {}) {
             continue;
         }
         const binding = readBindingFile(tuttiHome, projectId);
+        const workspaceRoot = binding?.workspace_root ?? endpoint.workspace_root;
+        const displayName = binding?.workspace_root === undefined
+            ? projectId
+            : binding.workspace_root.split(/[\\/]/u).pop() ?? projectId;
         const health = await probe(endpoint);
+        if (!workspaceBelongsToProject(workspaceRoot, projectId)) {
+            await cleanupOrphanedRuntimeProject({
+                tuttiHome,
+                projectId,
+                endpoint,
+                hostAlive: health.kind === "alive",
+                ...(options.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+            });
+            continue;
+        }
         if (health.kind === "stale") {
             rows.push({
                 project_id: projectId,
                 status: "stale",
-                display_name: binding?.workspace_root === undefined ? projectId : binding.workspace_root.split(/[\\/]/u).pop() ?? projectId,
-                workspace_root: binding?.workspace_root ?? endpoint.workspace_root,
+                display_name: displayName,
+                workspace_root: workspaceRoot,
                 endpoint: endpoint.base_url,
             });
             continue;
@@ -84,9 +123,9 @@ export async function listRuntimeProjects(options = {}) {
         ]);
         const row = {
             project_id: projectId,
-            status: "online",
-            display_name: project.status === "fulfilled" ? project.value.display_name : binding?.workspace_root.split(/[\\/]/u).pop() ?? projectId,
-            workspace_root: binding?.workspace_root ?? endpoint.workspace_root,
+            status: health.readiness?.relay === "connected" ? "online" : "offline",
+            display_name: project.status === "fulfilled" ? project.value.display_name : displayName,
+            workspace_root: workspaceRoot,
             endpoint: endpoint.base_url,
         };
         if (provider.status === "fulfilled") {

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

@@ -109,6 +109,14 @@ export declare const HOST_PROJECT_COLLABORATION_OPENAPI_ROUTES: ({
                     open_questions: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
                     task_changes: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
                     submitted_at: import("@sinclair/typebox").TString;
+                    compiled_tasks: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+                        task_id: import("@sinclair/typebox").TString;
+                        title: import("@sinclair/typebox").TString;
+                        summary: import("@sinclair/typebox").TString;
+                        status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"todo">, import("@sinclair/typebox").TLiteral<"running">, import("@sinclair/typebox").TLiteral<"pending">, import("@sinclair/typebox").TLiteral<"done">, import("@sinclair/typebox").TLiteral<"failed">]>;
+                        module_id: import("@sinclair/typebox").TString;
+                        module_name: import("@sinclair/typebox").TString;
+                    }>>>;
                 }>>;
             }>;
             contentType?: never;

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

@@ -969,6 +969,14 @@ export declare const HOST_PROJECT_WORKSPACE_OPENAPI_ROUTES: ({
                                     open_questions: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
                                     task_changes: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
                                     submitted_at: import("@sinclair/typebox").TString;
+                                    compiled_tasks: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+                                        task_id: import("@sinclair/typebox").TString;
+                                        title: import("@sinclair/typebox").TString;
+                                        summary: import("@sinclair/typebox").TString;
+                                        status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"todo">, import("@sinclair/typebox").TLiteral<"running">, import("@sinclair/typebox").TLiteral<"pending">, import("@sinclair/typebox").TLiteral<"done">, import("@sinclair/typebox").TLiteral<"failed">]>;
+                                        module_id: import("@sinclair/typebox").TString;
+                                        module_name: import("@sinclair/typebox").TString;
+                                    }>>>;
                                 }>>;
                             }>;
                             readonly worklist: import("@sinclair/typebox").TObject<{

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

@@ -271,6 +271,14 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
                     open_questions: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
                     task_changes: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
                     submitted_at: import("@sinclair/typebox").TString;
+                    compiled_tasks: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+                        task_id: import("@sinclair/typebox").TString;
+                        title: import("@sinclair/typebox").TString;
+                        summary: import("@sinclair/typebox").TString;
+                        status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"todo">, import("@sinclair/typebox").TLiteral<"running">, import("@sinclair/typebox").TLiteral<"pending">, import("@sinclair/typebox").TLiteral<"done">, import("@sinclair/typebox").TLiteral<"failed">]>;
+                        module_id: import("@sinclair/typebox").TString;
+                        module_name: import("@sinclair/typebox").TString;
+                    }>>>;
                 }>>;
             }>;
             contentType?: never;
@@ -2226,6 +2234,14 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
                                     open_questions: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
                                     task_changes: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
                                     submitted_at: import("@sinclair/typebox").TString;
+                                    compiled_tasks: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+                                        task_id: import("@sinclair/typebox").TString;
+                                        title: import("@sinclair/typebox").TString;
+                                        summary: import("@sinclair/typebox").TString;
+                                        status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"todo">, import("@sinclair/typebox").TLiteral<"running">, import("@sinclair/typebox").TLiteral<"pending">, import("@sinclair/typebox").TLiteral<"done">, import("@sinclair/typebox").TLiteral<"failed">]>;
+                                        module_id: import("@sinclair/typebox").TString;
+                                        module_name: import("@sinclair/typebox").TString;
+                                    }>>>;
                                 }>>;
                             }>;
                             readonly worklist: import("@sinclair/typebox").TObject<{

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

@@ -951,6 +951,14 @@ export declare const BootstrapResponseSchema: {
                         open_questions: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
                         task_changes: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
                         submitted_at: import("@sinclair/typebox").TString;
+                        compiled_tasks: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+                            task_id: import("@sinclair/typebox").TString;
+                            title: import("@sinclair/typebox").TString;
+                            summary: import("@sinclair/typebox").TString;
+                            status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"todo">, import("@sinclair/typebox").TLiteral<"running">, import("@sinclair/typebox").TLiteral<"pending">, import("@sinclair/typebox").TLiteral<"done">, import("@sinclair/typebox").TLiteral<"failed">]>;
+                            module_id: import("@sinclair/typebox").TString;
+                            module_name: import("@sinclair/typebox").TString;
+                        }>>>;
                     }>>;
                 }>;
                 readonly worklist: import("@sinclair/typebox").TObject<{

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

@@ -526,6 +526,20 @@ export declare const SendClarificationRoundMessageResultSchema: import("@sinclai
                     blocked_reason: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"binary">, import("@sinclair/typebox").TLiteral<"too_large">, import("@sinclair/typebox").TLiteral<"unsupported_encoding">, import("@sinclair/typebox").TLiteral<"restricted_path">, import("@sinclair/typebox").TLiteral<"secret_like">, import("@sinclair/typebox").TLiteral<"unknown">]>>;
                 }>;
             }>>;
+            worklist_compile: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                kind: import("@sinclair/typebox").TLiteral<"worklist_compile">;
+                workflow_ref: import("@sinclair/typebox").TString;
+                title: import("@sinclair/typebox").TString;
+                task_count: import("@sinclair/typebox").TInteger;
+                tasks: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+                    task_id: import("@sinclair/typebox").TString;
+                    title: import("@sinclair/typebox").TString;
+                    summary: import("@sinclair/typebox").TString;
+                    status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"todo">, import("@sinclair/typebox").TLiteral<"running">, import("@sinclair/typebox").TLiteral<"pending">, import("@sinclair/typebox").TLiteral<"done">, import("@sinclair/typebox").TLiteral<"failed">]>;
+                    module_id: import("@sinclair/typebox").TString;
+                    module_name: import("@sinclair/typebox").TString;
+                }>>;
+            }>>;
             worklist_feedback: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
                 kind: import("@sinclair/typebox").TLiteral<"worklist_terminal">;
                 status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"completed">, import("@sinclair/typebox").TLiteral<"failed">]>;
@@ -555,6 +569,13 @@ export declare const SendClarificationRoundMessageResultSchema: import("@sinclai
                 }>>>;
                 primary_task_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
             }>>;
+            artifact_preview: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                kind: import("@sinclair/typebox").TLiteral<"artifact_preview">;
+                title: import("@sinclair/typebox").TString;
+                status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"available">, import("@sinclair/typebox").TLiteral<"updated">]>;
+                task_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                run_result_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            }>>;
         }>>;
         clarification_card: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
             thread_id: import("@sinclair/typebox").TString;

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

@@ -6,8 +6,8 @@ export { ProviderUsageBreakdownProjectionSchema, ProviderUsageCategorySchema, Pr
 export { ProjectTimelineChangeStatusSchema, ProjectTimelineClarificationTraceSchema, ProjectTimelineDecisionSummarySchema, ProjectTimelineItemKindSchema, ProjectTimelineItemSchema, ProjectTimelineItemStatusSchema, ProjectTimelineResponseSchema, ProjectTimelineSourceSnippetSchema, ProjectTimelineTaskUpdateStateSchema, ProjectTimelineTraceCardSchema, ProjectTimelineTraceLinkSchema, ProjectTimelineTraceToneSchema, } from "./project-timeline.js";
 export { MAX_REFERENCE_STAGED_UPLOAD_BYTES, MAX_SKILL_ZIP_STAGED_UPLOAD_BYTES, MAX_STAGED_UPLOAD_BYTES, PresignedUploadPutSchema, ReferenceFileStartRelayUploadPayloadSchema, ReferenceStagedUploadReferenceProperties, RelayUploadProjectionSchema, RelayUploadPurposeSchema, Sha256DigestSchema, SkillZipStartRelayUploadPayloadSchema, SkillZipStagedUploadReferenceProperties, StagedUploadReferenceProperties, StagedUploadReferenceSchema, StartRelayUploadBodySchema, StartRelayUploadDispositionSchema, StartRelayUploadPayloadSchema, StartRelayUploadResponseSchema, StartRelayUploadResultSchema, maxStagedUploadBytesForPurpose, } from "./uploads.js";
 export { MarkReadBodySchema, MarkReadDispositionSchema, MarkReadPayloadSchema, MarkReadResponseSchema, MarkReadResultSchema, ReadStateScopeProjectionSchema, ReadStateScopeSchema, ReadStateSummaryProjectionSchema, } from "./read-state.js";
-export { GetMessagesRequestSchema, MessageAuthorSchema, MessageCreatedEventPayloadSchema, MessageKindSchema, MessageProjectionSchema, MessageReferenceFileRefSchema, MessageRefsSchema, MessageScopeSchema, MessageWindowSchema, ReferenceFileCategorySchema, SendMainChatMessageBodySchema, SendMainChatMessageCreatedDispositionSchema, SendMainChatMessageDispositionSchema, SendMainChatMessagePayloadSchema, SendMainChatMessageResponseSchema, SendMainChatMessageResultSchema, WorklistFeedbackItemSchema, WorklistFeedbackGeneratedFileSchema, WorklistFeedbackRefSchema, } from "./messages.js";
-export { CheckSkipReasonCodeSchema, ExternalSideEffectSummaryProjectionSchema, GetRecoverySummariesRequestSchema, GetRecoverySummariesResponseSchema, GetRecoverySummaryResponseSchema, RecoverySummaryProjectionSchema, ResultAnchorSchema, RunLineageSchema, RunResultProjectionSchema, ScratchpadProjectionSchema, ScratchpadReceiptProjectionSchema, TaskContractProjectionSchema, TaskDetailProjectionSchema, TaskDetailResultProjectionSchema, TaskModuleProjectionSchema, TaskProjectionSchema, TaskRunResultsPageSchema, TaskStatusSchema, WorklistProjectionSchema, } from "./work-items.js";
+export { GetMessagesRequestSchema, MessageAuthorSchema, MessageCreatedEventPayloadSchema, MessageKindSchema, MessageProjectionSchema, MessageReferenceFileRefSchema, MessageRefsSchema, MessageScopeSchema, MessageWindowSchema, ReferenceFileCategorySchema, SendMainChatMessageBodySchema, SendMainChatMessageCreatedDispositionSchema, SendMainChatMessageDispositionSchema, SendMainChatMessagePayloadSchema, SendMainChatMessageResponseSchema, SendMainChatMessageResultSchema, ArtifactPreviewRefSchema, WorklistCompileRefSchema, WorklistFeedbackItemSchema, WorklistFeedbackGeneratedFileSchema, WorklistFeedbackRefSchema, } from "./messages.js";
+export { CheckSkipReasonCodeSchema, ExternalSideEffectSummaryProjectionSchema, GetRecoverySummariesRequestSchema, GetRecoverySummariesResponseSchema, GetRecoverySummaryResponseSchema, RecoverySummaryProjectionSchema, ResultAnchorSchema, RunLineageSchema, RunResultProjectionSchema, ScratchpadProjectionSchema, ScratchpadReceiptProjectionSchema, TaskContractProjectionSchema, TaskDetailProjectionSchema, TaskDetailResultProjectionSchema, TaskModuleProjectionSchema, TaskProjectionSchema, TaskRunResultsPageSchema, TaskStatusSchema, WorklistCompiledTaskSummarySchema, WorklistProjectionSchema, } from "./work-items.js";
 export { ActiveApprovalProjectionSchema, ApprovalCommandProjectionSchema, ApprovalDecisionKindSchema, ApprovalDecisionOptionProjectionSchema, ApprovalDecisionToneSchema, ApprovalFileChangeProjectionSchema, ApprovalPermissionsProjectionSchema, ApprovalRequestKindSchema, ApprovalRequestProjectionSchema, ApprovalResolutionOutcomeSchema, ApprovalResolutionProjectionSchema, DecideApprovalBodySchema, DecideApprovalDispositionSchema, DecideApprovalPayloadSchema, DecideApprovalResponseSchema, DecideApprovalResultSchema, } from "./approvals.js";
 export { ActiveClarificationProjectionSchema, ClarificationChangedEventPayloadSchema, ClarificationOwnerProjectionSchema, ClarificationRequestPayloadSchema, ClarificationRoundProjectionSchema, ClarificationRoundSummaryProjectionSchema, ClarificationSuccessorRefSchema, ClarificationThreadProjectionSchema, ContextRefSchema, GetClarificationRoundMessagesRequestSchema, GetClarificationRoundResponseSchema, GetClarificationThreadResponseSchema, HumanInteractionPayloadSchema, HumanRequestPayloadSchema, SendClarificationRoundMessageBodySchema, SendClarificationRoundMessageDispositionSchema, SendClarificationRoundMessagePayloadSchema, SendClarificationRoundMessageResponseSchema, SendClarificationRoundMessageResultSchema, SubmitClarificationRoundBodySchema, SubmitClarificationRoundDispositionSchema, SubmitClarificationRoundPayloadSchema, SubmitClarificationRoundResponseSchema, SubmitClarificationRoundResultSchema, } from "./clarifications.js";
 export { GetProjectDocRequestSchema, GetProjectDocResponseSchema, GetProjectDocsResponseSchema, GetReferenceFilesRequestSchema, GetReferenceFilesResponseSchema, GetViewerAssetRequestSchema, GetViewerFileRequestSchema, GetViewerFileResponseSchema, GetViewerTreeRequestSchema, GetViewerTreeResponseSchema, ProjectDocKeySchema, ProjectDocParamsSchema, ProjectDocSummaryProjectionSchema, ReferenceDirectoryProjectionSchema, ReferenceFileProjectionSchema, ReferenceSummaryProjectionSchema, ReferenceTextReadBlockedReasonSchema, RefreshReferenceSummariesBodySchema, RefreshReferenceSummariesDispositionSchema, RefreshReferenceSummariesPayloadSchema, RefreshReferenceSummariesResponseSchema, RefreshReferenceSummariesResultSchema, UploadReferenceFileBodySchema, UploadReferenceFileDispositionSchema, UploadReferenceFilePayloadSchema, UploadReferenceFileResponseSchema, UploadReferenceFileResultSchema, ViewerAssetVariantSchema, ViewerFileContentProjectionSchema, ViewerFileProjectionSchema, ViewerPageSchema, ViewerPathSchema, ViewerRepoSnapshotSchema, ViewerTreeEntryProjectionSchema, ViewerTreeTextReadBlockedReasonSchema, ViewerUnreadableReasonSchema, } from "./viewer-reference.js";