@xfey/tutti 0.1.97 → 0.1.99

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

@@ -585,7 +585,7 @@ export declare const HOST_PROJECT_WORKSPACE_OPENAPI_ROUTES: ({
                     };
                     readonly capabilities: {
                         readonly type: "object";
-                        readonly required: readonly ["sse", "relay_join", "repo_viewer", "provider_config_query", "provider_model_update", "browser_secret_write", "task_auto_scheduler", "task_run_now_scheduler", "clarification"];
+                        readonly required: readonly ["sse", "relay_join", "repo_viewer", "provider_config_query", "provider_model_update", "browser_secret_write", "task_auto_scheduler", "task_run_now_scheduler", "clarification", "artifact_feedback"];
                         readonly additionalProperties: false;
                         readonly properties: {
                             readonly sse: {
@@ -616,6 +616,9 @@ export declare const HOST_PROJECT_WORKSPACE_OPENAPI_ROUTES: ({
                             readonly clarification: {
                                 readonly type: "boolean";
                             };
+                            readonly artifact_feedback: {
+                                readonly type: "boolean";
+                            };
                         };
                     };
                 };
@@ -776,7 +779,7 @@ export declare const HOST_PROJECT_WORKSPACE_OPENAPI_ROUTES: ({
                             };
                             readonly capabilities: {
                                 readonly type: "object";
-                                readonly required: readonly ["sse", "relay_join", "repo_viewer", "provider_config_query", "provider_model_update", "browser_secret_write", "task_auto_scheduler", "task_run_now_scheduler", "clarification"];
+                                readonly required: readonly ["sse", "relay_join", "repo_viewer", "provider_config_query", "provider_model_update", "browser_secret_write", "task_auto_scheduler", "task_run_now_scheduler", "clarification", "artifact_feedback"];
                                 readonly additionalProperties: false;
                                 readonly properties: {
                                     readonly sse: {
@@ -807,6 +810,9 @@ export declare const HOST_PROJECT_WORKSPACE_OPENAPI_ROUTES: ({
                                     readonly clarification: {
                                         readonly type: "boolean";
                                     };
+                                    readonly artifact_feedback: {
+                                        readonly type: "boolean";
+                                    };
                                 };
                             };
                         };

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

@@ -1868,7 +1868,7 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
                     };
                     readonly capabilities: {
                         readonly type: "object";
-                        readonly required: readonly ["sse", "relay_join", "repo_viewer", "provider_config_query", "provider_model_update", "browser_secret_write", "task_auto_scheduler", "task_run_now_scheduler", "clarification"];
+                        readonly required: readonly ["sse", "relay_join", "repo_viewer", "provider_config_query", "provider_model_update", "browser_secret_write", "task_auto_scheduler", "task_run_now_scheduler", "clarification", "artifact_feedback"];
                         readonly additionalProperties: false;
                         readonly properties: {
                             readonly sse: {
@@ -1899,6 +1899,9 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
                             readonly clarification: {
                                 readonly type: "boolean";
                             };
+                            readonly artifact_feedback: {
+                                readonly type: "boolean";
+                            };
                         };
                     };
                 };
@@ -2059,7 +2062,7 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
                             };
                             readonly capabilities: {
                                 readonly type: "object";
-                                readonly required: readonly ["sse", "relay_join", "repo_viewer", "provider_config_query", "provider_model_update", "browser_secret_write", "task_auto_scheduler", "task_run_now_scheduler", "clarification"];
+                                readonly required: readonly ["sse", "relay_join", "repo_viewer", "provider_config_query", "provider_model_update", "browser_secret_write", "task_auto_scheduler", "task_run_now_scheduler", "clarification", "artifact_feedback"];
                                 readonly additionalProperties: false;
                                 readonly properties: {
                                     readonly sse: {
@@ -2090,6 +2093,9 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
                                     readonly clarification: {
                                         readonly type: "boolean";
                                     };
+                                    readonly artifact_feedback: {
+                                        readonly type: "boolean";
+                                    };
                                 };
                             };
                         };

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

@@ -1,3 +1,4 @@
+import { ArtifactFeedbackValidationError, normalizeArtifactFeedbackCommand, } from "../../../../artifact-feedback/index.js";
 import { HostProjectBadRequestError, HostProjectValidationError } from "./errors.js";
 export function requireValidMessageWindowRequest(query) {
     if (query.before !== undefined && query.after !== undefined) {
@@ -9,6 +10,17 @@ export function requireValidMessageWindowRequest(query) {
     return query;
 }
 export function requireValidSendMainChatPayload(payload) {
+    if ("artifact_feedback" in payload) {
+        try {
+            return { artifact_feedback: normalizeArtifactFeedbackCommand(payload.artifact_feedback) };
+        }
+        catch (error) {
+            if (error instanceof ArtifactFeedbackValidationError) {
+                throw new HostProjectValidationError(error.message);
+            }
+            throw error;
+        }
+    }
     if (payload.body.trim() === "") {
         throw new HostProjectValidationError("Message body cannot be empty");
     }

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, REFERENCE_TUTTI_DIRECTORY_PATH, VIEWER_HARD_READ_LIMIT_BYTES, WorkspaceOpsError, readViewerFile, readViewerSnapshot, readViewerTree, readReferenceSummaryIndex, referenceFileCategoryForPath, referenceFileSourceForPath, referenceMediaTypeForPath, referenceSummaryProjectionForEntry, } from "../../../../workspace-ops/index.js";
+import { REFERENCE_DIRECTORY_PATH, REFERENCE_FILES_DIRECTORY_PATH, REFERENCE_IMAGES_DIRECTORY_PATH, REFERENCE_INDEX_PATH, VIEWER_HARD_READ_LIMIT_BYTES, WorkspaceOpsError, readReferenceFileEntries, readReferenceSummaryIndex, readViewerFile, readViewerSnapshot, referenceFileCategoryForPath, referenceMediaTypeForPath, referenceSummaryProjectionForEntry, } from "../../../../workspace-ops/index.js";
 import { paginateViewerItems, viewerPageLimit } from "./viewer-projections.js";
 function unreadableReasonForReferenceContent(content) {
     if (content.kind === "text") {
@@ -34,7 +34,6 @@ 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({
@@ -65,7 +64,6 @@ 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",
         };
     }
@@ -82,7 +80,6 @@ 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",
             };
         }
@@ -92,7 +89,6 @@ 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,
         };
@@ -105,7 +101,6 @@ 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,14 +114,9 @@ export function readReferenceFilesResponse(options, query) {
         workspaceRoot,
         ...(now === undefined ? {} : { now }),
     });
-    let tree;
+    let entries;
     try {
-        tree = readViewerTree({
-            workspaceRoot,
-            path: REFERENCE_DIRECTORY_PATH,
-            depth: 3,
-            ...(now === undefined ? {} : { now }),
-        });
+        entries = readReferenceFileEntries({ workspaceRoot });
     }
     catch (error) {
         if (error instanceof WorkspaceOpsError && error.code === "not_found") {
@@ -148,11 +138,10 @@ export function readReferenceFilesResponse(options, query) {
     }
     const includeIndex = query.include_index ?? false;
     const summaryIndex = readReferenceSummaryIndex({ workspaceRoot });
-    const referenceItems = tree.items
-        .filter((entry) => entry.kind === "file")
+    const referenceItems = entries
         .filter((entry) => includeIndex || entry.path !== REFERENCE_INDEX_PATH)
         .filter((entry) => entry.path === REFERENCE_INDEX_PATH ||
-        referenceFileSourceForPath(entry.path) !== undefined)
+        referenceFileCategoryForPath(entry.path) !== undefined)
         .sort((left, right) => {
         const leftCategory = referenceFileCategoryForPath(left.path) ?? "file";
         const rightCategory = referenceFileCategoryForPath(right.path) ?? "file";
@@ -202,7 +191,7 @@ export function referenceFileMessageRef(file) {
     const ref = {
         path: file.path,
         name: file.name,
-        source: file.source,
+        source: "human_upload",
         category: file.category,
         size_bytes: file.size_bytes,
         text_read: file.text_read,

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

@@ -560,7 +560,7 @@ export declare const WorkspaceResponseSchema: {
         };
         readonly capabilities: {
             readonly type: "object";
-            readonly required: readonly ["sse", "relay_join", "repo_viewer", "provider_config_query", "provider_model_update", "browser_secret_write", "task_auto_scheduler", "task_run_now_scheduler", "clarification"];
+            readonly required: readonly ["sse", "relay_join", "repo_viewer", "provider_config_query", "provider_model_update", "browser_secret_write", "task_auto_scheduler", "task_run_now_scheduler", "clarification", "artifact_feedback"];
             readonly additionalProperties: false;
             readonly properties: {
                 readonly sse: {
@@ -591,6 +591,9 @@ export declare const WorkspaceResponseSchema: {
                 readonly clarification: {
                     readonly type: "boolean";
                 };
+                readonly artifact_feedback: {
+                    readonly type: "boolean";
+                };
             };
         };
     };
@@ -740,7 +743,7 @@ export declare const BootstrapResponseSchema: {
                 };
                 readonly capabilities: {
                     readonly type: "object";
-                    readonly required: readonly ["sse", "relay_join", "repo_viewer", "provider_config_query", "provider_model_update", "browser_secret_write", "task_auto_scheduler", "task_run_now_scheduler", "clarification"];
+                    readonly required: readonly ["sse", "relay_join", "repo_viewer", "provider_config_query", "provider_model_update", "browser_secret_write", "task_auto_scheduler", "task_run_now_scheduler", "clarification", "artifact_feedback"];
                     readonly additionalProperties: false;
                     readonly properties: {
                         readonly sse: {
@@ -771,6 +774,9 @@ export declare const BootstrapResponseSchema: {
                         readonly clarification: {
                             readonly type: "boolean";
                         };
+                        readonly artifact_feedback: {
+                            readonly type: "boolean";
+                        };
                     };
                 };
             };

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

@@ -316,6 +316,7 @@ export const WorkspaceResponseSchema = {
                 "task_auto_scheduler",
                 "task_run_now_scheduler",
                 "clarification",
+                "artifact_feedback",
             ],
             additionalProperties: false,
             properties: {
@@ -328,6 +329,7 @@ export const WorkspaceResponseSchema = {
                 task_auto_scheduler: { type: "boolean" },
                 task_run_now_scheduler: { type: "boolean" },
                 clarification: { type: "boolean" },
+                artifact_feedback: { type: "boolean" },
             },
         },
     },

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

@@ -72,6 +72,7 @@ export type HostProjectApiCapabilities = {
     task_auto_scheduler: boolean;
     task_run_now_scheduler: boolean;
     clarification: boolean;
+    artifact_feedback: boolean;
 };
 export type HostProviderModelService = {
     discover: () => Promise<GetProviderModelsResponse>;

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

@@ -13,6 +13,7 @@ function defaultCapabilities(options) {
         task_auto_scheduler: overrides?.task_auto_scheduler ?? false,
         task_run_now_scheduler: overrides?.task_run_now_scheduler ?? true,
         clarification: overrides?.clarification ?? false,
+        artifact_feedback: overrides?.artifact_feedback ?? true,
     };
 }
 function providerSummary(providerConfig) {

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

@@ -23,8 +23,8 @@ export function registerHostProjectApiRoutes(app, options) {
     registerViewerRoutes(app, options);
     registerReferenceFilesRoutes(app, { options, workspaceEvents });
     registerSkillRoutes(app, { options, workspaceEvents });
-    registerArtifactsRoutes(app, { options, workspaceEvents });
-    registerMessagesRoutes(app, { options, workspaceEvents });
+    const artifactPreviewManager = registerArtifactsRoutes(app, { options, workspaceEvents });
+    registerMessagesRoutes(app, { options, workspaceEvents, artifactPreviewManager });
     registerWorkflowRoutes(app, options);
     registerReadStateRoutes(app, { options, workspaceEvents });
     registerClarificationRoutes(app, options);

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

@@ -5,7 +5,6 @@ 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,7 +5,6 @@ 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,10 +1,11 @@
-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 { 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 { WorkspaceOpsError } from "./errors.js";
 export { commitOwnedPaths, requireOwnedPathsWriteReady } from "./system-commits.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";
+export { isReferenceFilePath, referenceFileCategoryForPath, referenceFolderGroupForPath, referenceMediaTypeForPath, } from "./reference-metadata.js";
+export { readReferenceFileEntries } from "./reference-tree.js";
 export { readReferenceSummaryEntries, readReferenceSummaryIndex, readReferenceSummaryTargets, referenceSummaryProjectionForEntry, updateReferenceSummaries, } from "./reference-summaries.js";
 export { readViewerAsset, readViewerFile, readViewerSnapshot, readViewerTree } from "./viewer.js";
 export type { WorkspaceOpsErrorCode } from "./errors.js";

package/dist/workspace-ops/index.js

@@ -1,10 +1,11 @@
-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 { 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 { WorkspaceOpsError } from "./errors.js";
 export { commitOwnedPaths, requireOwnedPathsWriteReady } from "./system-commits.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";
+export { isReferenceFilePath, referenceFileCategoryForPath, referenceFolderGroupForPath, referenceMediaTypeForPath, } from "./reference-metadata.js";
+export { readReferenceFileEntries } from "./reference-tree.js";
 export { readReferenceSummaryEntries, readReferenceSummaryIndex, readReferenceSummaryTargets, referenceSummaryProjectionForEntry, updateReferenceSummaries, } from "./reference-summaries.js";
 export { readViewerAsset, readViewerFile, readViewerSnapshot, readViewerTree } from "./viewer.js";
 //# sourceMappingURL=index.js.map

package/dist/workspace-ops/project-doc-templates.js

@@ -129,7 +129,7 @@ ${asBulletList([
                 ...repoHints.directories.map((directory) => `Top-level directory: \`${directory}/\``),
                 ...repoHints.root_files.map((file) => `Root file: \`${file}\``),
             ], "Repository structure is pending context sync.")}
-- Human-uploaded reference materials, when present, live under \`docs/reference/\`.
+- Shared reference materials maintained by project members and Tutti, when present, live under \`docs/reference/\`.
 
 ## Naming Conventions
 

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

@@ -110,7 +110,7 @@ function appendReferenceIndexEntry(options) {
         ? [
             "# Reference Files",
             "",
-            "Human-uploaded project reference files.",
+            "Shared project reference files maintained by project members and Tutti.",
             "",
             "## Files",
             "",
@@ -185,7 +185,8 @@ export function uploadReferenceFile(options) {
         paths: [REFERENCE_INDEX_PATH, repoPath],
         message: `Add reference file: ${safeName}`,
     });
-    const resolvedCommitOid = commitOid ?? readViewerFile({ workspaceRoot: options.workspaceRoot, path: repoPath }).snapshot.head.oid;
+    const resolvedCommitOid = commitOid ??
+        readViewerFile({ workspaceRoot: options.workspaceRoot, path: repoPath }).snapshot.head.oid;
     const file = readViewerFile({
         workspaceRoot: options.workspaceRoot,
         path: repoPath,

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

@@ -9,7 +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 isReferenceFilePath(path: string): boolean;
+export declare function referenceFolderGroupForPath(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, REFERENCE_TUTTI_DIRECTORY_PATH, } from "./constants.js";
+import { extname } from "node:path";
+import { REFERENCE_DIRECTORY_PATH, REFERENCE_FILES_DIRECTORY_PATH, REFERENCE_IMAGES_DIRECTORY_PATH, REFERENCE_INDEX_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) {
@@ -54,33 +54,19 @@ export function referenceFileCategoryForPath(path) {
     if (path.startsWith(`${REFERENCE_IMAGES_DIRECTORY_PATH}/`)) {
         return "image";
     }
-    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) {
+    if (isReferenceFilePath(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 isReferenceFilePath(path) {
+    return path !== REFERENCE_INDEX_PATH && path.startsWith(`${REFERENCE_DIRECTORY_PATH}/`);
 }
-export function referenceTuttiGroupForPath(path) {
-    if (!path.startsWith(`${REFERENCE_TUTTI_DIRECTORY_PATH}/`)) {
+export function referenceFolderGroupForPath(path) {
+    if (!isReferenceFilePath(path)) {
         return undefined;
     }
-    const rest = path.slice(REFERENCE_TUTTI_DIRECTORY_PATH.length + 1);
+    const rest = path.slice(REFERENCE_DIRECTORY_PATH.length + 1);
     const [first, second] = rest.split("/");
     if (first === undefined || first.length === 0 || second === undefined) {
         return undefined;

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

@@ -1,10 +1,10 @@
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { redactText } from "@tutti/shared/utils";
-import { REFERENCE_DIRECTORY_PATH, REFERENCE_INDEX_PATH, } from "./constants.js";
+import { REFERENCE_INDEX_PATH } from "./constants.js";
 import { referenceFileCategoryForPath, referenceMediaTypeForPath } from "./reference-metadata.js";
+import { readReferenceFileEntries } from "./reference-tree.js";
 import { commitOwnedPaths, requireOwnedPathsWriteReady } from "./system-commits.js";
-import { readViewerTree } from "./viewer.js";
 const SUMMARY_SECTION_HEADING = "## Summaries";
 const SUMMARY_BLOCK_START = "<!-- tutti-reference-summaries:v1";
 const SUMMARY_BLOCK_END = "-->";
@@ -115,7 +115,7 @@ function readReferenceIndexContent(workspaceRoot) {
         return [
             "# Reference Files",
             "",
-            "Human-uploaded project reference files.",
+            "Shared project reference files maintained by project members and Tutti.",
             "",
             "## Files",
             "",
@@ -138,8 +138,7 @@ export function referenceSummaryProjectionForEntry(options) {
         ...(record.source_blob_oid === undefined ? {} : { source_blob_oid: record.source_blob_oid }),
         ...(record.read_paths === undefined ? {} : { read_paths: record.read_paths }),
     };
-    if (options.entry.blob_oid !== undefined &&
-        record.source_blob_oid !== options.entry.blob_oid) {
+    if (options.entry.blob_oid !== undefined && record.source_blob_oid !== options.entry.blob_oid) {
         return {
             status: "stale",
             ...base,
@@ -165,14 +164,8 @@ export function referenceSummaryProjectionForEntry(options) {
         ...(record.summary === undefined ? {} : { text: record.summary }),
     };
 }
-function readReferenceFileEntries(options) {
-    const tree = readViewerTree({
-        workspaceRoot: options.workspaceRoot,
-        path: REFERENCE_DIRECTORY_PATH,
-        depth: 2,
-        ...(options.now === undefined ? {} : { now: options.now }),
-    });
-    return tree.items
+function readSummaryFileEntries(options) {
+    return readReferenceFileEntries({ workspaceRoot: options.workspaceRoot })
         .filter((entry) => entry.kind === "file")
         .filter((entry) => referenceFileCategoryForPath(entry.path) !== undefined)
         .filter((entry) => entry.blob_oid !== undefined && entry.size_bytes !== undefined)
@@ -181,7 +174,7 @@ function readReferenceFileEntries(options) {
 export function readReferenceSummaryEntries(options) {
     const summaries = readReferenceSummaryIndex({ workspaceRoot: options.workspaceRoot });
     const requested = options.paths === undefined ? undefined : new Set(options.paths);
-    return readReferenceFileEntries(options)
+    return readSummaryFileEntries(options)
         .filter((entry) => requested === undefined || requested.has(entry.path))
         .map((entry) => {
         const category = referenceFileCategoryForPath(entry.path) ?? "file";
@@ -239,7 +232,9 @@ function renderSummaryRecord(record) {
     return rendered;
 }
 function renderSummariesSection(records) {
-    const items = records.map(renderSummaryRecord).sort((left, right) => left.path.localeCompare(right.path, "en", { sensitivity: "base" }));
+    const items = records
+        .map(renderSummaryRecord)
+        .sort((left, right) => left.path.localeCompare(right.path, "en", { sensitivity: "base" }));
     const json = JSON.stringify({ items }, null, 2);
     const lines = [
         SUMMARY_SECTION_HEADING,
@@ -277,9 +272,8 @@ export function updateReferenceSummaries(options) {
         }
         existing.set(summary.path, rendered);
     }
-    const currentPaths = new Set(readReferenceFileEntries({
+    const currentPaths = new Set(readSummaryFileEntries({
         workspaceRoot: options.workspaceRoot,
-        ...(options.now === undefined ? {} : { now: options.now }),
     }).map((entry) => entry.path));
     const records = [...existing.values()].filter((record) => currentPaths.has(record.path));
     const nextContent = `${removeSummarySection(existingContent)}\n\n${renderSummariesSection(records)}\n`;

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

@@ -0,0 +1,11 @@
+import type { ViewerTreeEntry } from "./types.js";
+/**
+ * Enumerate every committed regular file in the shared Reference directory.
+ * The generic Repo Viewer intentionally keeps its bounded depth contract; this
+ * Reference-specific reader is the single recursive source for the API,
+ * summaries, and agent context.
+ */
+export declare function readReferenceFileEntries(options: {
+    workspaceRoot: string;
+}): ViewerTreeEntry[];
+//# sourceMappingURL=reference-tree.d.ts.map

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

@@ -0,0 +1,34 @@
+import { posix } from "node:path";
+import { REFERENCE_DIRECTORY_PATH } from "./constants.js";
+import { WorkspaceOpsError } from "./errors.js";
+import { entryKind, lsPath, lsTreeRecursive } from "./viewer-git.js";
+import { isPathAllowedForProjection } from "./viewer-paths.js";
+import { createViewerTreeEntry } from "./viewer-tree.js";
+/**
+ * Enumerate every committed regular file in the shared Reference directory.
+ * The generic Repo Viewer intentionally keeps its bounded depth contract; this
+ * Reference-specific reader is the single recursive source for the API,
+ * summaries, and agent context.
+ */
+export function readReferenceFileEntries(options) {
+    const root = lsPath(options.workspaceRoot, REFERENCE_DIRECTORY_PATH);
+    if (root === null) {
+        throw new WorkspaceOpsError("not_found", "Reference directory was not found");
+    }
+    if (entryKind(root) !== "directory") {
+        throw new WorkspaceOpsError("validation_failed", "Reference path is not a directory");
+    }
+    return lsTreeRecursive(options.workspaceRoot, REFERENCE_DIRECTORY_PATH)
+        .filter((entry) => entryKind(entry) === "file")
+        .filter((entry) => isPathAllowedForProjection(entry.path))
+        .map((entry) => {
+        const relativePath = entry.path.slice(REFERENCE_DIRECTORY_PATH.length + 1);
+        return createViewerTreeEntry(entry, {
+            path: entry.path,
+            parentPath: posix.dirname(entry.path),
+            depth: relativePath.split("/").length,
+        });
+    })
+        .sort((left, right) => left.path.localeCompare(right.path, "en", { sensitivity: "base" }));
+}
+//# sourceMappingURL=reference-tree.js.map

package/dist/workspace-ops/viewer-git.d.ts

@@ -9,6 +9,7 @@ export type RawTreeEntry = {
 export declare function readViewerSnapshot(options: WorkspaceViewerOptions): ViewerRepoSnapshot;
 export declare function lsPath(workspaceRoot: string, normalizedPath: string): RawTreeEntry | null;
 export declare function lsDirectoryChildren(workspaceRoot: string, normalizedPath: string): RawTreeEntry[];
+export declare function lsTreeRecursive(workspaceRoot: string, normalizedPath: string): RawTreeEntry[];
 export declare function entryKind(entry: RawTreeEntry): ViewerEntryKind;
 export declare function requireFileEntry(options: {
     workspaceRoot: string;

package/dist/workspace-ops/viewer-git.js

@@ -76,6 +76,17 @@ export function lsDirectoryChildren(workspaceRoot, normalizedPath) {
         : `${WORKSPACE_OPS_MAINLINE_BRANCH}:${normalizedPath}`;
     return lsTree(workspaceRoot, ["ls-tree", "-z", "-l", treeish]);
 }
+export function lsTreeRecursive(workspaceRoot, normalizedPath) {
+    return lsTree(workspaceRoot, [
+        "ls-tree",
+        "-r",
+        "-z",
+        "-l",
+        WORKSPACE_OPS_MAINLINE_BRANCH,
+        "--",
+        normalizedPath,
+    ]);
+}
 export function entryKind(entry) {
     if (entry.mode === "040000" || entry.type === "tree") {
         return "directory";