@xfey/tutti 0.1.52 → 0.1.54

package/dist/artifacts/static-preview.js

@@ -1,9 +1,9 @@
-import { posix } from "node:path";
+import { lstatSync, readFileSync, realpathSync } from "node:fs";
+import { isAbsolute, posix, relative, resolve } from "node:path";
 import { VIEWER_HARD_READ_LIMIT_BYTES } from "../workspace-ops/constants.js";
 import { WorkspaceOpsError } from "../workspace-ops/errors.js";
-import { entryKind, lsPath, readBlob, requireFileEntry } from "../workspace-ops/viewer-git.js";
 import { requireNormalizedViewerPath } from "../workspace-ops/viewer-paths.js";
-import { readArtifactDeclaration } from "./manifest.js";
+import { readLiveArtifactDeclaration, } from "./live-manifest.js";
 export const ARTIFACT_PREVIEW_CSP = [
     "default-src 'none'",
     "script-src 'self' https: 'unsafe-inline' 'unsafe-eval' blob:",
@@ -139,10 +139,7 @@ function requireDeclaredStaticArtifact(declaration) {
     return declaration;
 }
 export function readArtifactStaticPreview(options) {
-    const declaration = requireDeclaredStaticArtifact(readArtifactDeclaration({
-        workspaceRoot: options.workspaceRoot,
-        ...(options.now === undefined ? {} : { now: options.now }),
-    }));
+    const declaration = requireDeclaredStaticArtifact(options.declaration ?? readLiveArtifactDeclaration({ workspaceRoot: options.workspaceRoot }));
     const runtime = declaration.runtime;
     if (runtime.kind !== "static") {
         throw new WorkspaceOpsError("validation_failed", "Artifact is not static");
@@ -150,30 +147,31 @@ export function readArtifactStaticPreview(options) {
     const requestedPath = requireSafeArtifactAssetPath(decodePath(options.path));
     const relativePath = requestedPath === "" ? runtime.entry_path : requestedPath;
     const repoPath = runtime.root_path === "" ? relativePath : posix.join(runtime.root_path, relativePath);
-    const entry = lsPath(options.workspaceRoot, repoPath);
-    if (entry === null) {
-        throw new WorkspaceOpsError("not_found", "Artifact preview file was not found");
-    }
-    if (entryKind(entry) !== "file") {
-        throw new WorkspaceOpsError("validation_failed", "Artifact preview path is not a file");
+    let filePath;
+    let entrySize;
+    try {
+        const workspaceRealPath = realpathSync.native(options.workspaceRoot);
+        filePath = realpathSync.native(resolve(workspaceRealPath, repoPath));
+        const relativePath = relative(workspaceRealPath, filePath);
+        if ((relativePath !== "" && (relativePath.startsWith("..") || isAbsolute(relativePath))) ||
+            !lstatSync(filePath).isFile()) {
+            throw new Error("Artifact preview path is not a contained file");
+        }
+        entrySize = lstatSync(filePath).size;
     }
-    if (entry.size === undefined || !Number.isSafeInteger(entry.size)) {
-        throw new WorkspaceOpsError("git_failed", "Artifact preview file size is unavailable");
+    catch {
+        throw new WorkspaceOpsError("not_found", "Artifact preview file was not found");
     }
-    if (entry.size > VIEWER_HARD_READ_LIMIT_BYTES) {
+    if (entrySize > VIEWER_HARD_READ_LIMIT_BYTES) {
         throw new WorkspaceOpsError("validation_failed", "Artifact preview file is too large");
     }
-    const fileEntry = requireFileEntry({
-        workspaceRoot: options.workspaceRoot,
-        path: repoPath,
-    });
     const mediaType = mediaTypeFor(repoPath);
     return {
         media_type: mediaType,
         content: rewriteArtifactPreviewResourceUrls({
             mediaType,
             resourcePath: relativePath,
-            content: readBlob(options.workspaceRoot, fileEntry.oid, fileEntry.size),
+            content: readFileSync(filePath),
         }),
     };
 }

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

@@ -15,6 +15,7 @@ export declare class Phase5ControlPlane {
     private readonly readActiveApproval;
     private readonly logger;
     private readonly projectContext;
+    private readonly runLifecycle;
     private readonly now;
     private readonly scratchpadAutoRefreshScheduler;
     private lastRecoveryConclusion;

package/dist/control-plane/index.js

@@ -27,6 +27,7 @@ export class Phase5ControlPlane {
     readActiveApproval;
     logger;
     projectContext;
+    runLifecycle;
     now;
     scratchpadAutoRefreshScheduler;
     lastRecoveryConclusion = null;
@@ -39,6 +40,7 @@ export class Phase5ControlPlane {
         this.readActiveApproval = options.readActiveApproval;
         this.logger = options.logger;
         this.projectContext = options.projectContext;
+        this.runLifecycle = options.runLifecycle;
         this.now = options.now ?? (() => new Date());
         this.engine = new ProcedureEngine({ now: this.now });
         this.runEngine = new RunEngine({ now: this.now });
@@ -203,7 +205,7 @@ export class Phase5ControlPlane {
         }
     }
     startRunForTask(input) {
-        return startControlPlaneRunForTask({
+        const result = startControlPlaneRunForTask({
             runEngine: this.runEngine,
             store: this.store,
             run: input,
@@ -211,10 +213,19 @@ export class Phase5ControlPlane {
             resolveWorkflowRunner: this.resolveWorkflowRunner,
             logger: this.logger,
             now: this.now,
-            publishRunTransition: (state) => this.publishRunTransition(state),
+            publishRunTransition: (state) => {
+                this.publishRunTransition(state);
+                if (state.transition_kind === "terminal") {
+                    this.runLifecycle?.settled();
+                }
+            },
             publishTaskRunStarted: (task, activityRef) => this.publishTaskRunStarted(task, activityRef),
             publishRunResultRecorded: (recorded) => this.publishRunResultRecorded(recorded),
         });
+        if (result.kind === "accepted") {
+            this.runLifecycle?.started();
+        }
+        return result;
     }
     readActiveRun() {
         const runStatus = this.runEngine.getExecutionStatus();

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

@@ -19,6 +19,10 @@ export type Phase5ControlPlaneOptions = {
         workspaceRoot: string;
         projectName: string;
     };
+    runLifecycle?: {
+        started: () => void;
+        settled: () => void;
+    };
     now?: () => Date;
 };
 export type ControlPlaneLogger = Pick<RuntimeLogger, "info">;

package/dist/run-pipeline/openai.js

@@ -1,5 +1,4 @@
 import { createNodeNpmCheckPlan, executeCheckPlan } from "../checks/index.js";
-import { candidateChangedAfterChecks } from "./candidate-diff.js";
 import { runArtifactCandidateGate, } from "./artifact-applicability.js";
 import { checkSkipFields, checkStatus, checksSummary, completedWithoutRepoChanges, docsStatusForChangedPaths, failedBeforeChecks, failedFinishedResult, promotionNotAttempted, promotionNotPromoted, successfulRunSummary, } from "./result-projections.js";
 import { runWorkspaceWriteTask } from "./task-run-invocation.js";
@@ -94,7 +93,7 @@ function stageProgressSummary(stage) {
         case "checks":
             return "running project checks.";
         case "post_checks_diff_collect":
-            return "rechecking candidate changes after checks.";
+            return "collecting the final project changes after checks.";
         case "accepted_checkpoint":
             return "saving the validated project state as an accepted checkpoint.";
         case "self_correction":
@@ -358,21 +357,18 @@ async function runTaskAttempt(options, input) {
         const postChecksDiff = loggedSyncStage(options, input, "post_checks_diff_collect", () => collectProjectSourceDiff(options.workspaceRoot), (result) => ({ changed_path_count: result.changed_paths.length }));
         changedPaths = postChecksDiff.changed_paths;
         docs = docsStatusForChangedPaths(changedPaths);
-        if (candidateChangedAfterChecks(diff, postChecksDiff)) {
+        if (!postChecksDiff.has_changes) {
             const result = failedFinishedResult({
-                summary: "Checks modified the candidate workspace; promotion was not attempted.",
-                checks: {
-                    status: "failed",
-                    commands: checks.commands,
-                },
+                summary: "Checks completed but no candidate changes remain for acceptance.",
+                checks,
                 docs,
                 changedPaths,
-                promotion: promotionNotAttempted("checks_modified_candidate", "Checks changed tracked candidate files, so promotion was not attempted."),
+                promotion: promotionNotAttempted("no_candidate_changes", "No candidate changes were available for promotion after checks."),
             });
             return requestSelfCorrection({
                 result,
-                reasonCode: "checks_modified_candidate",
-                guidance: "Prevent checks from mutating tracked files, or intentionally produce those generated files before checks run.",
+                reasonCode: "no_candidate_changes",
+                guidance: "Produce a concrete final candidate diff for the frozen task contract.",
             });
         }
         const checkpoint = loggedSyncStage(options, input, "accepted_checkpoint", () => createAcceptedCheckpoint({
@@ -380,7 +376,6 @@ async function runTaskAttempt(options, input) {
             taskId: input.task.id,
             activityRef: input.activity_ref,
             summary: `Complete Tutti task: ${input.task.title}`,
-            expectedSourceFingerprint: postChecksDiff.fingerprint,
         }), (result) => ({
             promoted_commit_oid: result.promoted_commit_oid,
             checkpoint_disposition: result.disposition,

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

@@ -2,6 +2,7 @@ import { basename, join } from "node:path";
 import { serializeRuntimeLogLine } from "@tutti/shared/utils";
 import { completeRelayUpload, resolveRelayUpload } from "@tutti/relay-client";
 import { ApprovalRequestManager } from "../../approvals/index.js";
+import { ArtifactPreviewManager } from "../../artifacts/index.js";
 import { ReadOnlyChatAssistant } from "../../chat-assistant/index.js";
 import { ensureInitialProjectWelcomeMessage } from "../../collaboration-state/index.js";
 import { Phase5ControlPlane } from "../../control-plane/index.js";
@@ -208,12 +209,30 @@ export async function startForegroundHostServer(options) {
         events: workspaceEvents,
         now,
     });
+    const artifactPreviewManager = new ArtifactPreviewManager({
+        onStatusChange: () => {
+            workspaceEvents.publish({
+                event_type: "query.invalidate",
+                payload: {
+                    reason: "bulk_state_change",
+                    message: "Artifacts changed.",
+                },
+                invalidates: [{ kind: "artifacts" }],
+            });
+        },
+    });
     const controlPlane = new Phase5ControlPlane({
         store,
         events: workspaceEvents,
         now,
         logger: controlPlaneLogger,
         projectContext,
+        runLifecycle: {
+            started: () => artifactPreviewManager.beginWorkspaceUpdate(),
+            settled: () => artifactPreviewManager.settleWorkspaceUpdate({
+                workspaceRoot: options.preparation.workspace_root,
+            }),
+        },
         readActiveApproval: () => approvalManager.getActiveApproval(),
         readMainlineStatus: () => ({
             mainline_clean: readHostRepoProjection(options.preparation.workspace_root).mainline_clean,
@@ -362,6 +381,7 @@ export async function startForegroundHostServer(options) {
                         : { refreshJoinUrl: options.refreshRelayJoinUrl }),
                 },
                 trustedMetadataStore,
+                artifactPreviewManager,
                 store,
                 events: workspaceEvents,
                 controlPlane,

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

@@ -1,9 +1,8 @@
-import { HeartbeatArtifactPreviewBodySchema, HeartbeatArtifactPreviewResponseSchema, GetArtifactsResponseSchema, StartArtifactPreviewBodySchema, StartArtifactPreviewResponseSchema, StopArtifactPreviewBodySchema, StopArtifactPreviewResponseSchema, } from "@tutti/shared/schemas/api";
-import { ARTIFACT_PREVIEW_REQUEST_BODY_LIMIT_BYTES, ARTIFACT_PREVIEW_CSP, ArtifactPreviewManager, isArtifactPreviewHttpMethod, readArtifactProjection, readArtifactStaticPreview, } from "../../../../artifacts/index.js";
+import { GetArtifactsResponseSchema, } from "@tutti/shared/schemas/api";
+import { ARTIFACT_PREVIEW_REQUEST_BODY_LIMIT_BYTES, ARTIFACT_PREVIEW_CSP, ArtifactPreviewManager, isArtifactPreviewHttpMethod, } from "../../../../artifacts/index.js";
 import { WorkspaceOpsError } from "../../../../workspace-ops/index.js";
-import { executeIdempotentCommand } from "../../../command-idempotency/index.js";
 import { HOST_PROJECT_API_BASE_PATH } from "./constants.js";
-import { requireHostProjectSession, requireProjectStore, requireWorkspaceRoot, } from "./session-requirements.js";
+import { requireHostProjectSession, requireWorkspaceRoot, } from "./session-requirements.js";
 function artifactInvalidates() {
     return [{ kind: "artifacts" }];
 }
@@ -32,27 +31,27 @@ function previewRequestBody(body) {
     }
     return Buffer.from(JSON.stringify(body), "utf8");
 }
-function requireCurrentArtifactManifestMarker(request, manifestBlobOid) {
-    const marker = new URL(request.url, "http://artifact.invalid").searchParams.get("v");
-    if (marker !== null && marker !== manifestBlobOid) {
-        throw new WorkspaceOpsError("not_found", "Artifact preview manifest is stale");
+function requireCurrentArtifactGeneration(request, previewGeneration) {
+    const marker = new URL(request.url, "http://artifact.invalid").searchParams.get("g");
+    if (marker !== previewGeneration) {
+        throw new WorkspaceOpsError("not_found", "Artifact preview generation is stale");
     }
 }
 export function registerArtifactsRoutes(app, { options, workspaceEvents, }) {
-    const artifactPreviewManager = new ArtifactPreviewManager({
-        ...options.artifactPreview,
-        ...(options.now === undefined ? {} : { now: options.now }),
-        onStatusChange: () => {
-            workspaceEvents.publish({
-                event_type: "query.invalidate",
-                payload: {
-                    reason: "bulk_state_change",
-                    message: "Artifacts changed.",
-                },
-                invalidates: artifactInvalidates(),
-            });
-        },
-    });
+    const artifactPreviewManager = options.artifactPreviewManager ??
+        new ArtifactPreviewManager({
+            ...options.artifactPreview,
+            onStatusChange: () => {
+                workspaceEvents.publish({
+                    event_type: "query.invalidate",
+                    payload: {
+                        reason: "bulk_state_change",
+                        message: "Artifacts changed.",
+                    },
+                    invalidates: artifactInvalidates(),
+                });
+            },
+        });
     app.addHook("onClose", async () => {
         await artifactPreviewManager.stopAll();
     });
@@ -68,6 +67,23 @@ export function registerArtifactsRoutes(app, { options, workspaceEvents, }) {
             workspaceRoot: requireWorkspaceRoot(options),
         });
     });
+    app.post(`${HOST_PROJECT_API_BASE_PATH}/artifacts/preview/lease`, {
+        schema: {
+            response: {
+                204: { type: "null" },
+            },
+        },
+    }, (request, reply) => {
+        if (request.body !== undefined) {
+            throw new WorkspaceOpsError("bad_request", "Artifact preview lease does not accept a request body");
+        }
+        const session = requireHostProjectSession(request, options);
+        artifactPreviewManager.renewLease({
+            viewerId: session.client_session.client_session_id,
+            workspaceRoot: requireWorkspaceRoot(options),
+        });
+        void reply.code(204).send();
+    });
     app.all("/artifacts/preview/*", {
         bodyLimit: ARTIFACT_PREVIEW_REQUEST_BODY_LIMIT_BYTES,
     }, async (request, reply) => {
@@ -81,12 +97,9 @@ export function registerArtifactsRoutes(app, { options, workspaceEvents, }) {
             return;
         }
         const workspaceRoot = requireWorkspaceRoot(options);
-        const projection = readArtifactProjection({
-            workspaceRoot,
-            ...(options.now === undefined ? {} : { now: options.now }),
-        });
+        const projection = artifactPreviewManager.readProjection();
         if (projection.artifact.status === "declared") {
-            requireCurrentArtifactManifestMarker(request, projection.artifact.manifest_blob_oid);
+            requireCurrentArtifactGeneration(request, projection.artifact.preview_generation);
         }
         if (projection.artifact.status === "declared" &&
             projection.artifact.artifact.kind === "server") {
@@ -118,10 +131,11 @@ export function registerArtifactsRoutes(app, { options, workspaceEvents, }) {
                 .send("Static Artifact previews only support GET and HEAD");
             return;
         }
-        const preview = readArtifactStaticPreview({
+        const queryIndex = request.url.indexOf("?");
+        const preview = artifactPreviewManager.readStaticPreview({
             workspaceRoot,
             path: request.params["*"],
-            ...(options.now === undefined ? {} : { now: options.now }),
+            ...(queryIndex < 0 ? {} : { query: request.url.slice(queryIndex + 1) }),
         });
         void reply
             .header("content-type", preview.media_type)
@@ -130,86 +144,5 @@ export function registerArtifactsRoutes(app, { options, workspaceEvents, }) {
             .header("cache-control", "private, max-age=60")
             .send(preview.content);
     });
-    app.post(`${HOST_PROJECT_API_BASE_PATH}/artifacts/preview/start`, {
-        schema: {
-            body: StartArtifactPreviewBodySchema,
-            response: {
-                200: StartArtifactPreviewResponseSchema,
-            },
-        },
-    }, (request) => {
-        requireHostProjectSession(request, options);
-        const store = requireProjectStore(options);
-        const invalidates = artifactInvalidates();
-        const execution = executeIdempotentCommand({
-            db: store.db,
-            command_id: request.body.command_id,
-            command_name: "artifacts.preview.start",
-            target_ref: "artifacts:active",
-            payload: request.body.payload,
-            ...(options.now === undefined ? {} : { now: options.now }),
-            execute: () => artifactPreviewManager.start({ workspaceRoot: requireWorkspaceRoot(options) }),
-        });
-        return {
-            command_id: execution.command_id,
-            disposition: execution.disposition,
-            ...(execution.result === undefined ? {} : { result: execution.result }),
-            invalidates,
-        };
-    });
-    app.post(`${HOST_PROJECT_API_BASE_PATH}/artifacts/preview/heartbeat`, {
-        schema: {
-            body: HeartbeatArtifactPreviewBodySchema,
-            response: {
-                200: HeartbeatArtifactPreviewResponseSchema,
-            },
-        },
-    }, (request) => {
-        const session = requireHostProjectSession(request, options);
-        const store = requireProjectStore(options);
-        const invalidates = artifactInvalidates();
-        const execution = executeIdempotentCommand({
-            db: store.db,
-            command_id: request.body.command_id,
-            command_name: "artifacts.preview.heartbeat",
-            target_ref: `artifacts:active:${session.client_session.client_session_id}`,
-            payload: request.body.payload,
-            ...(options.now === undefined ? {} : { now: options.now }),
-            execute: () => artifactPreviewManager.heartbeat({ workspaceRoot: requireWorkspaceRoot(options) }),
-        });
-        return {
-            command_id: execution.command_id,
-            disposition: execution.disposition,
-            ...(execution.result === undefined ? {} : { result: execution.result }),
-            invalidates,
-        };
-    });
-    app.post(`${HOST_PROJECT_API_BASE_PATH}/artifacts/preview/stop`, {
-        schema: {
-            body: StopArtifactPreviewBodySchema,
-            response: {
-                200: StopArtifactPreviewResponseSchema,
-            },
-        },
-    }, (request) => {
-        requireHostProjectSession(request, options);
-        const store = requireProjectStore(options);
-        const invalidates = artifactInvalidates();
-        const execution = executeIdempotentCommand({
-            db: store.db,
-            command_id: request.body.command_id,
-            command_name: "artifacts.preview.stop",
-            target_ref: "artifacts:active",
-            payload: request.body.payload,
-            ...(options.now === undefined ? {} : { now: options.now }),
-            execute: () => artifactPreviewManager.stop({ workspaceRoot: requireWorkspaceRoot(options) }),
-        });
-        return {
-            command_id: execution.command_id,
-            disposition: execution.disposition,
-            ...(execution.result === undefined ? {} : { result: execution.result }),
-            invalidates,
-        };
-    });
 }
 //# sourceMappingURL=artifacts-routes.js.map

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

@@ -11,41 +11,38 @@ export declare const HOST_PROJECT_ARTIFACTS_OPENAPI_ROUTES: ({
                     status: import("@sinclair/typebox").TLiteral<"not_declared">;
                 }>, import("@sinclair/typebox").TObject<{
                     status: import("@sinclair/typebox").TLiteral<"invalid">;
-                    manifest_path: import("@sinclair/typebox").TLiteral<"tutti.artifact.json">;
                     error: import("@sinclair/typebox").TObject<{
                         code: import("@sinclair/typebox").TString;
                         message: import("@sinclair/typebox").TString;
                     }>;
                 }>, import("@sinclair/typebox").TObject<{
                     status: import("@sinclair/typebox").TLiteral<"declared">;
-                    manifest_path: import("@sinclair/typebox").TLiteral<"tutti.artifact.json">;
-                    manifest_blob_oid: import("@sinclair/typebox").TString;
+                    preview_generation: import("@sinclair/typebox").TString;
                     artifact: import("@sinclair/typebox").TObject<{
                         title: import("@sinclair/typebox").TString;
                         kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"static">, import("@sinclair/typebox").TLiteral<"server">]>;
                         network: import("@sinclair/typebox").TBoolean;
                     }>;
                     preview: import("@sinclair/typebox").TObject<{
-                        status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"ready">, import("@sinclair/typebox").TLiteral<"starting">, import("@sinclair/typebox").TLiteral<"stopped">, import("@sinclair/typebox").TLiteral<"failed">]>;
+                        status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"ready">, import("@sinclair/typebox").TLiteral<"starting">, import("@sinclair/typebox").TLiteral<"idle">, import("@sinclair/typebox").TLiteral<"failed">]>;
                         url: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                         error_message: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                     }>;
                 }>]>;
             }>;
         };
+        204?: never;
     };
-    requestBody?: never;
 } | {
     method: "post";
     path: string;
     summary: string;
     tags: string[];
-    requestBody: import("@sinclair/typebox").TSchema;
     responses: {
-        200: {
+        204: {
             description: string;
-            schema: import("@sinclair/typebox").TSchema;
         };
+        200?: never;
     };
 })[];
 //# sourceMappingURL=openapi-artifacts-routes.d.ts.map

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

@@ -1,4 +1,4 @@
-import { GetArtifactsResponseSchema, HeartbeatArtifactPreviewBodySchema, HeartbeatArtifactPreviewResponseSchema, StartArtifactPreviewBodySchema, StartArtifactPreviewResponseSchema, StopArtifactPreviewBodySchema, StopArtifactPreviewResponseSchema, } from "@tutti/shared/schemas/api";
+import { GetArtifactsResponseSchema, } from "@tutti/shared/schemas/api";
 import { HOST_PROJECT_API_BASE_PATH } from "./constants.js";
 export const HOST_PROJECT_ARTIFACTS_OPENAPI_ROUTES = [
     {
@@ -15,40 +15,12 @@ export const HOST_PROJECT_ARTIFACTS_OPENAPI_ROUTES = [
     },
     {
         method: "post",
-        path: `${HOST_PROJECT_API_BASE_PATH}/artifacts/preview/start`,
-        summary: "Start or reuse the current server artifact preview.",
+        path: `${HOST_PROJECT_API_BASE_PATH}/artifacts/preview/lease`,
+        summary: "Acquire or renew the current viewer's Artifact preview lease.",
         tags: ["artifacts"],
-        requestBody: StartArtifactPreviewBodySchema,
         responses: {
-            200: {
-                description: "Artifact preview start disposition.",
-                schema: StartArtifactPreviewResponseSchema,
-            },
-        },
-    },
-    {
-        method: "post",
-        path: `${HOST_PROJECT_API_BASE_PATH}/artifacts/preview/heartbeat`,
-        summary: "Record a viewer lease heartbeat for the current artifact preview.",
-        tags: ["artifacts"],
-        requestBody: HeartbeatArtifactPreviewBodySchema,
-        responses: {
-            200: {
-                description: "Artifact preview heartbeat disposition.",
-                schema: HeartbeatArtifactPreviewResponseSchema,
-            },
-        },
-    },
-    {
-        method: "post",
-        path: `${HOST_PROJECT_API_BASE_PATH}/artifacts/preview/stop`,
-        summary: "Stop the current server artifact preview.",
-        tags: ["artifacts"],
-        requestBody: StopArtifactPreviewBodySchema,
-        responses: {
-            200: {
-                description: "Artifact preview stop disposition.",
-                schema: StopArtifactPreviewResponseSchema,
+            204: {
+                description: "Artifact preview lease renewed.",
             },
         },
     },

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

@@ -124,41 +124,38 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
                     status: import("@sinclair/typebox").TLiteral<"not_declared">;
                 }>, import("@sinclair/typebox").TObject<{
                     status: import("@sinclair/typebox").TLiteral<"invalid">;
-                    manifest_path: import("@sinclair/typebox").TLiteral<"tutti.artifact.json">;
                     error: import("@sinclair/typebox").TObject<{
                         code: import("@sinclair/typebox").TString;
                         message: import("@sinclair/typebox").TString;
                     }>;
                 }>, import("@sinclair/typebox").TObject<{
                     status: import("@sinclair/typebox").TLiteral<"declared">;
-                    manifest_path: import("@sinclair/typebox").TLiteral<"tutti.artifact.json">;
-                    manifest_blob_oid: import("@sinclair/typebox").TString;
+                    preview_generation: import("@sinclair/typebox").TString;
                     artifact: import("@sinclair/typebox").TObject<{
                         title: import("@sinclair/typebox").TString;
                         kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"static">, import("@sinclair/typebox").TLiteral<"server">]>;
                         network: import("@sinclair/typebox").TBoolean;
                     }>;
                     preview: import("@sinclair/typebox").TObject<{
-                        status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"ready">, import("@sinclair/typebox").TLiteral<"starting">, import("@sinclair/typebox").TLiteral<"stopped">, import("@sinclair/typebox").TLiteral<"failed">]>;
+                        status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"ready">, import("@sinclair/typebox").TLiteral<"starting">, import("@sinclair/typebox").TLiteral<"idle">, import("@sinclair/typebox").TLiteral<"failed">]>;
                         url: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                         error_message: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                     }>;
                 }>]>;
             }>;
         };
+        204?: never;
     };
-    requestBody?: never;
 } | {
     method: "post";
     path: string;
     summary: string;
     tags: string[];
-    requestBody: import("@sinclair/typebox").TSchema;
     responses: {
-        200: {
+        204: {
             description: string;
-            schema: import("@sinclair/typebox").TSchema;
         };
+        200?: never;
     };
 } | {
     method: "get";
@@ -1867,6 +1864,18 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
         };
     };
     requestBody?: never;
+} | {
+    method: "post";
+    path: string;
+    summary: string;
+    tags: string[];
+    requestBody: import("@sinclair/typebox").TSchema;
+    responses: {
+        200: {
+            description: string;
+            schema: import("@sinclair/typebox").TSchema;
+        };
+    };
 } | {
     method: "get";
     path: string;

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

@@ -1,7 +1,7 @@
 import type { ReadOnlyChatAssistantHandle } from "../../../../chat-assistant/index.js";
 import type { Phase5ControlPlane } from "../../../../control-plane/index.js";
 import type { ApprovalRequestManager } from "../../../../approvals/index.js";
-import type { ArtifactPreviewManagerOptions } from "../../../../artifacts/index.js";
+import type { ArtifactPreviewManager, ArtifactPreviewManagerOptions } from "../../../../artifacts/index.js";
 import type { HostProjectStore } from "../../../../store/index.js";
 import type { ProjectId, RelayProjectRef } from "@tutti/shared/ids";
 import type { AccountAvatarProjection } from "@tutti/shared/domain";
@@ -73,7 +73,8 @@ export type HostProjectApiCapabilities = {
     clarification: boolean;
 };
 export type HostProjectApiRouteOptions = {
-    artifactPreview?: Omit<ArtifactPreviewManagerOptions, "now" | "onStatusChange">;
+    artifactPreview?: Omit<ArtifactPreviewManagerOptions, "onStatusChange">;
+    artifactPreviewManager?: ArtifactPreviewManager;
     project: {
         project_id: ProjectId;
         display_name: string;

package/dist/workspace-ops/index.d.ts

@@ -1,7 +1,7 @@
 export { DEFAULT_VIEWER_MAX_BYTES, MAX_REFERENCE_UPLOAD_BYTES, MAX_VIEWER_MAX_BYTES, PROJECT_DOC_PATHS, REFERENCE_IMAGE_ASSET_CACHE_VERSION, REFERENCE_IMAGE_PREVIEW_MAX_EDGE_PX, REFERENCE_IMAGE_THUMBNAIL_MAX_EDGE_PX, REFERENCE_DIRECTORY_PATH, REFERENCE_FILES_DIRECTORY_PATH, REFERENCE_IMAGES_DIRECTORY_PATH, REFERENCE_INDEX_PATH, REFERENCE_TUTTI_DIRECTORY_PATH, VIEWER_ASSET_READ_LIMIT_BYTES, VIEWER_HARD_READ_LIMIT_BYTES, WORKSPACE_OPS_MAINLINE_BRANCH, } from "./constants.js";
 export { WorkspaceOpsError } from "./errors.js";
 export { commitOwnedPaths, requireOwnedPathsWriteReady } from "./system-commits.js";
-export { collectProjectSourceDiff, createAcceptedCheckpoint, fingerprintProjectSourceState, inspectProjectWorkspace, recoverAcceptedCheckpoint, } from "./project-workspace.js";
+export { collectProjectSourceDiff, createAcceptedCheckpoint, inspectProjectWorkspace, recoverAcceptedCheckpoint, } from "./project-workspace.js";
 export { initializeProjectDocs, readProjectDocsInitializationStatus, syncProjectDocs, } from "./project-docs.js";
 export { uploadReferenceFile } from "./reference-files.js";
 export { referenceFileCategoryForPath, referenceFileSourceForPath, referenceMediaTypeForPath, referenceTuttiGroupForPath, } from "./reference-metadata.js";

package/dist/workspace-ops/index.js

@@ -1,7 +1,7 @@
 export { DEFAULT_VIEWER_MAX_BYTES, MAX_REFERENCE_UPLOAD_BYTES, MAX_VIEWER_MAX_BYTES, PROJECT_DOC_PATHS, REFERENCE_IMAGE_ASSET_CACHE_VERSION, REFERENCE_IMAGE_PREVIEW_MAX_EDGE_PX, REFERENCE_IMAGE_THUMBNAIL_MAX_EDGE_PX, REFERENCE_DIRECTORY_PATH, REFERENCE_FILES_DIRECTORY_PATH, REFERENCE_IMAGES_DIRECTORY_PATH, REFERENCE_INDEX_PATH, REFERENCE_TUTTI_DIRECTORY_PATH, VIEWER_ASSET_READ_LIMIT_BYTES, VIEWER_HARD_READ_LIMIT_BYTES, WORKSPACE_OPS_MAINLINE_BRANCH, } from "./constants.js";
 export { WorkspaceOpsError } from "./errors.js";
 export { commitOwnedPaths, requireOwnedPathsWriteReady } from "./system-commits.js";
-export { collectProjectSourceDiff, createAcceptedCheckpoint, fingerprintProjectSourceState, inspectProjectWorkspace, recoverAcceptedCheckpoint, } from "./project-workspace.js";
+export { collectProjectSourceDiff, createAcceptedCheckpoint, inspectProjectWorkspace, recoverAcceptedCheckpoint, } from "./project-workspace.js";
 export { initializeProjectDocs, readProjectDocsInitializationStatus, syncProjectDocs, } from "./project-docs.js";
 export { uploadReferenceFile } from "./reference-files.js";
 export { referenceFileCategoryForPath, referenceFileSourceForPath, referenceMediaTypeForPath, referenceTuttiGroupForPath, } from "./reference-metadata.js";