@xfey/tutti 0.1.17 → 0.1.18

package/dist/collaboration-state/run-recording.js

@@ -29,6 +29,9 @@ export function recordRunResult(db, input) {
         };
         if (input.result.result_kind === "finished") {
             detailResult.outcome = input.result.outcome;
+            if (input.result.user_note_candidate !== undefined) {
+                detailResult.user_note_candidate = input.result.user_note_candidate;
+            }
             detailResult.checks = input.result.checks;
             detailResult.docs = input.result.docs;
             if (input.result.skip_reason_code !== undefined) {

package/dist/collaboration-state/run-results.js

@@ -38,6 +38,9 @@ export function mapRunResultRow(row) {
         result_kind: "finished",
         outcome: result.outcome === "failed" ? "failed" : "completed",
         summary: typeof result.summary === "string" ? result.summary : "",
+        ...(typeof result.user_note_candidate === "string"
+            ? { user_note_candidate: result.user_note_candidate }
+            : {}),
         checks: result.checks === "failed" || result.checks === "skipped" ? result.checks : "passed",
         docs: result.docs === "checked_no_change" ||
             result.docs === "not_checked" ||

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

@@ -120,6 +120,7 @@ export type RecordRunResultInput = {
         summary: string;
         checks: "passed" | "failed" | "skipped";
         docs: "updated" | "checked_no_change" | "not_checked" | "sync_deferred";
+        user_note_candidate?: string;
         skip_reason_code?: TaskDetailResultProjection["skip_reason_code"];
         skip_reason_summary?: string;
         external_side_effects?: TaskDetailResultProjection["external_side_effects"];

package/dist/control-plane/index.js

@@ -313,6 +313,9 @@ export class Phase5ControlPlane {
         emitWorklistCompletedFeedback({
             store: this.store,
             events: this.events,
+            ...(this.projectContext === undefined
+                ? {}
+                : { workspaceRoot: this.projectContext.workspaceRoot }),
             now: this.now,
         });
         this.maybeStartContextSyncAfterWorklistCompletion();

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

@@ -123,6 +123,7 @@ export type RunPipelineResult = RunPipelineResultMetadata & ({
     result_kind: "finished";
     outcome: "completed" | "failed";
     summary: string;
+    user_note_candidate?: string;
     checks: "passed" | "failed" | "skipped";
     docs: "updated" | "checked_no_change" | "not_checked" | "sync_deferred";
     skip_reason_code?: NonNullable<TaskDetailProjection["detail"]["result"]["skip_reason_code"]>;

package/dist/control-plane/worklist-terminal-feedback.d.ts

@@ -5,6 +5,7 @@ import type { WorkspaceEventBus } from "../server-shell/http/workspace-events.js
 type EmitWorklistFeedbackInput = {
     store: HostProjectStore;
     events: WorkspaceEventBus;
+    workspaceRoot?: string;
     now: () => Date;
 };
 export declare function emitWorklistCompletedFeedback(input: EmitWorklistFeedbackInput): MessageProjection | null;

package/dist/control-plane/worklist-terminal-feedback.js

@@ -1,3 +1,4 @@
+import { readViewerFile, referenceFileSourceForPath, referenceMediaTypeForPath, referenceTuttiGroupForPath, } from "../workspace-ops/index.js";
 import { createMainChatAgentMessage, hasMainChatWorklistFeedbackMessage, readCompletedWorklistFeedbackTaskIds, readTaskDetailProjection, readWorklistProjection, } from "../collaboration-state/index.js";
 import { mainChatInvalidates } from "./invalidations.js";
 const BODY_ITEM_LIMIT = 12;
@@ -27,6 +28,100 @@ function feedbackItemFromEntry(entry) {
     }
     return item;
 }
+function userNoteCandidateFromEntry(entry) {
+    const trimmed = (entry.detail?.detail.result.user_note_candidate ?? "").trim();
+    return trimmed.length === 0 ? undefined : trimmed;
+}
+function normalizedUserNoteLine(value) {
+    return value.replace(/\s+/gu, " ").trim();
+}
+function finalNoteForCompletedEntries(entries) {
+    const notes = entries
+        .map(userNoteCandidateFromEntry)
+        .filter((note) => note !== undefined)
+        .map(normalizedUserNoteLine)
+        .filter((note) => note.length > 0);
+    if (notes.length === 0) {
+        return undefined;
+    }
+    if (entries.length === 1) {
+        return notes[0];
+    }
+    return `Completed work across ${entries.length} tasks: ${notes.join(" ")}`;
+}
+function shouldInspectGeneratedFiles(entry) {
+    const result = entry.detail?.detail.result;
+    return (result?.result_kind === "finished" &&
+        result.outcome === "completed" &&
+        result.promotion?.status === "promoted" &&
+        Array.isArray(result.changed_paths));
+}
+function generatedFileProjection(file) {
+    const projection = {
+        path: file.path,
+        name: file.name,
+        size_bytes: file.size_bytes,
+    };
+    const group = referenceTuttiGroupForPath(file.path);
+    if (group !== undefined) {
+        projection.group = group;
+    }
+    const mediaType = referenceMediaTypeForPath(file.path);
+    if (mediaType !== undefined) {
+        projection.media_type = mediaType;
+    }
+    return projection;
+}
+function readGeneratedFile(input) {
+    if (referenceFileSourceForPath(input.path) !== "tutti_output") {
+        return null;
+    }
+    try {
+        const file = readViewerFile({
+            workspaceRoot: input.workspaceRoot,
+            path: input.path,
+            maxBytes: 1,
+            now: input.now,
+        });
+        return generatedFileProjection(file.file);
+    }
+    catch {
+        return null;
+    }
+}
+function generatedFilesForCompletedEntries(input, entries) {
+    const workspaceRoot = input.workspaceRoot;
+    if (workspaceRoot === undefined) {
+        return [];
+    }
+    const paths = new Set();
+    for (const entry of entries) {
+        if (!shouldInspectGeneratedFiles(entry)) {
+            continue;
+        }
+        for (const path of entry.detail?.detail.result.changed_paths ?? []) {
+            if (referenceFileSourceForPath(path) === "tutti_output") {
+                paths.add(path);
+            }
+        }
+    }
+    return [...paths]
+        .map((path) => readGeneratedFile({
+        workspaceRoot,
+        path,
+        now: input.now,
+    }))
+        .filter((file) => file !== null)
+        .sort((left, right) => {
+        const groupOrder = (left.group ?? "").localeCompare(right.group ?? "", "en", {
+            sensitivity: "base",
+        });
+        if (groupOrder !== 0) {
+            return groupOrder;
+        }
+        return left.name.localeCompare(right.name, "en", { sensitivity: "base" });
+    });
+}
 function feedbackCounters(entries) {
     const completed = entries.filter((entry) => entry.task.status === "done").length;
     const failed = entries.filter((entry) => entry.task.status === "failed").length;
@@ -51,6 +146,16 @@ function taskCountLabel(count) {
 }
 function markdownFallback(feedback) {
     const lines = [feedback.title, ""];
+    if (feedback.final_note !== undefined && feedback.final_note.trim().length > 0) {
+        lines.push(feedback.final_note.trim(), "");
+    }
+    if (feedback.generated_files !== undefined && feedback.generated_files.length > 0) {
+        lines.push("Generated files:");
+        for (const file of feedback.generated_files) {
+            lines.push(`- ${file.name}`);
+        }
+        lines.push("");
+    }
     const visibleItems = feedback.items.slice(0, BODY_ITEM_LIMIT);
     for (const item of visibleItems) {
         const prefix = item.status === "done" ? "- Done" : "- Failed";
@@ -102,6 +207,8 @@ export function emitWorklistCompletedFeedback(input) {
         return null;
     }
     const items = newCompletedEntries.map(feedbackItemFromEntry);
+    const finalNote = finalNoteForCompletedEntries(newCompletedEntries);
+    const generatedFiles = generatedFilesForCompletedEntries(input, newCompletedEntries);
     const feedback = {
         kind: "worklist_terminal",
         status: "completed",
@@ -110,6 +217,8 @@ export function emitWorklistCompletedFeedback(input) {
         feedback_key: completedFeedbackKey(items),
         counters: feedbackCounters(newCompletedEntries),
         items,
+        ...(finalNote === undefined ? {} : { final_note: finalNote }),
+        ...(generatedFiles.length === 0 ? {} : { generated_files: generatedFiles }),
     };
     return publishFeedbackMessage(input, feedback);
 }

package/dist/run-pipeline/openai.js

@@ -332,6 +332,9 @@ async function runTaskAttempt(options, input) {
         if (changedPaths.length === 0 && taskOutput.decision === "completed_no_repo_changes") {
             return completedWithoutRepoChanges({
                 summary: taskOutput.summary,
+                ...(taskOutput.user_note_candidate === undefined
+                    ? {}
+                    : { userNoteCandidate: taskOutput.user_note_candidate }),
             });
         }
         if (changedPaths.length === 0) {
@@ -424,6 +427,9 @@ async function runTaskAttempt(options, input) {
                 checks,
                 completion: "Promotion complete.",
             }),
+            ...(taskOutput.user_note_candidate === undefined
+                ? {}
+                : { user_note_candidate: taskOutput.user_note_candidate }),
             checks: checkStatus(checks),
             docs,
             ...checkSkipFields(checks),

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

@@ -1,12 +1,12 @@
 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 { TaskRunOutput } from "./task-run-output.js";
+import type { CompletedNoRepoChangesTaskRunOutput, CompletedTaskRunOutput } from "./task-run-output.js";
 export declare function runPromotionReconcile(input: {
     options: OpenAiRunPipelineRunnerOptions;
     pipelineInput: RunPipelineInput;
     runHandle: RunWorkspaceHandle;
-    taskOutput: TaskRunOutput;
+    taskOutput: CompletedTaskRunOutput | CompletedNoRepoChangesTaskRunOutput;
     sourceCommit: ResultCommit;
     changedPaths: string[];
 }): Promise<RunPipelineResult>;

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

@@ -93,6 +93,9 @@ export async function runPromotionReconcile(input) {
                 checks,
                 completion: "Promotion reconciled and complete.",
             }),
+            ...(input.taskOutput.user_note_candidate === undefined
+                ? {}
+                : { user_note_candidate: input.taskOutput.user_note_candidate }),
             checks: checkStatus(checks),
             docs,
             ...checkSkipFields(checks),

package/dist/run-pipeline/result-projections.d.ts

@@ -35,5 +35,6 @@ export declare function failedBeforeChecks(input: {
 }): RunPipelineResult;
 export declare function completedWithoutRepoChanges(input: {
     summary: string;
+    userNoteCandidate?: string;
 }): RunPipelineResult;
 //# sourceMappingURL=result-projections.d.ts.map

package/dist/run-pipeline/result-projections.js

@@ -104,6 +104,9 @@ export function completedWithoutRepoChanges(input) {
         result_kind: "finished",
         outcome: "completed",
         summary: input.summary,
+        ...(input.userNoteCandidate === undefined
+            ? {}
+            : { user_note_candidate: input.userNoteCandidate }),
         checks: "skipped",
         docs: "checked_no_change",
         skip_reason_code: "validation_not_applicable",

package/dist/run-pipeline/task-run-output.d.ts

@@ -5,10 +5,12 @@ export type InitialTaskRunOutput = {
     result: {
         completed: {
             summary: string;
+            user_note_candidate: string | null;
         };
     } | {
         completed_no_repo_changes: {
             summary: string;
+            user_note_candidate: string | null;
         };
     } | {
         needs_human: ClarificationRequestPayload;
@@ -18,13 +20,17 @@ export type InitialTaskRunOutput = {
         };
     };
 };
-export type TaskRunOutput = {
+export type CompletedTaskRunOutput = {
     decision: "completed";
     summary: string;
-} | {
+    user_note_candidate?: string;
+};
+export type CompletedNoRepoChangesTaskRunOutput = {
     decision: "completed_no_repo_changes";
     summary: string;
-} | {
+    user_note_candidate?: string;
+};
+export type TaskRunOutput = CompletedTaskRunOutput | CompletedNoRepoChangesTaskRunOutput | {
     decision: "needs_human";
     summary: string;
     clarification_request_payload: ClarificationRequestPayload;

package/dist/run-pipeline/task-run-output.js

@@ -22,10 +22,13 @@ export const TASK_RUN_OUTPUT_SCHEMA = {
                     properties: {
                         completed: {
                             type: "object",
-                            required: ["summary"],
+                            required: ["summary", "user_note_candidate"],
                             additionalProperties: false,
                             properties: {
                                 summary: { type: "string" },
+                                user_note_candidate: {
+                                    anyOf: [{ type: "string" }, { type: "null" }],
+                                },
                             },
                         },
                     },
@@ -37,10 +40,13 @@ export const TASK_RUN_OUTPUT_SCHEMA = {
                     properties: {
                         completed_no_repo_changes: {
                             type: "object",
-                            required: ["summary"],
+                            required: ["summary", "user_note_candidate"],
                             additionalProperties: false,
                             properties: {
                                 summary: { type: "string" },
+                                user_note_candidate: {
+                                    anyOf: [{ type: "string" }, { type: "null" }],
+                                },
                             },
                         },
                     },
@@ -96,6 +102,16 @@ function isSummaryRecord(value) {
         Object.keys(value).every((key) => key === "summary") &&
         typeof value.summary === "string");
 }
+function isCompletedRecord(value) {
+    return (isRecord(value) &&
+        Object.keys(value).every((key) => key === "summary" || key === "user_note_candidate") &&
+        typeof value.summary === "string" &&
+        (typeof value.user_note_candidate === "string" || value.user_note_candidate === null));
+}
+function normalizedUserNoteCandidate(value) {
+    const trimmed = (value ?? "").trim();
+    return trimmed.length === 0 ? undefined : trimmed;
+}
 export function isInitialTaskRunOutput(value) {
     if (!isRecord(value) || !isRecord(value.result) || Object.keys(value).length !== 1) {
         return false;
@@ -105,10 +121,10 @@ export function isInitialTaskRunOutput(value) {
         return false;
     }
     if ("completed" in value.result) {
-        return isSummaryRecord(value.result.completed);
+        return isCompletedRecord(value.result.completed);
     }
     if ("completed_no_repo_changes" in value.result) {
-        return isSummaryRecord(value.result.completed_no_repo_changes);
+        return isCompletedRecord(value.result.completed_no_repo_changes);
     }
     if ("needs_human" in value.result) {
         return isTaskRunClarificationRequestPayload(value.result.needs_human);
@@ -120,15 +136,19 @@ export function isInitialTaskRunOutput(value) {
 }
 export function normalizeTaskRunOutput(output) {
     if ("completed" in output.result) {
+        const userNoteCandidate = normalizedUserNoteCandidate(output.result.completed.user_note_candidate);
         return {
             decision: "completed",
             summary: output.result.completed.summary,
+            ...(userNoteCandidate === undefined ? {} : { user_note_candidate: userNoteCandidate }),
         };
     }
     if ("completed_no_repo_changes" in output.result) {
+        const userNoteCandidate = normalizedUserNoteCandidate(output.result.completed_no_repo_changes.user_note_candidate);
         return {
             decision: "completed_no_repo_changes",
             summary: output.result.completed_no_repo_changes.summary,
+            ...(userNoteCandidate === undefined ? {} : { user_note_candidate: userNoteCandidate }),
         };
     }
     if ("needs_human" in output.result) {

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

@@ -78,6 +78,7 @@ export declare const HOST_PROJECT_EXECUTION_OPENAPI_ROUTES: ({
                             finished_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                         }>>>;
                         changed_paths: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+                        user_note_candidate: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                         promotion: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
                             status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"promoted">, import("@sinclair/typebox").TLiteral<"not_promoted">, import("@sinclair/typebox").TLiteral<"not_attempted">]>;
                             summary: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;

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

@@ -283,12 +283,14 @@ export declare const HOST_PROJECT_VIEWER_OPENAPI_ROUTES: ({
                     index_path: import("@sinclair/typebox").TLiteral<"docs/reference/README.md">;
                     files_path: import("@sinclair/typebox").TLiteral<"docs/reference/files">;
                     images_path: import("@sinclair/typebox").TLiteral<"docs/reference/images">;
+                    tutti_path: import("@sinclair/typebox").TLiteral<"docs/reference/tutti">;
                     index_status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"available">, import("@sinclair/typebox").TLiteral<"missing">, import("@sinclair/typebox").TLiteral<"unreadable">]>;
                     index_unreadable_reason: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"restricted_path">, import("@sinclair/typebox").TLiteral<"secret_like">, import("@sinclair/typebox").TLiteral<"binary">, import("@sinclair/typebox").TLiteral<"unsupported_encoding">, import("@sinclair/typebox").TLiteral<"too_large">]>>;
                 }>;
                 items: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
                     path: import("@sinclair/typebox").TString;
                     name: import("@sinclair/typebox").TString;
+                    source: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"human_upload">, import("@sinclair/typebox").TLiteral<"tutti_output">]>;
                     category: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"file">, import("@sinclair/typebox").TLiteral<"image">]>;
                     size_bytes: import("@sinclair/typebox").TInteger;
                     media_type: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;

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

@@ -701,6 +701,7 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
                             finished_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                         }>>>;
                         changed_paths: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+                        user_note_candidate: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                         promotion: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
                             status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"promoted">, import("@sinclair/typebox").TLiteral<"not_promoted">, import("@sinclair/typebox").TLiteral<"not_attempted">]>;
                             summary: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;

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

@@ -1,4 +1,4 @@
-import { REFERENCE_DIRECTORY_PATH, REFERENCE_FILES_DIRECTORY_PATH, REFERENCE_IMAGES_DIRECTORY_PATH, REFERENCE_INDEX_PATH, VIEWER_HARD_READ_LIMIT_BYTES, WorkspaceOpsError, readViewerFile, readViewerSnapshot, readViewerTree, readReferenceSummaryIndex, referenceFileCategoryForPath, referenceMediaTypeForPath, referenceSummaryProjectionForEntry, } from "../../../../workspace-ops/index.js";
+import { REFERENCE_DIRECTORY_PATH, REFERENCE_FILES_DIRECTORY_PATH, REFERENCE_IMAGES_DIRECTORY_PATH, REFERENCE_INDEX_PATH, REFERENCE_TUTTI_DIRECTORY_PATH, VIEWER_HARD_READ_LIMIT_BYTES, WorkspaceOpsError, readViewerFile, readViewerSnapshot, readViewerTree, readReferenceSummaryIndex, referenceFileCategoryForPath, referenceFileSourceForPath, referenceMediaTypeForPath, referenceSummaryProjectionForEntry, } from "../../../../workspace-ops/index.js";
 import { paginateViewerItems, viewerPageLimit } from "./viewer-projections.js";
 function unreadableReasonForReferenceContent(content) {
     if (content.kind === "text") {
@@ -34,6 +34,7 @@ export function toReferenceFileProjection(options) {
         path: options.entry.path,
         name: options.entry.name,
         category,
+        source: referenceFileSourceForPath(options.entry.path) ?? "human_upload",
         size_bytes: options.entry.size_bytes ?? 0,
         text_read: referenceTextReadProjection(options.workspaceRoot, options.entry, options.now),
         summary: referenceSummaryProjectionForEntry({
@@ -64,6 +65,7 @@ function referenceDirectoryProjection(options) {
             index_path: REFERENCE_INDEX_PATH,
             files_path: REFERENCE_FILES_DIRECTORY_PATH,
             images_path: REFERENCE_IMAGES_DIRECTORY_PATH,
+            tutti_path: REFERENCE_TUTTI_DIRECTORY_PATH,
             index_status: "missing",
         };
     }
@@ -80,6 +82,7 @@ function referenceDirectoryProjection(options) {
                 index_path: REFERENCE_INDEX_PATH,
                 files_path: REFERENCE_FILES_DIRECTORY_PATH,
                 images_path: REFERENCE_IMAGES_DIRECTORY_PATH,
+                tutti_path: REFERENCE_TUTTI_DIRECTORY_PATH,
                 index_status: "available",
             };
         }
@@ -89,6 +92,7 @@ function referenceDirectoryProjection(options) {
             index_path: REFERENCE_INDEX_PATH,
             files_path: REFERENCE_FILES_DIRECTORY_PATH,
             images_path: REFERENCE_IMAGES_DIRECTORY_PATH,
+            tutti_path: REFERENCE_TUTTI_DIRECTORY_PATH,
             index_status: "unreadable",
             index_unreadable_reason: file.content.reason,
         };
@@ -101,6 +105,7 @@ function referenceDirectoryProjection(options) {
                 index_path: REFERENCE_INDEX_PATH,
                 files_path: REFERENCE_FILES_DIRECTORY_PATH,
                 images_path: REFERENCE_IMAGES_DIRECTORY_PATH,
+                tutti_path: REFERENCE_TUTTI_DIRECTORY_PATH,
                 index_status: "missing",
             };
         }
@@ -119,7 +124,7 @@ export function readReferenceFilesResponse(options, query) {
         tree = readViewerTree({
             workspaceRoot,
             path: REFERENCE_DIRECTORY_PATH,
-            depth: 2,
+            depth: 3,
             ...(now === undefined ? {} : { now }),
         });
     }
@@ -147,7 +152,7 @@ export function readReferenceFilesResponse(options, query) {
         .filter((entry) => entry.kind === "file")
         .filter((entry) => includeIndex || entry.path !== REFERENCE_INDEX_PATH)
         .filter((entry) => entry.path === REFERENCE_INDEX_PATH ||
-        referenceFileCategoryForPath(entry.path) !== undefined)
+        referenceFileSourceForPath(entry.path) !== undefined)
         .sort((left, right) => {
         const leftCategory = referenceFileCategoryForPath(left.path) ?? "file";
         const rightCategory = referenceFileCategoryForPath(right.path) ?? "file";
@@ -197,6 +202,7 @@ export function referenceFileMessageRef(file) {
     const ref = {
         path: file.path,
         name: file.name,
+        source: file.source,
         category: file.category,
         size_bytes: file.size_bytes,
         text_read: file.text_read,

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

@@ -5,6 +5,7 @@ export declare const VIEWER_HARD_READ_LIMIT_BYTES: number;
 export declare const REFERENCE_DIRECTORY_PATH: "docs/reference";
 export declare const REFERENCE_FILES_DIRECTORY_PATH: "docs/reference/files";
 export declare const REFERENCE_IMAGES_DIRECTORY_PATH: "docs/reference/images";
+export declare const REFERENCE_TUTTI_DIRECTORY_PATH: "docs/reference/tutti";
 export declare const REFERENCE_INDEX_PATH: "docs/reference/README.md";
 export declare const MAX_REFERENCE_UPLOAD_BYTES: number;
 export declare const VIEWER_ASSET_READ_LIMIT_BYTES: number;

package/dist/workspace-ops/constants.js

@@ -5,6 +5,7 @@ export const VIEWER_HARD_READ_LIMIT_BYTES = 5 * 1024 * 1024;
 export const REFERENCE_DIRECTORY_PATH = "docs/reference";
 export const REFERENCE_FILES_DIRECTORY_PATH = "docs/reference/files";
 export const REFERENCE_IMAGES_DIRECTORY_PATH = "docs/reference/images";
+export const REFERENCE_TUTTI_DIRECTORY_PATH = "docs/reference/tutti";
 export const REFERENCE_INDEX_PATH = "docs/reference/README.md";
 export const MAX_REFERENCE_UPLOAD_BYTES = 10 * 1024 * 1024;
 export const VIEWER_ASSET_READ_LIMIT_BYTES = MAX_REFERENCE_UPLOAD_BYTES;

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

@@ -1,8 +1,8 @@
-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, VIEWER_ASSET_READ_LIMIT_BYTES, VIEWER_HARD_READ_LIMIT_BYTES, WORKSPACE_OPS_MAINLINE_BRANCH, } from "./constants.js";
+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 { initializeProjectDocs, readProjectDocsInitializationStatus, syncProjectDocs, } from "./project-docs.js";
 export { uploadReferenceFile } from "./reference-files.js";
-export { referenceFileCategoryForPath, referenceMediaTypeForPath } from "./reference-metadata.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 { readViewerAsset, readViewerFile, readViewerSnapshot, readViewerTree } from "./viewer.js";

package/dist/workspace-ops/index.js

@@ -1,8 +1,8 @@
-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, VIEWER_ASSET_READ_LIMIT_BYTES, VIEWER_HARD_READ_LIMIT_BYTES, WORKSPACE_OPS_MAINLINE_BRANCH, } from "./constants.js";
+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 { initializeProjectDocs, readProjectDocsInitializationStatus, syncProjectDocs, } from "./project-docs.js";
 export { uploadReferenceFile } from "./reference-files.js";
-export { referenceFileCategoryForPath, referenceMediaTypeForPath } from "./reference-metadata.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 { readViewerAsset, readViewerFile, readViewerSnapshot, readViewerTree } from "./viewer.js";

package/dist/workspace-ops/reference-metadata.d.ts

@@ -9,5 +9,7 @@ export declare function classifyReferenceUpload(options: {
     directoryPath: string;
 };
 export declare function referenceFileCategoryForPath(path: string): ReferenceFileCategory | undefined;
+export declare function referenceFileSourceForPath(path: string): "human_upload" | "tutti_output" | undefined;
+export declare function referenceTuttiGroupForPath(path: string): string | undefined;
 export declare function referenceMediaTypeForPath(path: string): string | undefined;
 //# sourceMappingURL=reference-metadata.d.ts.map

package/dist/workspace-ops/reference-metadata.js

@@ -1,5 +1,5 @@
 import { extname, posix } from "node:path";
-import { REFERENCE_DIRECTORY_PATH, REFERENCE_FILES_DIRECTORY_PATH, REFERENCE_IMAGES_DIRECTORY_PATH, REFERENCE_INDEX_PATH, } from "./constants.js";
+import { REFERENCE_DIRECTORY_PATH, REFERENCE_FILES_DIRECTORY_PATH, REFERENCE_IMAGES_DIRECTORY_PATH, REFERENCE_INDEX_PATH, REFERENCE_TUTTI_DIRECTORY_PATH, } from "./constants.js";
 const REFERENCE_IMAGE_EXTENSIONS = new Set([".png", ".jpg", ".jpeg", ".webp", ".gif"]);
 const REFERENCE_IMAGE_MEDIA_TYPES = new Set(["image/png", "image/jpeg", "image/webp", "image/gif"]);
 function normalizeMediaType(mediaType) {
@@ -57,11 +57,36 @@ export function referenceFileCategoryForPath(path) {
     if (path.startsWith(`${REFERENCE_FILES_DIRECTORY_PATH}/`)) {
         return "file";
     }
+    if (path.startsWith(`${REFERENCE_TUTTI_DIRECTORY_PATH}/`)) {
+        return "file";
+    }
     if (posix.dirname(path) === REFERENCE_DIRECTORY_PATH && path !== REFERENCE_INDEX_PATH) {
         return "file";
     }
     return undefined;
 }
+export function referenceFileSourceForPath(path) {
+    if (path.startsWith(`${REFERENCE_TUTTI_DIRECTORY_PATH}/`)) {
+        return "tutti_output";
+    }
+    if (path.startsWith(`${REFERENCE_FILES_DIRECTORY_PATH}/`) ||
+        path.startsWith(`${REFERENCE_IMAGES_DIRECTORY_PATH}/`) ||
+        (posix.dirname(path) === REFERENCE_DIRECTORY_PATH && path !== REFERENCE_INDEX_PATH)) {
+        return "human_upload";
+    }
+    return undefined;
+}
+export function referenceTuttiGroupForPath(path) {
+    if (!path.startsWith(`${REFERENCE_TUTTI_DIRECTORY_PATH}/`)) {
+        return undefined;
+    }
+    const rest = path.slice(REFERENCE_TUTTI_DIRECTORY_PATH.length + 1);
+    const [first, second] = rest.split("/");
+    if (first === undefined || first.length === 0 || second === undefined) {
+        return undefined;
+    }
+    return first;
+}
 export function referenceMediaTypeForPath(path) {
     const extension = extname(path).toLowerCase();
     switch (extension) {

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

@@ -516,6 +516,7 @@ export declare const SendClarificationRoundMessageResultSchema: import("@sinclai
             reference_file: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
                 path: import("@sinclair/typebox").TString;
                 name: import("@sinclair/typebox").TString;
+                source: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"human_upload">, import("@sinclair/typebox").TLiteral<"tutti_output">]>;
                 category: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"file">, import("@sinclair/typebox").TLiteral<"image">]>;
                 blob_oid: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                 media_type: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
@@ -544,6 +545,14 @@ export declare const SendClarificationRoundMessageResultSchema: import("@sinclai
                     module_name: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                     latest_run_result_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                 }>>;
+                final_note: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                generated_files: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+                    path: import("@sinclair/typebox").TString;
+                    name: import("@sinclair/typebox").TString;
+                    group: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    size_bytes: import("@sinclair/typebox").TInteger;
+                    media_type: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                }>>>;
                 primary_task_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
             }>>;
         }>>;

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

@@ -6,7 +6,7 @@ export { ProviderUsageBreakdownProjectionSchema, ProviderUsageCategorySchema, Pr
 export { ProjectTimelineItemKindSchema, ProjectTimelineItemSchema, ProjectTimelineItemStatusSchema, ProjectTimelineResponseSchema, } 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, WorklistFeedbackRefSchema, } from "./messages.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 { 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";