@xfey/tutti 0.1.41 → 0.1.43

package/dist/run-pipeline/promotion-reconcile.d.ts

@@ -1,7 +1,15 @@
+import type { CandidateArtifactValidationFailure } from "../artifacts/index.js";
 import type { RunPipelineInput, RunPipelineResult } from "../control-plane/index.js";
 import { type ResultCommit, type RunWorkspaceHandle } from "../workspace-ops/index.js";
 import type { OpenAiRunPipelineRunnerOptions } from "./openai.js";
 import type { CompletedNoRepoChangesTaskRunOutput, CompletedTaskRunOutput } from "./task-run-output.js";
+export type PromotionReconcileOutcome = {
+    result: RunPipelineResult;
+    artifact_gate_failure?: {
+        correctable: boolean;
+        failure: CandidateArtifactValidationFailure;
+    };
+};
 export declare function runPromotionReconcile(input: {
     options: OpenAiRunPipelineRunnerOptions;
     pipelineInput: RunPipelineInput;
@@ -9,5 +17,5 @@ export declare function runPromotionReconcile(input: {
     taskOutput: CompletedTaskRunOutput | CompletedNoRepoChangesTaskRunOutput;
     sourceCommit: ResultCommit;
     changedPaths: string[];
-}): Promise<RunPipelineResult>;
+}): Promise<PromotionReconcileOutcome>;
 //# sourceMappingURL=promotion-reconcile.d.ts.map

package/dist/run-pipeline/promotion-reconcile.js

@@ -2,7 +2,14 @@ import { dirname, join } from "node:path";
 import { createNodeNpmCheckPlan, executeCheckPlan } from "../checks/index.js";
 import { applyRunResultToMergeWorkspace, cleanupMergeWorkspace, collectMergeDiff, createMergeCandidateCommit, prepareMergeWorkspace, promoteMergeCandidate, WorkspaceOpsError, } from "../workspace-ops/index.js";
 import { candidateChangedAfterChecks } from "./candidate-diff.js";
+import { runArtifactCandidateGate } from "./artifact-applicability.js";
 import { checkSkipFields, checkStatus, checksSummary, docsStatusForChangedPaths, failedBeforeChecks, failedFinishedResult, promotionNotPromoted, successfulRunSummary, } from "./result-projections.js";
+function reconcileOutcome(result, artifactGateFailure) {
+    return {
+        result,
+        ...(artifactGateFailure === undefined ? {} : { artifact_gate_failure: artifactGateFailure }),
+    };
+}
 function withPromotionReconcileEvent(result, event) {
     return {
         ...result,
@@ -40,13 +47,60 @@ export async function runPromotionReconcile(input) {
         changedPaths = diff.changed_paths;
         if (changedPaths.length === 0) {
             const summary = "Promotion reconcile produced no candidate changes.";
-            return withPromotionReconcileEvent(failedBeforeChecks({
+            return reconcileOutcome(withPromotionReconcileEvent(failedBeforeChecks({
                 summary,
                 errorCode: "promotion_reconcile_no_candidate_changes",
                 retryable: false,
                 changedPaths,
                 promotion: promotionNotPromoted("promotion_reconcile_no_candidate_changes", "No reconciled candidate changes were available for promotion."),
+            }), failedPromotionReconcileEvent({ summary, changedPaths })));
+        }
+        input.pipelineInput.on_stage?.({
+            stage: "artifact_candidate_validate",
+            summary: "validating the reconciled candidate Artifact preview.",
+        });
+        const artifactGate = await runArtifactCandidateGate({
+            repoRoot: handle.repo_root,
+            task: {
+                title: input.pipelineInput.task.title,
+                goal: input.pipelineInput.task_detail.detail.contract.goal,
+                scope: input.pipelineInput.task_detail.detail.contract.scope,
+            },
+            diff,
+            config: input.options.config,
+            apiKey: input.options.apiKey,
+            ...(input.options.promptsRoot === undefined
+                ? {}
+                : { promptsRoot: input.options.promptsRoot }),
+            ...(input.options.baseEnv === undefined ? {} : { baseEnv: input.options.baseEnv }),
+            ...(input.options.artifactApplicabilityClient === undefined
+                ? {}
+                : { client: input.options.artifactApplicabilityClient }),
+            ...(input.options.artifactApplicabilityJudge === undefined
+                ? {}
+                : { judge: input.options.artifactApplicabilityJudge }),
+            ...(input.options.validateArtifactCandidate === undefined
+                ? {}
+                : { validateCandidate: input.options.validateArtifactCandidate }),
+            ...(input.options.recordUsage === undefined
+                ? {}
+                : { recordUsage: input.options.recordUsage }),
+            activityRef: input.pipelineInput.activity_ref,
+            taskId: input.pipelineInput.task.id,
+        });
+        if (artifactGate.status === "failed") {
+            const summary = artifactGate.failure.summary;
+            const result = withPromotionReconcileEvent(failedBeforeChecks({
+                summary,
+                errorCode: artifactGate.failure.reason_code,
+                retryable: false,
+                changedPaths,
+                promotion: promotionNotPromoted(artifactGate.failure.reason_code, "Reconciled Artifact candidate validation failed, so promotion failed."),
             }), failedPromotionReconcileEvent({ summary, changedPaths }));
+            return reconcileOutcome(result, {
+                correctable: artifactGate.correctable,
+                failure: artifactGate.failure,
+            });
         }
         let docs = docsStatusForChangedPaths(changedPaths);
         const checkPlan = createNodeNpmCheckPlan({ workspaceRoot: handle.repo_root });
@@ -59,20 +113,20 @@ export async function runPromotionReconcile(input) {
         });
         if (checks.status === "failed") {
             const summary = checksSummary(checks);
-            return withPromotionReconcileEvent(failedFinishedResult({
+            return reconcileOutcome(withPromotionReconcileEvent(failedFinishedResult({
                 summary,
                 checks,
                 docs,
                 changedPaths,
                 promotion: promotionNotPromoted("promotion_reconcile_checks_failed", "Reconciled candidate checks failed, so promotion failed."),
-            }), failedPromotionReconcileEvent({ summary, changedPaths }));
+            }), failedPromotionReconcileEvent({ summary, changedPaths })));
         }
         const postChecksDiff = collectMergeDiff(handle);
         changedPaths = postChecksDiff.changed_paths;
         docs = docsStatusForChangedPaths(changedPaths);
         if (candidateChangedAfterChecks(diff, postChecksDiff)) {
             const summary = "Checks modified the reconciled candidate workspace; promotion failed.";
-            return withPromotionReconcileEvent(failedFinishedResult({
+            return reconcileOutcome(withPromotionReconcileEvent(failedFinishedResult({
                 summary,
                 checks: {
                     status: "failed",
@@ -81,11 +135,11 @@ export async function runPromotionReconcile(input) {
                 docs,
                 changedPaths,
                 promotion: promotionNotPromoted("promotion_reconcile_checks_modified_candidate", "Checks changed tracked reconciled candidate files, so promotion failed."),
-            }), failedPromotionReconcileEvent({ summary, changedPaths }));
+            }), failedPromotionReconcileEvent({ summary, changedPaths })));
         }
         const commit = createMergeCandidateCommit(handle, `Reconcile Tutti task: ${input.pipelineInput.task.title}`);
         const promotion = promoteMergeCandidate(handle, commit);
-        return withPromotionReconcileEvent({
+        return reconcileOutcome(withPromotionReconcileEvent({
             result_kind: "finished",
             outcome: "completed",
             summary: successfulRunSummary({
@@ -111,26 +165,26 @@ export async function runPromotionReconcile(input) {
             summary: "Promotion reconciled and promoted.",
             commit_oid: promotion.promoted_commit_oid,
             meta: promotionReconcileMeta(changedPaths),
-        });
+        }));
     }
     catch (error) {
         if (error instanceof WorkspaceOpsError) {
-            return withPromotionReconcileEvent(failedBeforeChecks({
+            return reconcileOutcome(withPromotionReconcileEvent(failedBeforeChecks({
                 summary: error.message,
                 errorCode: `workspace_ops_${error.code}`,
                 retryable: error.code === "conflict",
                 changedPaths,
                 promotion: promotionNotPromoted("promotion_reconcile_failed", error.message),
-            }), failedPromotionReconcileEvent({ summary: error.message, changedPaths }));
+            }), failedPromotionReconcileEvent({ summary: error.message, changedPaths })));
         }
         const summary = error instanceof Error ? error.message : "Promotion reconcile failed";
-        return withPromotionReconcileEvent(failedBeforeChecks({
+        return reconcileOutcome(withPromotionReconcileEvent(failedBeforeChecks({
             summary,
             errorCode: "promotion_reconcile_failed",
             retryable: false,
             changedPaths,
             promotion: promotionNotPromoted("promotion_reconcile_failed", summary),
-        }), failedPromotionReconcileEvent({ summary, changedPaths }));
+        }), failedPromotionReconcileEvent({ summary, changedPaths })));
     }
     finally {
         if (handle !== undefined) {

package/dist/server-shell/http/host-tunnel.js

@@ -64,7 +64,7 @@ function toInjectMethod(method) {
         case "OPTIONS":
             return normalized;
         default:
-            return "GET";
+            return "TRACE";
     }
 }
 export function createHostProjectApiTunnelRequestHandler(options) {

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

@@ -1,13 +1,46 @@
 import { HeartbeatArtifactPreviewBodySchema, HeartbeatArtifactPreviewResponseSchema, GetArtifactsResponseSchema, StartArtifactPreviewBodySchema, StartArtifactPreviewResponseSchema, StopArtifactPreviewBodySchema, StopArtifactPreviewResponseSchema, } from "@tutti/shared/schemas/api";
-import { ARTIFACT_PREVIEW_CSP, ArtifactPreviewManager, readArtifactProjection, readArtifactStaticPreview, } from "../../../../artifacts/index.js";
+import { ARTIFACT_PREVIEW_REQUEST_BODY_LIMIT_BYTES, ARTIFACT_PREVIEW_CSP, ArtifactPreviewManager, isArtifactPreviewHttpMethod, readArtifactProjection, readArtifactStaticPreview, } 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";
 function artifactInvalidates() {
     return [{ kind: "artifacts" }];
 }
+const ARTIFACT_PREVIEW_ALLOWED_METHODS = "GET, HEAD, POST, PUT, PATCH, DELETE, OPTIONS";
+function previewRequestHeaders(request) {
+    const headers = {};
+    for (const [name, value] of Object.entries(request.headers)) {
+        if (typeof value === "string") {
+            headers[name] = value;
+        }
+    }
+    return headers;
+}
+function previewRequestBody(body) {
+    if (body === undefined || body === null) {
+        return undefined;
+    }
+    if (Buffer.isBuffer(body)) {
+        return body;
+    }
+    if (body instanceof Uint8Array) {
+        return Buffer.from(body);
+    }
+    if (typeof body === "string") {
+        return Buffer.from(body, "utf8");
+    }
+    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");
+    }
+}
 export function registerArtifactsRoutes(app, { options, workspaceEvents, }) {
     const artifactPreviewManager = new ArtifactPreviewManager({
+        ...options.artifactPreview,
         ...(options.now === undefined ? {} : { now: options.now }),
         onStatusChange: () => {
             workspaceEvents.publish({
@@ -20,9 +53,8 @@ export function registerArtifactsRoutes(app, { options, workspaceEvents, }) {
             });
         },
     });
-    app.addHook("onClose", (_instance, done) => {
-        artifactPreviewManager.stopAll();
-        done();
+    app.addHook("onClose", async () => {
+        await artifactPreviewManager.stopAll();
     });
     app.get(`${HOST_PROJECT_API_BASE_PATH}/artifacts`, {
         schema: {
@@ -36,27 +68,37 @@ export function registerArtifactsRoutes(app, { options, workspaceEvents, }) {
             workspaceRoot: requireWorkspaceRoot(options),
         });
     });
-    app.get("/artifacts/preview/*", async (request, reply) => {
+    app.all("/artifacts/preview/*", {
+        bodyLimit: ARTIFACT_PREVIEW_REQUEST_BODY_LIMIT_BYTES,
+    }, async (request, reply) => {
         requireHostProjectSession(request, options);
+        const method = request.method.toUpperCase();
+        if (!isArtifactPreviewHttpMethod(method)) {
+            void reply
+                .code(405)
+                .header("allow", ARTIFACT_PREVIEW_ALLOWED_METHODS)
+                .send("Artifact preview method is not allowed");
+            return;
+        }
         const workspaceRoot = requireWorkspaceRoot(options);
         const projection = readArtifactProjection({
             workspaceRoot,
             ...(options.now === undefined ? {} : { now: options.now }),
         });
-        if (projection.artifact.status === "declared" && projection.artifact.artifact.kind === "server") {
+        if (projection.artifact.status === "declared") {
+            requireCurrentArtifactManifestMarker(request, projection.artifact.manifest_blob_oid);
+        }
+        if (projection.artifact.status === "declared" &&
+            projection.artifact.artifact.kind === "server") {
             const queryIndex = request.url.indexOf("?");
+            const body = previewRequestBody(request.body);
             const preview = await artifactPreviewManager.fetchServerPreview({
                 workspaceRoot,
                 path: request.params["*"],
+                method,
                 ...(queryIndex < 0 ? {} : { query: request.url.slice(queryIndex + 1) }),
-                headers: {
-                    ...(typeof request.headers.accept === "string"
-                        ? { accept: request.headers.accept }
-                        : {}),
-                    ...(typeof request.headers["accept-language"] === "string"
-                        ? { "accept-language": request.headers["accept-language"] }
-                        : {}),
-                },
+                headers: previewRequestHeaders(request),
+                ...(body === undefined ? {} : { body }),
             });
             for (const [key, value] of Object.entries(preview.headers)) {
                 void reply.header(key, value);
@@ -69,6 +111,13 @@ export function registerArtifactsRoutes(app, { options, workspaceEvents, }) {
                 .send(preview.content);
             return;
         }
+        if (method !== "GET" && method !== "HEAD") {
+            void reply
+                .code(405)
+                .header("allow", "GET, HEAD")
+                .send("Static Artifact previews only support GET and HEAD");
+            return;
+        }
         const preview = readArtifactStaticPreview({
             workspaceRoot,
             path: request.params["*"],

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

@@ -1,6 +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 { HostProjectStore } from "../../../../store/index.js";
 import type { ProjectId, RelayProjectRef } from "@tutti/shared/ids";
 import type { AccountAvatarProjection } from "@tutti/shared/domain";
@@ -72,6 +73,7 @@ export type HostProjectApiCapabilities = {
     clarification: boolean;
 };
 export type HostProjectApiRouteOptions = {
+    artifactPreview?: Omit<ArtifactPreviewManagerOptions, "now" | "onStatusChange">;
     project: {
         project_id: ProjectId;
         display_name: string;

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

@@ -4,7 +4,7 @@ export { initializeProjectDocs, readProjectDocsInitializationStatus, syncProject
 export { uploadReferenceFile } from "./reference-files.js";
 export { referenceFileCategoryForPath, referenceFileSourceForPath, referenceMediaTypeForPath, referenceTuttiGroupForPath, } from "./reference-metadata.js";
 export { readReferenceSummaryIndex, readReferenceSummaryTargets, referenceSummaryProjectionForEntry, updateReferenceSummaries, } from "./reference-summaries.js";
-export { applyRunResultToMergeWorkspace, cleanupMergeWorkspace, cleanupRunWorkspace, cleanupStaleRunWorkspaces, collectMergeDiff, collectRunDiff, createMergeCandidateCommit, createResultCommit, prepareMergeWorkspace, prepareRunWorkspace, promoteMergeCandidate, promoteRunResult, } from "./run-workspaces.js";
+export { applyRunResultToMergeWorkspace, cleanupMergeWorkspace, cleanupRunWorkspace, cleanupStaleRunWorkspaces, collectMergeDiff, collectRunDiff, createMergeCandidateCommit, createResultCommit, fingerprintWorkspaceCandidate, prepareMergeWorkspace, prepareRunWorkspace, promoteMergeCandidate, promoteRunResult, } from "./run-workspaces.js";
 export { readViewerAsset, readViewerFile, readViewerSnapshot, readViewerTree } from "./viewer.js";
 export type { WorkspaceOpsErrorCode } from "./errors.js";
 export type { CleanupRunWorkspaceResult, CleanupStaleRunWorkspacesResult, InitializeProjectDocsOptions, InitializeProjectDocsResult, MergeWorkspaceHandle, PrepareMergeWorkspaceOptions, PrepareRunWorkspaceOptions, ProjectDocsInitializationContext, ProjectDocsInitializationDocument, ProjectDocsInitializationStatus, PromotionResult, ReadViewerAssetOptions, ReadViewerFileOptions, ReadViewerTreeOptions, ReferenceFileCategory, ReferenceSummaryProjection, ReferenceSummaryRecord, ReferenceSummaryStatus, ReferenceSummaryTarget, ResultCommit, RunDiffSummary, RunWorkspaceHandle, SyncProjectDocsResult, SyncProjectDocsUpdate, UpdateReferenceSummariesOptions, UpdateReferenceSummariesResult, UploadReferenceFileOptions, UploadReferenceFileResult, ViewerAssetResult, ViewerAssetVariant, ViewerEntryKind, ViewerFileContent, ViewerFileResult, ViewerRepoSnapshot, ViewerTreeEntry, ViewerTreeResult, WorkspaceViewerOptions, } from "./types.js";

package/dist/workspace-ops/index.js

@@ -4,6 +4,6 @@ export { initializeProjectDocs, readProjectDocsInitializationStatus, syncProject
 export { uploadReferenceFile } from "./reference-files.js";
 export { referenceFileCategoryForPath, referenceFileSourceForPath, referenceMediaTypeForPath, referenceTuttiGroupForPath, } from "./reference-metadata.js";
 export { readReferenceSummaryIndex, readReferenceSummaryTargets, referenceSummaryProjectionForEntry, updateReferenceSummaries, } from "./reference-summaries.js";
-export { applyRunResultToMergeWorkspace, cleanupMergeWorkspace, cleanupRunWorkspace, cleanupStaleRunWorkspaces, collectMergeDiff, collectRunDiff, createMergeCandidateCommit, createResultCommit, prepareMergeWorkspace, prepareRunWorkspace, promoteMergeCandidate, promoteRunResult, } from "./run-workspaces.js";
+export { applyRunResultToMergeWorkspace, cleanupMergeWorkspace, cleanupRunWorkspace, cleanupStaleRunWorkspaces, collectMergeDiff, collectRunDiff, createMergeCandidateCommit, createResultCommit, fingerprintWorkspaceCandidate, prepareMergeWorkspace, prepareRunWorkspace, promoteMergeCandidate, promoteRunResult, } from "./run-workspaces.js";
 export { readViewerAsset, readViewerFile, readViewerSnapshot, readViewerTree } from "./viewer.js";
 //# sourceMappingURL=index.js.map

package/dist/workspace-ops/run-workspaces.d.ts

@@ -1,4 +1,5 @@
 import type { CleanupRunWorkspaceResult, CleanupStaleRunWorkspacesResult, MergeWorkspaceHandle, PrepareMergeWorkspaceOptions, PrepareRunWorkspaceOptions, PromotionResult, ResultCommit, RunDiffSummary, RunWorkspaceHandle } from "./types.js";
+export declare function fingerprintWorkspaceCandidate(repoRoot: string): string;
 export declare function prepareRunWorkspace(options: PrepareRunWorkspaceOptions): RunWorkspaceHandle;
 export declare function collectRunDiff(handle: RunWorkspaceHandle): RunDiffSummary;
 export declare function createResultCommit(handle: RunWorkspaceHandle, summary: string): ResultCommit;

package/dist/workspace-ops/run-workspaces.js

@@ -1,10 +1,37 @@
 import { existsSync, mkdirSync, readdirSync, rmSync } from "node:fs";
+import { createHash } from "node:crypto";
 import { join } from "node:path";
 import { classifyViewerPath } from "@tutti/shared/utils";
 import { WorkspaceOpsError } from "./errors.js";
 import { runGit, runGitRaw, runGitText, stagedChangesExist, summarizeGitFailure, tryGitText, } from "./git.js";
 import { requireMainlineWriteReady } from "./mainline.js";
 const MAX_RUN_DIFF_SUMMARY_BYTES = 32 * 1024;
+export function fingerprintWorkspaceCandidate(repoRoot) {
+    const status = runGitRaw(["status", "--porcelain=v1", "-z"], repoRoot);
+    if (status.status !== 0) {
+        throw new WorkspaceOpsError("git_failed", summarizeGitFailure(["status"], status));
+    }
+    const diff = runGitRaw(["diff", "--binary", "HEAD", "--"], repoRoot);
+    if (diff.status !== 0) {
+        throw new WorkspaceOpsError("git_failed", summarizeGitFailure(["diff", "HEAD"], diff));
+    }
+    const untracked = runGitRaw(["ls-files", "--others", "--exclude-standard", "-z"], repoRoot);
+    if (untracked.status !== 0) {
+        throw new WorkspaceOpsError("git_failed", summarizeGitFailure(["ls-files", "--others"], untracked));
+    }
+    const hash = createHash("sha256").update(status.stdout).update(diff.stdout);
+    for (const path of untracked.stdout.toString("utf8").split("\0")) {
+        if (path.length === 0) {
+            continue;
+        }
+        const object = runGitRaw(["hash-object", "--no-filters", "--", path], repoRoot);
+        if (object.status !== 0) {
+            throw new WorkspaceOpsError("git_failed", summarizeGitFailure(["hash-object"], object));
+        }
+        hash.update(path).update("\0").update(object.stdout);
+    }
+    return hash.digest("hex");
+}
 function runWorkspaceTempBranch(taskId, activityRef) {
     return `tutti/run/${taskId}/${activityRef}`;
 }

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

@@ -6,15 +6,14 @@ export declare const ArtifactStaticManifestSchema: import("@sinclair/typebox").T
     kind: import("@sinclair/typebox").TLiteral<"static">;
     root: import("@sinclair/typebox").TString;
     entry: import("@sinclair/typebox").TString;
-    network: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    network: import("@sinclair/typebox").TBoolean;
 }>;
 export declare const ArtifactServerManifestSchema: import("@sinclair/typebox").TObject<{
     title: import("@sinclair/typebox").TString;
     kind: import("@sinclair/typebox").TLiteral<"server">;
     cwd: import("@sinclair/typebox").TString;
-    script: import("@sinclair/typebox").TLiteral<"artifact:preview">;
-    ready_path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    network: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    entry: import("@sinclair/typebox").TString;
+    network: import("@sinclair/typebox").TBoolean;
 }>;
 export declare const ArtifactManifestSchema: import("@sinclair/typebox").TObject<{
     version: import("@sinclair/typebox").TLiteral<1>;
@@ -23,14 +22,13 @@ export declare const ArtifactManifestSchema: import("@sinclair/typebox").TObject
         kind: import("@sinclair/typebox").TLiteral<"static">;
         root: import("@sinclair/typebox").TString;
         entry: import("@sinclair/typebox").TString;
-        network: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+        network: import("@sinclair/typebox").TBoolean;
     }>, import("@sinclair/typebox").TObject<{
         title: import("@sinclair/typebox").TString;
         kind: import("@sinclair/typebox").TLiteral<"server">;
         cwd: import("@sinclair/typebox").TString;
-        script: import("@sinclair/typebox").TLiteral<"artifact:preview">;
-        ready_path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-        network: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+        entry: import("@sinclair/typebox").TString;
+        network: import("@sinclair/typebox").TBoolean;
     }>]>;
 }>;
 export declare const ArtifactPreviewStatusSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"ready">, import("@sinclair/typebox").TLiteral<"starting">, import("@sinclair/typebox").TLiteral<"stopped">, import("@sinclair/typebox").TLiteral<"failed">]>;
@@ -94,6 +92,28 @@ export declare const GetArtifactsResponseSchema: import("@sinclair/typebox").TOb
         }>;
     }>]>;
 }>;
+export declare const IssueArtifactPreviewSessionPayloadSchema: import("@sinclair/typebox").TObject<{}>;
+export declare const IssueArtifactPreviewSessionDispositionSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+    kind: import("@sinclair/typebox").TLiteral<"issued">;
+}>, import("@sinclair/typebox").TObject<{
+    kind: import("@sinclair/typebox").TLiteral<"not_declared">;
+}>, import("@sinclair/typebox").TObject<{
+    kind: import("@sinclair/typebox").TLiteral<"invalid_manifest">;
+    message: import("@sinclair/typebox").TString;
+}>, import("@sinclair/typebox").TObject<{
+    kind: import("@sinclair/typebox").TLiteral<"preview_not_ready">;
+    status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"starting">, import("@sinclair/typebox").TLiteral<"stopped">, import("@sinclair/typebox").TLiteral<"failed">]>;
+    message: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>, import("@sinclair/typebox").TObject<{
+    kind: import("@sinclair/typebox").TLiteral<"interrupted">;
+    retry_with_new_command_id: import("@sinclair/typebox").TLiteral<true>;
+}>]>;
+export declare const IssueArtifactPreviewSessionResultSchema: import("@sinclair/typebox").TObject<{
+    bootstrap_url: import("@sinclair/typebox").TString;
+    expires_at: import("@sinclair/typebox").TString;
+}>;
+export declare const IssueArtifactPreviewSessionBodySchema: import("@sinclair/typebox").TSchema;
+export declare const IssueArtifactPreviewSessionResponseSchema: import("@sinclair/typebox").TSchema;
 export declare const ArtifactPreviewCommandPayloadSchema: import("@sinclair/typebox").TObject<{}>;
 export declare const StartArtifactPreviewDispositionSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
     kind: import("@sinclair/typebox").TLiteral<"started">;

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

@@ -1,23 +1,23 @@
 import { Type } from "@sinclair/typebox";
+import { IsoDateTimeStringSchema } from "../domain/index.js";
 import { InterruptedCommandDispositionSchema, NonEmptyStringSchema, commandEnvelopeSchema, commandResponseWithResultSchema, } from "./primitives.js";
-import { ViewerPathSchema } from "./viewer-reference.js";
 export const ArtifactManifestPathSchema = Type.Literal("tutti.artifact.json");
 export const ArtifactKindSchema = Type.Union([Type.Literal("static"), Type.Literal("server")]);
-export const ArtifactTitleSchema = Type.String({ minLength: 1, maxLength: 120 });
+export const ArtifactTitleSchema = Type.String({ minLength: 1, maxLength: 120, pattern: "\\S" });
+const ArtifactRepoPathSchema = Type.String({ minLength: 1 });
 export const ArtifactStaticManifestSchema = Type.Object({
     title: ArtifactTitleSchema,
     kind: Type.Literal("static"),
-    root: ViewerPathSchema,
-    entry: ViewerPathSchema,
-    network: Type.Optional(Type.Boolean()),
+    root: ArtifactRepoPathSchema,
+    entry: ArtifactRepoPathSchema,
+    network: Type.Boolean(),
 }, { additionalProperties: false });
 export const ArtifactServerManifestSchema = Type.Object({
     title: ArtifactTitleSchema,
     kind: Type.Literal("server"),
-    cwd: ViewerPathSchema,
-    script: Type.Literal("artifact:preview"),
-    ready_path: Type.Optional(Type.String({ minLength: 1, maxLength: 256, pattern: "^/" })),
-    network: Type.Optional(Type.Boolean()),
+    cwd: ArtifactRepoPathSchema,
+    entry: Type.String({ minLength: 1, maxLength: 256, pattern: "^/" }),
+    network: Type.Boolean(),
 }, { additionalProperties: false });
 export const ArtifactManifestSchema = Type.Object({
     version: Type.Literal(1),
@@ -62,6 +62,31 @@ export const ArtifactProjectionSchema = Type.Union([
 export const GetArtifactsResponseSchema = Type.Object({
     artifact: ArtifactProjectionSchema,
 }, { additionalProperties: false });
+export const IssueArtifactPreviewSessionPayloadSchema = Type.Object({}, { additionalProperties: false });
+export const IssueArtifactPreviewSessionDispositionSchema = Type.Union([
+    Type.Object({ kind: Type.Literal("issued") }, { additionalProperties: false }),
+    Type.Object({ kind: Type.Literal("not_declared") }, { additionalProperties: false }),
+    Type.Object({
+        kind: Type.Literal("invalid_manifest"),
+        message: NonEmptyStringSchema,
+    }, { additionalProperties: false }),
+    Type.Object({
+        kind: Type.Literal("preview_not_ready"),
+        status: Type.Union([
+            Type.Literal("starting"),
+            Type.Literal("stopped"),
+            Type.Literal("failed"),
+        ]),
+        message: Type.Optional(NonEmptyStringSchema),
+    }, { additionalProperties: false }),
+    InterruptedCommandDispositionSchema,
+]);
+export const IssueArtifactPreviewSessionResultSchema = Type.Object({
+    bootstrap_url: Type.String({ minLength: 1 }),
+    expires_at: IsoDateTimeStringSchema,
+}, { additionalProperties: false });
+export const IssueArtifactPreviewSessionBodySchema = commandEnvelopeSchema(IssueArtifactPreviewSessionPayloadSchema);
+export const IssueArtifactPreviewSessionResponseSchema = commandResponseWithResultSchema(IssueArtifactPreviewSessionDispositionSchema, IssueArtifactPreviewSessionResultSchema);
 export const ArtifactPreviewCommandPayloadSchema = Type.Object({}, { additionalProperties: false });
 export const StartArtifactPreviewDispositionSchema = Type.Union([
     Type.Object({ kind: Type.Literal("started") }, { additionalProperties: false }),

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

@@ -11,7 +11,7 @@ export { CheckSkipReasonCodeSchema, ExternalSideEffectSummaryProjectionSchema, G
 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";
-export { ArtifactKindSchema, ArtifactManifestPathSchema, ArtifactManifestSchema, ArtifactPreviewCommandPayloadSchema, ArtifactPreviewCommandResultSchema, ArtifactPreviewProjectionSchema, ArtifactPreviewStatusSchema, ArtifactServerManifestSchema, ArtifactStaticManifestSchema, ArtifactSummaryProjectionSchema, ArtifactTitleSchema, ArtifactProjectionSchema, GetArtifactsResponseSchema, HeartbeatArtifactPreviewBodySchema, HeartbeatArtifactPreviewDispositionSchema, HeartbeatArtifactPreviewResponseSchema, StartArtifactPreviewBodySchema, StartArtifactPreviewDispositionSchema, StartArtifactPreviewResponseSchema, StopArtifactPreviewBodySchema, StopArtifactPreviewDispositionSchema, StopArtifactPreviewResponseSchema, } from "./artifacts.js";
+export { ArtifactKindSchema, ArtifactManifestPathSchema, ArtifactManifestSchema, ArtifactPreviewCommandPayloadSchema, ArtifactPreviewCommandResultSchema, ArtifactPreviewProjectionSchema, ArtifactPreviewStatusSchema, ArtifactServerManifestSchema, ArtifactStaticManifestSchema, ArtifactSummaryProjectionSchema, ArtifactTitleSchema, ArtifactProjectionSchema, GetArtifactsResponseSchema, HeartbeatArtifactPreviewBodySchema, HeartbeatArtifactPreviewDispositionSchema, HeartbeatArtifactPreviewResponseSchema, IssueArtifactPreviewSessionBodySchema, IssueArtifactPreviewSessionDispositionSchema, IssueArtifactPreviewSessionPayloadSchema, IssueArtifactPreviewSessionResponseSchema, IssueArtifactPreviewSessionResultSchema, StartArtifactPreviewBodySchema, StartArtifactPreviewDispositionSchema, StartArtifactPreviewResponseSchema, StopArtifactPreviewBodySchema, StopArtifactPreviewDispositionSchema, StopArtifactPreviewResponseSchema, } from "./artifacts.js";
 export { DeleteSkillBodySchema, DeleteSkillDispositionSchema, DeleteSkillPayloadSchema, DeleteSkillResponseSchema, GetSkillParamsSchema, GetSkillResponseSchema, GetSkillsResponseSchema, ImportSkillZipBodySchema, ImportSkillZipDispositionSchema, ImportSkillZipPayloadSchema, ImportSkillZipResponseSchema, ImportSkillZipResultSchema, SkillDetailProjectionSchema, SkillNameSchema, SkillProjectionSchema, } from "./skills.js";
 export { ActivityEventProjectionSchema, ActivityEventSsePayloadSchema, ApprovalChangedEventPayloadSchema, ActivityProjectionSchema, ConnectionReadyEventPayloadSchema, ExecutionActivitySummarySchema, ExecutionStatusChangedEventPayloadSchema, ExecutionStatusKindSchema, ExecutionStatusProjectionSchema, ProcedureLaneSchema, ProviderConfigChangedEventPayloadSchema, QueryInvalidateEventPayloadSchema, ScratchpadUpdatedEventPayloadSchema, TaskDetailUpdatedEventPayloadSchema, TaskUpdatedEventPayloadSchema, WorklistChangedEventPayloadSchema, WorkspaceRecoveredEventPayloadSchema, } from "./runtime-events.js";
 export { ContextSyncBodySchema, ContextSyncDispositionSchema, ContextSyncPayloadSchema, ContextSyncResponseSchema, ContextSyncResultSchema, InitializeProjectDocsBodySchema, InitializeProjectDocsDispositionSchema, InitializeProjectDocsPayloadSchema, InitializeProjectDocsResponseSchema, InitializeProjectDocsResultSchema, ProjectDocsProcedureStartResultSchema, RefreshScratchpadDispositionSchema, RefreshScratchpadResultSchema, RunSchedulerNowBodySchema, RunSchedulerNowDispositionSchema, RunSchedulerNowPayloadSchema, RunSchedulerNowResponseSchema, SubmitWorklistBodySchema, SubmitWorklistDispositionSchema, SubmitWorklistPayloadSchema, SubmitWorklistResponseSchema, SubmitWorklistResultSchema, UpdateProjectDescriptionBodySchema, UpdateProjectDescriptionDispositionSchema, UpdateProjectDescriptionPayloadSchema, UpdateProjectDescriptionResponseSchema, UpdateProjectDescriptionResultSchema, UpdateProjectDisplayNameBodySchema, UpdateProjectDisplayNameDispositionSchema, UpdateProjectDisplayNamePayloadSchema, UpdateProjectDisplayNameResponseSchema, UpdateProjectDisplayNameResultSchema, } from "./workspace-commands.js";

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

@@ -10,7 +10,7 @@ export { CheckSkipReasonCodeSchema, ExternalSideEffectSummaryProjectionSchema, G
 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";
-export { ArtifactKindSchema, ArtifactManifestPathSchema, ArtifactManifestSchema, ArtifactPreviewCommandPayloadSchema, ArtifactPreviewCommandResultSchema, ArtifactPreviewProjectionSchema, ArtifactPreviewStatusSchema, ArtifactServerManifestSchema, ArtifactStaticManifestSchema, ArtifactSummaryProjectionSchema, ArtifactTitleSchema, ArtifactProjectionSchema, GetArtifactsResponseSchema, HeartbeatArtifactPreviewBodySchema, HeartbeatArtifactPreviewDispositionSchema, HeartbeatArtifactPreviewResponseSchema, StartArtifactPreviewBodySchema, StartArtifactPreviewDispositionSchema, StartArtifactPreviewResponseSchema, StopArtifactPreviewBodySchema, StopArtifactPreviewDispositionSchema, StopArtifactPreviewResponseSchema, } from "./artifacts.js";
+export { ArtifactKindSchema, ArtifactManifestPathSchema, ArtifactManifestSchema, ArtifactPreviewCommandPayloadSchema, ArtifactPreviewCommandResultSchema, ArtifactPreviewProjectionSchema, ArtifactPreviewStatusSchema, ArtifactServerManifestSchema, ArtifactStaticManifestSchema, ArtifactSummaryProjectionSchema, ArtifactTitleSchema, ArtifactProjectionSchema, GetArtifactsResponseSchema, HeartbeatArtifactPreviewBodySchema, HeartbeatArtifactPreviewDispositionSchema, HeartbeatArtifactPreviewResponseSchema, IssueArtifactPreviewSessionBodySchema, IssueArtifactPreviewSessionDispositionSchema, IssueArtifactPreviewSessionPayloadSchema, IssueArtifactPreviewSessionResponseSchema, IssueArtifactPreviewSessionResultSchema, StartArtifactPreviewBodySchema, StartArtifactPreviewDispositionSchema, StartArtifactPreviewResponseSchema, StopArtifactPreviewBodySchema, StopArtifactPreviewDispositionSchema, StopArtifactPreviewResponseSchema, } from "./artifacts.js";
 export { DeleteSkillBodySchema, DeleteSkillDispositionSchema, DeleteSkillPayloadSchema, DeleteSkillResponseSchema, GetSkillParamsSchema, GetSkillResponseSchema, GetSkillsResponseSchema, ImportSkillZipBodySchema, ImportSkillZipDispositionSchema, ImportSkillZipPayloadSchema, ImportSkillZipResponseSchema, ImportSkillZipResultSchema, SkillDetailProjectionSchema, SkillNameSchema, SkillProjectionSchema, } from "./skills.js";
 export { ActivityEventProjectionSchema, ActivityEventSsePayloadSchema, ApprovalChangedEventPayloadSchema, ActivityProjectionSchema, ConnectionReadyEventPayloadSchema, ExecutionActivitySummarySchema, ExecutionStatusChangedEventPayloadSchema, ExecutionStatusKindSchema, ExecutionStatusProjectionSchema, ProcedureLaneSchema, ProviderConfigChangedEventPayloadSchema, QueryInvalidateEventPayloadSchema, ScratchpadUpdatedEventPayloadSchema, TaskDetailUpdatedEventPayloadSchema, TaskUpdatedEventPayloadSchema, WorklistChangedEventPayloadSchema, WorkspaceRecoveredEventPayloadSchema, } from "./runtime-events.js";
 export { ContextSyncBodySchema, ContextSyncDispositionSchema, ContextSyncPayloadSchema, ContextSyncResponseSchema, ContextSyncResultSchema, InitializeProjectDocsBodySchema, InitializeProjectDocsDispositionSchema, InitializeProjectDocsPayloadSchema, InitializeProjectDocsResponseSchema, InitializeProjectDocsResultSchema, ProjectDocsProcedureStartResultSchema, RefreshScratchpadDispositionSchema, RefreshScratchpadResultSchema, RunSchedulerNowBodySchema, RunSchedulerNowDispositionSchema, RunSchedulerNowPayloadSchema, RunSchedulerNowResponseSchema, SubmitWorklistBodySchema, SubmitWorklistDispositionSchema, SubmitWorklistPayloadSchema, SubmitWorklistResponseSchema, SubmitWorklistResultSchema, UpdateProjectDescriptionBodySchema, UpdateProjectDescriptionDispositionSchema, UpdateProjectDescriptionPayloadSchema, UpdateProjectDescriptionResponseSchema, UpdateProjectDescriptionResultSchema, UpdateProjectDisplayNameBodySchema, UpdateProjectDisplayNameDispositionSchema, UpdateProjectDisplayNamePayloadSchema, UpdateProjectDisplayNameResponseSchema, UpdateProjectDisplayNameResultSchema, } from "./workspace-commands.js";

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

@@ -11,7 +11,7 @@ import type { CheckSkipReasonCodeSchema, ExternalSideEffectSummaryProjectionSche
 import type { ActiveApprovalProjectionSchema, ApprovalCommandProjectionSchema, ApprovalDecisionKindSchema, ApprovalDecisionOptionProjectionSchema, ApprovalFileChangeProjectionSchema, ApprovalPermissionsProjectionSchema, ApprovalRequestKindSchema, ApprovalRequestProjectionSchema, ApprovalResolutionOutcomeSchema, ApprovalResolutionProjectionSchema, DecideApprovalDispositionSchema, DecideApprovalPayloadSchema, DecideApprovalResultSchema } from "./approvals.js";
 import type { ActiveClarificationProjectionSchema, ClarificationChangedEventPayloadSchema, ClarificationOwnerProjectionSchema, ClarificationRequestPayloadSchema, ClarificationRoundProjectionSchema, ClarificationRoundSummaryProjectionSchema, ClarificationSuccessorRefSchema, ClarificationThreadProjectionSchema, ContextRefSchema, GetClarificationRoundMessagesRequestSchema, GetClarificationRoundResponseSchema, GetClarificationThreadResponseSchema, HumanInteractionPayloadSchema, HumanRequestPayloadSchema, SendClarificationRoundMessageDispositionSchema, SendClarificationRoundMessagePayloadSchema, SendClarificationRoundMessageResultSchema, SubmitClarificationRoundDispositionSchema, SubmitClarificationRoundPayloadSchema, SubmitClarificationRoundResultSchema } from "./clarifications.js";
 import type { GetProjectDocRequestSchema, GetProjectDocResponseSchema, GetProjectDocsResponseSchema, GetReferenceFilesRequestSchema, GetReferenceFilesResponseSchema, GetViewerAssetRequestSchema, GetViewerFileRequestSchema, GetViewerFileResponseSchema, GetViewerTreeRequestSchema, GetViewerTreeResponseSchema, ProjectDocKeySchema, ProjectDocParamsSchema, ProjectDocSummaryProjectionSchema, ReferenceDirectoryProjectionSchema, ReferenceFileProjectionSchema, ReferenceSummaryProjectionSchema, ReferenceTextReadBlockedReasonSchema, RefreshReferenceSummariesDispositionSchema, RefreshReferenceSummariesPayloadSchema, RefreshReferenceSummariesResultSchema, UploadReferenceFileDispositionSchema, UploadReferenceFilePayloadSchema, UploadReferenceFileResultSchema, ViewerAssetVariantSchema, ViewerFileContentProjectionSchema, ViewerFileProjectionSchema, ViewerPathSchema, ViewerRepoSnapshotSchema, ViewerTreeEntryProjectionSchema, ViewerTreeTextReadBlockedReasonSchema, ViewerUnreadableReasonSchema } from "./viewer-reference.js";
-import type { ArtifactKindSchema, ArtifactManifestPathSchema, ArtifactManifestSchema, ArtifactPreviewCommandPayloadSchema, ArtifactPreviewCommandResultSchema, ArtifactPreviewProjectionSchema, ArtifactPreviewStatusSchema, ArtifactProjectionSchema, ArtifactServerManifestSchema, ArtifactStaticManifestSchema, ArtifactSummaryProjectionSchema, GetArtifactsResponseSchema, HeartbeatArtifactPreviewDispositionSchema, StartArtifactPreviewDispositionSchema, StopArtifactPreviewDispositionSchema } from "./artifacts.js";
+import type { ArtifactKindSchema, ArtifactManifestPathSchema, ArtifactManifestSchema, ArtifactPreviewCommandPayloadSchema, ArtifactPreviewCommandResultSchema, ArtifactPreviewProjectionSchema, ArtifactPreviewStatusSchema, ArtifactProjectionSchema, ArtifactServerManifestSchema, ArtifactStaticManifestSchema, ArtifactSummaryProjectionSchema, GetArtifactsResponseSchema, HeartbeatArtifactPreviewDispositionSchema, IssueArtifactPreviewSessionDispositionSchema, IssueArtifactPreviewSessionPayloadSchema, IssueArtifactPreviewSessionResultSchema, StartArtifactPreviewDispositionSchema, StopArtifactPreviewDispositionSchema } from "./artifacts.js";
 import type { DeleteSkillDispositionSchema, DeleteSkillPayloadSchema, GetSkillParamsSchema, GetSkillResponseSchema, GetSkillsResponseSchema, ImportSkillZipDispositionSchema, ImportSkillZipPayloadSchema, ImportSkillZipResultSchema, SkillDetailProjectionSchema, SkillNameSchema, SkillProjectionSchema } from "./skills.js";
 import type { ActivityEventProjectionSchema, ActivityEventSsePayloadSchema, ApprovalChangedEventPayloadSchema, ActivityProjectionSchema, ConnectionReadyEventPayloadSchema, ExecutionActivitySummarySchema, ExecutionRuntimeActionSchema, ExecutionRuntimeSnapshotSchema, ExecutionRuntimeTokenUsageSchema, ExecutionStatusChangedEventPayloadSchema, ExecutionStatusKindSchema, ExecutionStatusProjectionSchema, ProcedureLaneSchema, ProviderConfigChangedEventPayloadSchema, QueryInvalidateEventPayloadSchema, ScratchpadUpdatedEventPayloadSchema, TaskDetailUpdatedEventPayloadSchema, TaskUpdatedEventPayloadSchema, WorklistChangedEventPayloadSchema, WorkspaceRecoveredEventPayloadSchema } from "./runtime-events.js";
 import type { ContextSyncDispositionSchema, ContextSyncPayloadSchema, ContextSyncResultSchema, InitializeProjectDocsDispositionSchema, InitializeProjectDocsPayloadSchema, InitializeProjectDocsResultSchema, RefreshScratchpadDispositionSchema, RefreshScratchpadResultSchema, RunSchedulerNowDispositionSchema, RunSchedulerNowPayloadSchema, SubmitWorklistDispositionSchema, SubmitWorklistPayloadSchema, SubmitWorklistResultSchema, UpdateProjectDescriptionDispositionSchema, UpdateProjectDescriptionPayloadSchema, UpdateProjectDescriptionResultSchema, UpdateProjectDisplayNameDispositionSchema, UpdateProjectDisplayNamePayloadSchema, UpdateProjectDisplayNameResultSchema } from "./workspace-commands.js";
@@ -211,6 +211,10 @@ export type ArtifactSummaryProjection = Static<typeof ArtifactSummaryProjectionS
 export type ArtifactPreviewProjection = Static<typeof ArtifactPreviewProjectionSchema>;
 export type ArtifactProjection = Static<typeof ArtifactProjectionSchema>;
 export type GetArtifactsResponse = Static<typeof GetArtifactsResponseSchema>;
+export type IssueArtifactPreviewSessionPayload = Static<typeof IssueArtifactPreviewSessionPayloadSchema>;
+export type IssueArtifactPreviewSessionDisposition = Static<typeof IssueArtifactPreviewSessionDispositionSchema>;
+export type IssueArtifactPreviewSessionResult = Static<typeof IssueArtifactPreviewSessionResultSchema>;
+export type IssueArtifactPreviewSessionResponse = CommandResponse<IssueArtifactPreviewSessionDisposition, IssueArtifactPreviewSessionResult>;
 export type ArtifactPreviewCommandPayload = Static<typeof ArtifactPreviewCommandPayloadSchema>;
 export type StartArtifactPreviewDisposition = Static<typeof StartArtifactPreviewDispositionSchema>;
 export type HeartbeatArtifactPreviewDisposition = Static<typeof HeartbeatArtifactPreviewDispositionSchema>;

package/node_modules/@tutti/shared/dist/utils/redaction/index.d.ts

@@ -7,7 +7,7 @@ export declare const REDACTION_LABELS: {
     readonly hostSecret: "[REDACTED:host_secret]";
     readonly localPath: "[REDACTED:local_path]";
 };
-export declare const REDACTION_FIXTURES: readonly ["sk-proj-example-secret", "Authorization: Bearer example-token", "Cookie: tutti_session=example-session", "http://127.0.0.1:4370/join/example-join-token", "http://127.0.0.1:4370/api/v1/join/example-join-token/accept", "http://127.0.0.1:4371/setup?token=example-runtime-token", "host_connection_token=example-host-token", "host_registration_secret=example-host-secret", "/Users/example/.tutti/auth.json", "/Users/example/project/.git/config", "/Users/example/.tutti/projects/proj_123/runs/act_123", "OPENAI_API_KEY=example"];
+export declare const REDACTION_FIXTURES: readonly ["sk-proj-example-secret", "Authorization: Bearer example-token", "Cookie: tutti_session=example-session", "Cookie: tutti_preview_session=example-preview-session", "https://opaque.preview.tutti.now/__tutti_preview_bootstrap#token=example-preview-token", "http://127.0.0.1:4370/join/example-join-token", "http://127.0.0.1:4370/api/v1/join/example-join-token/accept", "http://127.0.0.1:4371/setup?token=example-runtime-token", "host_connection_token=example-host-token", "host_registration_secret=example-host-secret", "/Users/example/.tutti/auth.json", "/Users/example/project/.git/config", "/Users/example/.tutti/projects/proj_123/runs/act_123", "OPENAI_API_KEY=example"];
 export declare function redactText(value: string): string;
 export declare function redactValue(value: unknown): unknown;
 export type RedactedError = {