@xfey/tutti 0.1.16 → 0.1.18

package/dist/server-shell/cli/project-resolver.js

@@ -70,28 +70,50 @@ function resolveSingleTargetMatch(target, matches) {
     throw new LaunchError("project_target_not_found", `Project target was not found: ${target}`, "Run `tutti ps` to list known projects, or pass a project workspace path.");
 }
 function resolveProjectTargetWorkspaceRoot(options) {
+    return resolveProjectTargetEntry(options).workspace_root;
+}
+function resolveProjectTargetEntry(options) {
     const target = options.target.trim();
     if (target === "") {
-        return resolve(options.cwd, ".");
+        return readProjectTargetEntryFromWorkspace(resolve(options.cwd, "."));
     }
     const pathCandidate = resolve(options.cwd, target);
     if (existsSync(pathCandidate)) {
-        return pathCandidate;
+        return readProjectTargetEntryFromWorkspace(pathCandidate);
     }
     const entries = listProjectTargetEntries(options.tuttiHome);
+    const pathMatches = entries.filter((entry) => resolve(entry.workspace_root) === pathCandidate);
+    if (pathMatches.length > 0) {
+        return resolveSingleTargetMatch(target, pathMatches);
+    }
     const exactId = entries.filter((entry) => entry.project_id === target);
     if (exactId.length > 0) {
-        return resolveSingleTargetMatch(target, exactId).workspace_root;
+        return resolveSingleTargetMatch(target, exactId);
     }
     if (target.startsWith(ID_PREFIXES.project)) {
         const idPrefix = entries.filter((entry) => entry.project_id.startsWith(target));
         if (idPrefix.length > 0) {
-            return resolveSingleTargetMatch(target, idPrefix).workspace_root;
+            return resolveSingleTargetMatch(target, idPrefix);
         }
     }
     const normalizedTarget = normalizeTargetName(target);
     const nameMatches = entries.filter((entry) => entry.aliases.some((alias) => normalizeTargetName(alias) === normalizedTarget));
-    return resolveSingleTargetMatch(target, nameMatches).workspace_root;
+    return resolveSingleTargetMatch(target, nameMatches);
+}
+function readProjectTargetEntryFromWorkspace(workspaceRoot) {
+    assertSafeProjectRoot(workspaceRoot);
+    const identity = readProjectIdentity(workspaceRoot);
+    if (identity.kind !== "present") {
+        throw new LaunchError("project_identity_conflict", "Current directory is not a Tutti project", "Run `tutti launch` from a project root first.");
+    }
+    const workspaceName = basename(workspaceRoot) || identity.project_id;
+    const displayName = readProjectDisplayName(workspaceRoot) ?? workspaceName;
+    return {
+        project_id: identity.project_id,
+        workspace_root: workspaceRoot,
+        display_name: displayName,
+        aliases: Array.from(new Set([displayName, workspaceName].filter((alias) => alias.trim() !== ""))),
+    };
 }
 export function resolveLaunchWorkspacePath(options) {
     const cwd = options.cwd ?? process.cwd();
@@ -154,4 +176,44 @@ export function resolveExistingProjectContext(options) {
             : {}),
     };
 }
+export function resolveManagedProjectContext(options) {
+    const cwd = options.cwd ?? process.cwd();
+    const env = options.env ?? process.env;
+    const tuttiHome = resolveTuttiHome(env.TUTTI_HOME, cwd);
+    if (options.target === undefined || existsSync(resolve(cwd, options.target))) {
+        const existing = resolveExistingProjectContext({
+            ...(options.target === undefined ? {} : { target: options.target }),
+            cwd,
+            env,
+        });
+        return {
+            ...existing,
+            workspace_exists: true,
+        };
+    }
+    const entry = resolveProjectTargetEntry({
+        target: options.target,
+        cwd,
+        tuttiHome,
+    });
+    const binding = readBinding(tuttiHome, entry.project_id);
+    const runtimeEndpoint = readRuntimeEndpoint(tuttiHome, entry.project_id);
+    const projectConfig = readProjectOpenAiProviderConfig(tuttiHome, entry.project_id);
+    return {
+        workspace_root: entry.workspace_root,
+        workspace_exists: existsSync(entry.workspace_root),
+        tutti_home: tuttiHome,
+        project_id: entry.project_id,
+        display_name: entry.display_name,
+        binding,
+        runtime_endpoint: runtimeEndpoint,
+        provider_config: readOpenAiProviderConfigProjection({
+            tuttiHome,
+            projectId: entry.project_id,
+        }),
+        ...(projectConfig.kind === "ok" && projectConfig.config.api_base_url !== undefined
+            ? { provider_base_url: projectConfig.config.api_base_url }
+            : {}),
+    };
+}
 //# sourceMappingURL=project-resolver.js.map

package/dist/server-shell/cli/provider-tui.d.ts

@@ -1,5 +1,12 @@
 import { type ConfigureProjectOpenAiProviderResult } from "../../providers/openai/index.js";
 import type { ProjectId } from "@tutti/shared/ids";
+type ProviderSetupStep = "base-url" | "api-key";
+type ProviderFormState = {
+    step: ProviderSetupStep;
+    baseUrl: string;
+    apiKey: string;
+    error: string | undefined;
+};
 type ProviderSetupLogEvent = {
     ts: string;
     level: "error";
@@ -17,6 +24,11 @@ export type ProviderSetupResult = {
     default_model: string;
     validated_at: string;
 };
+export declare function renderProviderForm(options: {
+    state: ProviderFormState;
+    footer?: string;
+    tty?: boolean;
+}): string;
 export declare function providerValidationFailureMessage(result: ConfigureProjectOpenAiProviderResult): string;
 export declare function writeProviderSetupValidationLog(options: {
     tuttiHome: string;

package/dist/server-shell/cli/provider-tui.js

@@ -9,54 +9,51 @@ const SHOW_CURSOR = "\u001B[?25h";
 const BLINK_ON = "\u001B[5m";
 const BLINK_OFF = "\u001B[25m";
 const CLEAR = "\u001B[2J\u001B[H";
-const DIVIDER = "----------------------------------------------------------------";
+const FIELD_UNDERLINE = "------------------------------------------------------------";
 function providerSetupCancelled() {
     return new LaunchError("provider_setup_cancelled", "Provider setup cancelled.", "Run the command again when you are ready.");
 }
-function fieldLine(options) {
+function renderFieldInput(options) {
     const value = options.secret && options.value.length > 0 ? "*".repeat(options.value.length) : options.value;
-    return `> ${options.label}: ${value}${BLINK_ON}_${BLINK_OFF}`;
+    return [options.label, `${value}${BLINK_ON}_${BLINK_OFF}`, FIELD_UNDERLINE];
 }
 function renderProviderField(state) {
     if (state.step === "base-url") {
         return [
-            "Step 1 of 2 - Base URL",
-            "Enter the base URL for your OpenAI-compatible provider.",
+            "Step 1/2  Base URL",
+            "OpenAI-compatible Responses API base URL; must expose POST /responses.",
             "",
-            fieldLine({
+            ...renderFieldInput({
                 label: "Base URL",
                 value: state.baseUrl,
             }),
             "",
-            "[Enter] to continue",
+            "[Enter] Continue    [Esc] Cancel",
         ];
     }
     return [
-        "Step 2 of 2 - API Key",
-        "Enter the API key for this provider. It will be stored only in the machine-local Tutti credential store.",
+        "Step 2/2  API Key",
+        "Stored only in the machine-local Tutti credential store.",
         "",
-        fieldLine({
+        ...renderFieldInput({
             label: "API Key",
             value: state.apiKey,
             secret: true,
         }),
         "",
         state.error === undefined
-            ? "[Enter] to validate    [Esc] to edit Base URL"
-            : "[Enter] to retry    [Esc] to edit Base URL",
+            ? "[Enter] Validate    [Esc] Back to Base URL"
+            : "[Enter] Retry    [Esc] Back to Base URL",
     ];
 }
-function renderProviderForm(options) {
+export function renderProviderForm(options) {
     const lines = [
         CLEAR,
         HIDE_CURSOR,
         renderTuttiTerminalLogo({ tty: options.tty === true }),
         "",
         "Provider setup",
-        DIVIDER,
-        "Tutti uses an OpenAI-compatible Responses API provider.",
-        "The base URL should expose POST /responses under the entered URL.",
-        DIVIDER,
+        "Connect a provider compatible with OpenAI's Responses API.",
         "",
         ...renderProviderField(options.state),
         "",
@@ -209,9 +206,7 @@ function renderChecking(frame, tty) {
         renderTuttiTerminalLogo({ tty }),
         "",
         "Provider setup",
-        DIVIDER,
-        "Validating the provider with the configured Responses API endpoint.",
-        DIVIDER,
+        "Validating the configured Responses API endpoint.",
         "",
         `${indicator} Checking provider connection with ${DEFAULT_OPENAI_MODEL}...`,
     ].join("\n");

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

@@ -1,6 +1,7 @@
 import { type ProjectId } from "@tutti/shared/ids";
 import { type FetchLike } from "./host-runtime-endpoint.js";
 import { type MachineRuntimeEndpointRecord } from "./machine-local.js";
+import type { LocalControlFetch } from "./local-control-client.js";
 export type RuntimeProjectRow = {
     project_id: ProjectId;
     status: "online" | "stale";
@@ -22,10 +23,18 @@ export declare function runPsManageCommand(options?: {
     stdin?: NodeJS.ReadStream;
     stdout?: NodeJS.WriteStream;
 }): Promise<void>;
-export declare function runStopCommand(target?: string): Promise<string>;
+export declare function runStopCommand(target?: string, options?: {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    fetchImpl?: LocalControlFetch;
+}): Promise<string>;
 export declare function runInviteCommand(target?: string): Promise<string>;
 export declare function runProviderStatusCommand(target?: string): string;
 export declare function runLogsCommand(target?: string, tailLines?: number): string;
+export declare function runDoctorCommand(target?: string, options?: {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+}): string;
 export declare function readRuntimeEndpointForProject(tuttiHome: string, projectId: ProjectId): MachineRuntimeEndpointRecord | null;
 export declare function runtimeEndpointPathForProject(tuttiHome: string, projectId: ProjectId): string;
 export declare function projectLocalStoreRoot(tuttiHome: string, projectId: ProjectId): string;

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

@@ -4,16 +4,19 @@ import { emitKeypressEvents } from "node:readline";
 import { ID_PREFIXES, isPrefixedId } from "@tutti/shared/ids";
 import { redactText } from "@tutti/shared/utils";
 import { createRuntimeEndpointProbe } from "./host-runtime-endpoint.js";
-import { getHostLogFilePath, getMachineRuntimeEndpointPath, getProjectLocalStoreRoot, readMachineProjectBinding, readMachineRuntimeEndpoint, } from "./machine-local.js";
+import { deleteMachineProjectLocalState, getHostLogFilePath, getMachineRuntimeEndpointPath, getProjectLocalStoreRoot, readMachineProjectBinding, readMachineRuntimeEndpoint, } from "./machine-local.js";
 import { readHostLocalLaunchStatus, readHostLocalProject, readHostLocalProviderConfig, requestHostLocalShutdown, rotateHostLocalInvite, } from "./local-control-client.js";
 import { formatCliErrorReason, LaunchError } from "./errors.js";
-import { resolveExistingProjectContext } from "./project-resolver.js";
+import { resolveManagedProjectContext } from "./project-resolver.js";
 import { formatJoinLinkValidity, renderTerminalQr } from "./terminal-qr.js";
 import { resolveTuttiHome } from "../../providers/openai/index.js";
+import { readCliVersion } from "./version.js";
 const PROJECT_ID_DISPLAY_MIN_LENGTH = 12;
-function resolveProject(target) {
-    return resolveExistingProjectContext({
+function resolveProject(target, options = {}) {
+    return resolveManagedProjectContext({
         ...(target === undefined ? {} : { target }),
+        ...(options.cwd === undefined ? {} : { cwd: options.cwd }),
+        ...(options.env === undefined ? {} : { env: options.env }),
     });
 }
 function projectIdsFromTuttiHome(tuttiHome) {
@@ -271,18 +274,35 @@ export async function runPsManageCommand(options = {}) {
         stdout.write(SHOW_CURSOR);
     }
 }
-export async function runStopCommand(target) {
-    const project = resolveProject(target);
+export async function runStopCommand(target, options = {}) {
+    const project = resolveProject(target, options);
     const endpoint = project.runtime_endpoint;
     if (endpoint === null) {
+        if (!project.workspace_exists) {
+            deleteMachineProjectLocalState({
+                tuttiHome: project.tutti_home,
+                projectId: project.project_id,
+            });
+            return `Deleted ${project.display_name}; the workspace no longer exists.`;
+        }
         return "Tutti host is not running for this project.";
     }
     try {
-        await requestHostLocalShutdown({ endpoint });
+        await requestHostLocalShutdown({
+            endpoint,
+            ...(options.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+        });
     }
     catch (error) {
         throw new LaunchError("existing_server_unhealthy", `Could not stop the host: ${formatCliErrorReason(error)}`, "Run `tutti ps` to inspect the runtime state, or stop the host process manually.");
     }
+    if (!project.workspace_exists) {
+        deleteMachineProjectLocalState({
+            tuttiHome: project.tutti_home,
+            projectId: project.project_id,
+        });
+        return `Stopped and deleted ${project.display_name}; the workspace no longer exists.`;
+    }
     return `Stopped ${project.display_name}.`;
 }
 export async function runInviteCommand(target) {
@@ -339,6 +359,24 @@ export function runLogsCommand(target, tailLines = 120) {
     const lines = readFileSync(logPath, "utf8").split(/\r?\n/u).filter(Boolean).slice(-tailLines);
     return lines.length === 0 ? "Host log is empty." : lines.join("\n");
 }
+export function runDoctorCommand(target, options = {}) {
+    const checks = [];
+    checks.push(`Node: ${process.version}`);
+    checks.push(`Tutti: ${readCliVersion()}`);
+    try {
+        const project = resolveProject(target, options);
+        checks.push(`Project: ${project.display_name}`);
+        checks.push(`Project ID: ${project.project_id}`);
+        checks.push(`Workspace: ${project.workspace_exists ? redactText(project.workspace_root) : "missing"}`);
+        checks.push(`Provider: ${project.provider_config.status}`);
+        checks.push(`Host: ${project.runtime_endpoint === null ? "not running" : project.runtime_endpoint.base_url}`);
+    }
+    catch (error) {
+        checks.push("Project: unavailable");
+        checks.push(`Project detail: ${formatCliErrorReason(error)}`);
+    }
+    return checks.join("\n");
+}
 export function readRuntimeEndpointForProject(tuttiHome, projectId) {
     return readEndpointFile(tuttiHome, projectId);
 }

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";

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

@@ -5,7 +5,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";