@xfey/tutti 0.1.17 → 0.1.18

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

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

@@ -35,6 +35,7 @@ export declare const ReferenceFileCategorySchema: import("@sinclair/typebox").TU
 export declare const MessageReferenceFileRefSchema: 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>;
@@ -52,6 +53,13 @@ export declare const WorklistFeedbackItemSchema: import("@sinclair/typebox").TOb
     module_name: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     latest_run_result_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
 }>;
+export declare const WorklistFeedbackGeneratedFileSchema: 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>;
+}>;
 export declare const WorklistFeedbackRefSchema: import("@sinclair/typebox").TObject<{
     kind: import("@sinclair/typebox").TLiteral<"worklist_terminal">;
     status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"completed">, import("@sinclair/typebox").TLiteral<"failed">]>;
@@ -71,6 +79,14 @@ export declare const WorklistFeedbackRefSchema: import("@sinclair/typebox").TObj
         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>;
 }>;
 export declare const MessageRefsSchema: import("@sinclair/typebox").TObject<{
@@ -83,6 +99,7 @@ export declare const MessageRefsSchema: import("@sinclair/typebox").TObject<{
     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>;
@@ -111,6 +128,14 @@ export declare const MessageRefsSchema: import("@sinclair/typebox").TObject<{
             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>;
     }>>;
 }>;
@@ -149,6 +174,7 @@ export declare const MessageProjectionSchema: import("@sinclair/typebox").TObjec
         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>;
@@ -177,6 +203,14 @@ export declare const MessageProjectionSchema: import("@sinclair/typebox").TObjec
                 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>;
         }>>;
     }>>;
@@ -239,6 +273,7 @@ export declare const SendMainChatMessageResultSchema: import("@sinclair/typebox"
             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>;
@@ -267,6 +302,14 @@ export declare const SendMainChatMessageResultSchema: import("@sinclair/typebox"
                     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>;
             }>>;
         }>>;
@@ -325,6 +368,7 @@ export declare const MessageCreatedEventPayloadSchema: import("@sinclair/typebox
             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>;
@@ -353,6 +397,14 @@ export declare const MessageCreatedEventPayloadSchema: import("@sinclair/typebox
                     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/messages.js

@@ -43,6 +43,7 @@ export const ReferenceFileCategorySchema = Type.Union([
 export const MessageReferenceFileRefSchema = Type.Object({
     path: Type.String({ minLength: 1 }),
     name: NonEmptyStringSchema,
+    source: Type.Union([Type.Literal("human_upload"), Type.Literal("tutti_output")]),
     category: ReferenceFileCategorySchema,
     blob_oid: Type.Optional(NonEmptyStringSchema),
     media_type: Type.Optional(NonEmptyStringSchema),
@@ -67,6 +68,13 @@ export const WorklistFeedbackItemSchema = Type.Object({
     module_name: Type.Optional(NonEmptyStringSchema),
     latest_run_result_id: Type.Optional(RunResultIdSchema),
 }, { additionalProperties: false });
+export const WorklistFeedbackGeneratedFileSchema = Type.Object({
+    path: Type.String({ minLength: 1 }),
+    name: NonEmptyStringSchema,
+    group: Type.Optional(NonEmptyStringSchema),
+    size_bytes: Type.Integer({ minimum: 0 }),
+    media_type: Type.Optional(NonEmptyStringSchema),
+}, { additionalProperties: false });
 export const WorklistFeedbackRefSchema = Type.Object({
     kind: Type.Literal("worklist_terminal"),
     status: Type.Union([Type.Literal("completed"), Type.Literal("failed")]),
@@ -79,6 +87,8 @@ export const WorklistFeedbackRefSchema = Type.Object({
         remaining: Type.Integer({ minimum: 0 }),
     }, { additionalProperties: false }),
     items: Type.Array(WorklistFeedbackItemSchema),
+    final_note: Type.Optional(Type.String()),
+    generated_files: Type.Optional(Type.Array(WorklistFeedbackGeneratedFileSchema)),
     primary_task_id: Type.Optional(TaskIdSchema),
 }, { additionalProperties: false });
 export const MessageRefsSchema = Type.Object({

package/node_modules/@tutti/shared/dist/schemas/api/runtime-events.d.ts

@@ -475,6 +475,7 @@ export declare const TaskDetailUpdatedEventPayloadSchema: import("@sinclair/type
                     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/node_modules/@tutti/shared/dist/schemas/api/types.d.ts

@@ -6,7 +6,7 @@ import type { ProviderUsageBreakdownProjectionSchema, ProviderUsageCategorySchem
 import type { ProjectTimelineItemKindSchema, ProjectTimelineItemSchema, ProjectTimelineItemStatusSchema, ProjectTimelineResponseSchema } from "./project-timeline.js";
 import type { PresignedUploadPutSchema, RelayUploadProjectionSchema, RelayUploadPurposeSchema, Sha256DigestSchema, StagedUploadReferenceSchema, StartRelayUploadDispositionSchema, StartRelayUploadPayloadSchema, StartRelayUploadResultSchema } from "./uploads.js";
 import type { MarkReadDispositionSchema, MarkReadPayloadSchema, MarkReadResultSchema, ReadStateScopeProjectionSchema, ReadStateScopeSchema, ReadStateSummaryProjectionSchema } from "./read-state.js";
-import type { GetMessagesRequestSchema, MessageCreatedEventPayloadSchema, MessageProjectionSchema, MessageReferenceFileRefSchema, ReferenceFileCategorySchema, SendMainChatMessageCreatedDispositionSchema, SendMainChatMessageDispositionSchema, SendMainChatMessagePayloadSchema, SendMainChatMessageResultSchema, WorklistFeedbackItemSchema, WorklistFeedbackRefSchema } from "./messages.js";
+import type { GetMessagesRequestSchema, MessageCreatedEventPayloadSchema, MessageProjectionSchema, MessageReferenceFileRefSchema, ReferenceFileCategorySchema, SendMainChatMessageCreatedDispositionSchema, SendMainChatMessageDispositionSchema, SendMainChatMessagePayloadSchema, SendMainChatMessageResultSchema, WorklistFeedbackGeneratedFileSchema, WorklistFeedbackItemSchema, WorklistFeedbackRefSchema } from "./messages.js";
 import type { CheckSkipReasonCodeSchema, ExternalSideEffectSummaryProjectionSchema, GetRecoverySummariesRequestSchema, GetRecoverySummaryResponseSchema, RecoverySummaryProjectionSchema, RunResultProjectionSchema, ScratchpadProjectionSchema, ScratchpadReceiptProjectionSchema, TaskContractProjectionSchema, TaskDetailProjectionSchema, TaskDetailResultProjectionSchema, TaskModuleProjectionSchema, TaskProjectionSchema, TaskStatusSchema, WorklistProjectionSchema } from "./work-items.js";
 import type { ActiveApprovalProjectionSchema, ApprovalCommandProjectionSchema, ApprovalDecisionKindSchema, ApprovalDecisionOptionProjectionSchema, ApprovalFileChangeProjectionSchema, ApprovalPermissionsProjectionSchema, ApprovalRequestKindSchema, ApprovalRequestProjectionSchema, ApprovalResolutionOutcomeSchema, ApprovalResolutionProjectionSchema, DecideApprovalDispositionSchema, DecideApprovalPayloadSchema, DecideApprovalResultSchema } from "./approvals.js";
 import type { ActiveClarificationProjectionSchema, ClarificationChangedEventPayloadSchema, ClarificationOwnerProjectionSchema, ClarificationRequestPayloadSchema, ClarificationRoundProjectionSchema, ClarificationRoundSummaryProjectionSchema, ClarificationSuccessorRefSchema, ClarificationThreadProjectionSchema, ContextRefSchema, GetClarificationRoundMessagesRequestSchema, GetClarificationRoundResponseSchema, GetClarificationThreadResponseSchema, HumanInteractionPayloadSchema, HumanRequestPayloadSchema, SendClarificationRoundMessageDispositionSchema, SendClarificationRoundMessagePayloadSchema, SendClarificationRoundMessageResultSchema, SubmitClarificationRoundDispositionSchema, SubmitClarificationRoundPayloadSchema, SubmitClarificationRoundResultSchema } from "./clarifications.js";
@@ -98,6 +98,7 @@ export type MarkReadResponse = CommandResponse<MarkReadDisposition, MarkReadResu
 export type ReferenceFileCategory = Static<typeof ReferenceFileCategorySchema>;
 export type MessageReferenceFileRef = Static<typeof MessageReferenceFileRefSchema>;
 export type WorklistFeedbackItem = Static<typeof WorklistFeedbackItemSchema>;
+export type WorklistFeedbackGeneratedFile = Static<typeof WorklistFeedbackGeneratedFileSchema>;
 export type WorklistFeedbackRef = Static<typeof WorklistFeedbackRefSchema>;
 export type MessageProjection = Static<typeof MessageProjectionSchema>;
 export type MessageWindow = TimelineWindow<MessageProjection>;

package/node_modules/@tutti/shared/dist/schemas/api/viewer-reference.d.ts

@@ -250,6 +250,7 @@ export declare const ReferenceDirectoryProjectionSchema: import("@sinclair/typeb
     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">]>>;
 }>;
@@ -265,6 +266,7 @@ export declare const ReferenceSummaryProjectionSchema: import("@sinclair/typebox
 export declare const ReferenceFileProjectionSchema: 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>;
@@ -306,12 +308,14 @@ export declare const GetReferenceFilesResponseSchema: import("@sinclair/typebox"
         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>;
@@ -355,6 +359,7 @@ export declare const UploadReferenceFileResultSchema: import("@sinclair/typebox"
     file: 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>;
@@ -409,6 +414,7 @@ export declare const UploadReferenceFileResultSchema: import("@sinclair/typebox"
             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>;
@@ -437,6 +443,14 @@ export declare const UploadReferenceFileResultSchema: import("@sinclair/typebox"
                     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/viewer-reference.js

@@ -164,6 +164,7 @@ export const ReferenceDirectoryProjectionSchema = Type.Object({
     index_path: Type.Literal("docs/reference/README.md"),
     files_path: Type.Literal("docs/reference/files"),
     images_path: Type.Literal("docs/reference/images"),
+    tutti_path: Type.Literal("docs/reference/tutti"),
     index_status: Type.Union([
         Type.Literal("available"),
         Type.Literal("missing"),
@@ -195,6 +196,7 @@ export const ReferenceSummaryProjectionSchema = Type.Object({
 export const ReferenceFileProjectionSchema = Type.Object({
     path: ViewerPathSchema,
     name: NonEmptyStringSchema,
+    source: Type.Union([Type.Literal("human_upload"), Type.Literal("tutti_output")]),
     category: ReferenceFileCategorySchema,
     size_bytes: Type.Integer({ minimum: 0 }),
     media_type: Type.Optional(NonEmptyStringSchema),

package/node_modules/@tutti/shared/dist/schemas/api/work-items.d.ts

@@ -138,6 +138,7 @@ export declare const TaskDetailResultProjectionSchema: import("@sinclair/typebox
         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>;
@@ -193,6 +194,7 @@ export declare const TaskDetailProjectionSchema: import("@sinclair/typebox").TOb
                 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>;
@@ -234,6 +236,7 @@ export declare const RunResultProjectionSchema: import("@sinclair/typebox").TUni
     result_kind: import("@sinclair/typebox").TLiteral<"finished">;
     outcome: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"completed">, import("@sinclair/typebox").TLiteral<"failed">]>;
     summary: import("@sinclair/typebox").TString;
+    user_note_candidate: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     checks: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"passed">, import("@sinclair/typebox").TLiteral<"failed">, import("@sinclair/typebox").TLiteral<"skipped">]>;
     docs: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"updated">, import("@sinclair/typebox").TLiteral<"checked_no_change">, import("@sinclair/typebox").TLiteral<"not_checked">, import("@sinclair/typebox").TLiteral<"sync_deferred">]>;
     skip_reason_code: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"no_validation_command_found">, import("@sinclair/typebox").TLiteral<"project_has_no_test_setup">, import("@sinclair/typebox").TLiteral<"validation_not_applicable">, import("@sinclair/typebox").TLiteral<"command_prerequisite_missing">, import("@sinclair/typebox").TLiteral<"command_requires_external_service">, import("@sinclair/typebox").TLiteral<"command_requires_secret">, import("@sinclair/typebox").TLiteral<"command_requires_interactive_input">, import("@sinclair/typebox").TLiteral<"command_too_expensive_for_mvp">, import("@sinclair/typebox").TLiteral<"unsafe_command_blocked">, import("@sinclair/typebox").TLiteral<"known_failing_baseline">]>>;

package/node_modules/@tutti/shared/dist/schemas/api/work-items.js

@@ -127,6 +127,7 @@ export const TaskDetailResultProjectionSchema = Type.Object({
     skip_reason_summary: Type.Optional(Type.String()),
     external_side_effects: Type.Optional(Type.Array(ExternalSideEffectSummaryProjectionSchema)),
     changed_paths: Type.Optional(Type.Array(Type.String())),
+    user_note_candidate: Type.Optional(Type.String()),
     promotion: Type.Optional(Type.Object({
         status: Type.Union([
             Type.Literal("promoted"),
@@ -170,6 +171,7 @@ export const RunResultProjectionSchema = Type.Union([
         result_kind: Type.Literal("finished"),
         outcome: Type.Union([Type.Literal("completed"), Type.Literal("failed")]),
         summary: Type.String(),
+        user_note_candidate: Type.Optional(Type.String()),
         checks: Type.Union([Type.Literal("passed"), Type.Literal("failed"), Type.Literal("skipped")]),
         docs: Type.Union([
             Type.Literal("updated"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xfey/tutti",
-  "version": "0.1.17",
+  "version": "0.1.18",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/prompts/prompt-flow-map.md

@@ -45,7 +45,7 @@ Provider validation 也使用 OpenAI Responses API，但它只是启动前 crede
 - 2026-06-28：`scratchpad_refresh` provider raw output 改为 `{ result: ... }` nested branch schema，`ready` 只输出 `scratchpad_snapshot`，`needs_human` 只输出 `request_payload`，adapter 解包后保持下游 workflow union 不变。
 - 2026-06-28：`task_compile` provider-facing input 改为压缩后的 Scratchpad / Worklist / optional clarification request + answer messages，不再注入 `context_entry_json`、workflow refs、审计字段、排序字段、时间戳或完整 message projection；provider raw output 改为 `{ result: ... }` 互斥分支，分支由 `proposal` 或 `clarification_request_payload` 字段存在性表达，不再输出 `decision`。proposal task 只输出 `module_ref / title / goal / scope`，runner adapter 再映射为 Control Plane 内部 proposal。
 - 2026-06-28：`context_sync` provider-facing input 去掉 `context_entry_json`、workflow/activity refs、触发原因和诊断型字段；输出去掉 `decision`、`doc_key`、`reason`、`evidence_paths`、`checked_paths`、`skipped_paths` 和 `open_questions`，只保留 `summary` 与 `updates[].path/content`，Control Plane 通过 `updates.length` 判断是否写入。
-- 2026-06-29：`task-run` / `task-continuation` / `task-retry` provider-facing input 统一只保留 `title / goal / scope` 加必要的 `continuation` 或 `correction` block，不再注入 `context_entry_json`、task id、task summary 或 Run lineage；`task-retry` correction block 只保留 summary、reason code、guidance 和可选 promotion failure 摘要；provider raw output 改为 `{ result: ... }` 互斥分支，只输出 `completed.summary`、`completed_no_repo_changes.summary`、`needs_human.{title,summary,request}` 或 `failed.summary`。
+- 2026-06-29：`task-run` / `task-continuation` / `task-retry` provider-facing input 统一只保留 `title / goal / scope` 加必要的 `continuation` 或 `correction` block，不再注入 `context_entry_json`、task id、task summary 或 Run lineage；`task-retry` correction block 只保留 summary、reason code、guidance 和可选 promotion failure 摘要；provider raw output 改为 `{ result: ... }` 互斥分支，只输出 `completed.{summary,user_note_candidate}`、`completed_no_repo_changes.{summary,user_note_candidate}`、`needs_human.{title,summary,request}` 或 `failed.summary`。
 - 2026-06-29：`follow_up_check` provider-facing input 去掉 `context_entry_json`、task id/status、activity ref、result kind、Run lineage、message id、作者 identity 和时间戳，只保留 `title / goal / scope`、`previous_run.summary`、`previous_run.clarification_request_payload` 与 `answers[]`；provider raw output 改为 `{ result: ... }` 互斥分支，只输出 `resume.summary`、`needs_more_input.{title,summary,request}` 或 `requires_retasking.summary`。
 - 2026-06-29：`reference_summary_refresh` provider-facing input 清零；runner 复制目标 reference 文件到独立临时目录，并以该目录作为 app-server `cwd` 和唯一 readable path。prompt 不再接收 workflow/activity trace anchors、原始路径、file metadata、blob 或 media type；provider raw output 改为 `{ result: ... }` 互斥分支，只输出 `summarized.summary` 或自然语言 `unavailable.reason`。
 - 2026-07-02：新增 `project_brief_refresh`；在四个 canonical Project Docs 创建、同步、被成功 Run promotion 修改，或 provider 配置完成后需要 backfill 时尽力刷新 host-local Project Brief projection。provider-facing input 只包含四份 Project Docs 的 bounded source / status，输出 `product_summary / tech_summary / structure_summary / principles_summary`。
@@ -358,7 +358,7 @@ Provider raw 输出：根对象只包含 `result`；`result` 内二选一输出
 - Reference Files 不通过 built-in skill 暴露；若任务契约或 Project Docs 指向 `docs/reference/` 中资料，Codex 可直接读取相关 repo 文件正文。
 - 不直接读取主群聊或 Scratchpad；这些不作为 hidden scope。
 
-输出：根对象只包含 `result`；`result` 内四选一输出 `completed.summary`、`completed_no_repo_changes.summary`、`needs_human.{title,summary,request}` 或 `failed.summary`。`completed_no_repo_changes` 只用于任务契约不要求 repository file changes 的情况。`needs_human` payload 必须能直接作为 task-bound clarification request 使用：解释为什么 frozen contract 下无法安全继续，并提出一个具体、可回答、非 secret 的问题。
+输出：根对象只包含 `result`；`result` 内四选一输出 `completed.{summary,user_note_candidate}`、`completed_no_repo_changes.{summary,user_note_candidate}`、`needs_human.{title,summary,request}` 或 `failed.summary`。`user_note_candidate` 是可选最终反馈候选，字段必填但可为 `null`；生成给用户直接查看的文件应写入 `docs/reference/tutti/`。`completed_no_repo_changes` 只用于任务契约不要求 repository file changes 的情况。`needs_human` payload 必须能直接作为 task-bound clarification request 使用：解释为什么 frozen contract 下无法安全继续，并提出一个具体、可回答、非 secret 的问题。
 
 下游：Run pipeline 收集真实 Git diff 作为 `changed_paths`；`needs_human` 时 Control Plane 记录 `Run.needs_human`、打开 task-bound clarification 并把 task 迁回 `pending`；有 repo candidate 的 `completed` 结果从 Git changed paths 派生 docs 状态，再执行 checks、result commit 和 mechanical promotion；空 diff 的 `completed_no_repo_changes` 结果跳过 checks / commit / promotion，记录 `promotion.status = not_attempted`。
 

package/prompts/runs/README.md

@@ -9,7 +9,8 @@ Templates in this directory may describe task contracts, repo evidence, check ex
 
 `task-run.md` allows `needs_human` only for human requirement decisions, non-secret context, or risk confirmation. Unusable candidates, ordinary missing diffs, or repo/tooling errors that prevent implementation should be returned as `failed` so the Run does not open task-bound clarification incorrectly. If the task contract does not require repository file changes, the output can use `completed_no_repo_changes`; otherwise a completed implementation is expected to produce a candidate diff. If the candidate is complete but Codex self-validation commands are unavailable or blocked, the task-run output should still be `completed`; Tutti checks are the authoritative validation gate.
 Initial `task-run.md`, active `task-continuation.md`, and active pipeline `task-retry.md` receive only the compact task contract fields `title / goal / scope`; continuation adds the required `continuation` block, and pipeline self-correction retry adds the required `correction` block with only the previous failure summary, machine-generated reason code, correction guidance, and optional promotion failure summary. Provider-facing prompts do not receive task ids, task summaries, Run lineage, workflow anchors, changed paths, docs status, checks status, or the safety audit context entry.
-All three Run templates use a slim mutually exclusive structured output schema under `result`: exactly one of `completed.summary`, `completed_no_repo_changes.summary`, `needs_human.{title,summary,request}`, or `failed.summary`. The `summary` is a concise, human-readable result note for project members who may not inspect the code. It should describe what changed, what was found, or why the Run cannot continue; checks, docs, promotion, changed paths, and other Tutti status stay in structured fields derived by the Run pipeline. They do not ask Codex to self-report docs status or changed paths; both come from Run pipeline Git diff and derived projection.
+All three Run templates use a slim mutually exclusive structured output schema under `result`: exactly one of `completed.{summary,user_note_candidate}`, `completed_no_repo_changes.{summary,user_note_candidate}`, `needs_human.{title,summary,request}`, or `failed.summary`. The `summary` is a concise, human-readable result note for project members who may not inspect the code. Completed branches also require `user_note_candidate`, which is either a short user-facing final-card sentence or `null`; it must not repeat `summary` or include file paths. Checks, docs, promotion, changed paths, and other Tutti status stay in structured fields derived by the Run pipeline. They do not ask Codex to self-report docs status or changed paths; both come from Run pipeline Git diff and derived projection.
+Run templates describe `docs/reference/` as a user-visible file exchange area. Human uploads remain under `docs/reference/files/` and `docs/reference/images/`; Tutti-generated user-visible files must be written under `docs/reference/tutti/`, with `docs/reference/tutti/<meaningful-folder>/...` used when the folder name should be shown as a References UI group. Generated files under `docs/reference/tutti/` are discovered from promoted changed paths and rendered by References automatically.
 Initial `task-run.md`, active `task-continuation.md`, and active pipeline `task-retry.md` also instruct Codex to write or update the single active `tutti.artifact.json` manifest only when the task creates or updates a member-viewable visual artifact. The manifest must include a viewer-facing `artifact.title` and must set `artifact.network: true` when the preview loads remote browser resources. The manifest remains repo truth and is not reported through the structured output schema.
 Active task-bound follow-up still only starts continuation Runs from `Run.needs_human`. Pipeline self-correction retry happens before a terminal Run result is recorded and does not open clarification.
 Provider transient retry is separate from self-correction. If a retryable Codex app-server workspace-write failure occurs before usable structured output, Run pipeline may rerun the same prompt family once in a fresh run workspace: initial Runs stay on `task-run.md`, continuation Runs stay on `task-continuation.md`, and self-correction attempts stay on `task-retry.md`. This retry does not add `RunCorrectionContext` unless the failed attempt was already a self-correction attempt.

package/prompts/runs/task-continuation.md

@@ -57,6 +57,8 @@ Use attached skills only when they help the current task:
 
 Human-uploaded reference material is kept in the repository under `docs/reference/`. If the task contract, project docs, or clarification answer makes a reference file relevant, read the actual repo file before relying on it. Do not infer reference contents from names, upload messages, media types, or paths.
 
+`docs/reference/` is a user-visible file exchange area. Human uploads live under `docs/reference/files/` and `docs/reference/images/`. When this task produces files that project members should inspect directly, write them under `docs/reference/tutti/`. Use `docs/reference/tutti/<meaningful-folder>/...` when a folder name helps explain the output group; that folder name is shown directly in the References UI. Do not create ad hoc folders at the `docs/reference/` root. Files under `docs/reference/tutti/` are displayed automatically, so `user_note_candidate` may mention generated file names but should not include paths.
+
 # Documentation
 
 If this change affects stable project facts, usage, public behavior, interfaces, setup, project organization, maintenance context, or project working rules, update the relevant project documentation in the same worktree.
@@ -88,6 +90,8 @@ If the task creates or updates a user-viewable web page, static page, single-pag
 
 Write `summary` as a concise, human-readable result note for project members who may not inspect the code: what changed, what was found, or why the Run cannot continue. Do not narrate process, repeat structured Tutti status such as checks / docs / promotion / changed paths, or include secrets, host paths, raw logs, provider output, or long excerpts.
 
+For `completed` and `completed_no_repo_changes`, also return `user_note_candidate`. Use a short user-facing sentence only when the final completion card should tell project members a conclusion, result, or generated file name directly. Use `null` when there is no distinct user-facing note. Do not repeat `summary`, and do not include file paths.
+
 # Output
 
 Return JSON matching the structured output schema. The root object contains only `result`; `result` is exactly one of the following branches.
@@ -98,7 +102,8 @@ Completed:
 {
   "result": {
     "completed": {
-      "summary": "The clarified implementation is now complete and the relevant project notes reflect the result."
+      "summary": "The clarified implementation is now complete and the relevant project notes reflect the result.",
+      "user_note_candidate": "The generated comparison file is ready to review."
     }
   }
 }
@@ -110,7 +115,8 @@ Completed with no repository changes:
 {
   "result": {
     "completed_no_repo_changes": {
-      "summary": "The clarified task is complete and did not require repository changes."
+      "summary": "The clarified task is complete and did not require repository changes.",
+      "user_note_candidate": null
     }
   }
 }

package/prompts/runs/task-retry.md

@@ -62,6 +62,8 @@ Use attached skills only when they help the current task:
 
 Human-uploaded reference material is kept in the repository under `docs/reference/`. If the task contract, project docs, or correction context makes a reference file relevant, read the actual repo file before relying on it. Do not infer reference contents from names, upload messages, media types, or paths.
 
+`docs/reference/` is a user-visible file exchange area. Human uploads live under `docs/reference/files/` and `docs/reference/images/`. When this task produces files that project members should inspect directly, write them under `docs/reference/tutti/`. Use `docs/reference/tutti/<meaningful-folder>/...` when a folder name helps explain the output group; that folder name is shown directly in the References UI. Do not create ad hoc folders at the `docs/reference/` root. Files under `docs/reference/tutti/` are displayed automatically, so `user_note_candidate` may mention generated file names but should not include paths.
+
 # Documentation
 
 If this change affects stable project facts, usage, public behavior, interfaces, setup, project organization, maintenance context, or project working rules, update the relevant project documentation in the same worktree.
@@ -93,6 +95,8 @@ If the task creates or updates a user-viewable web page, static page, single-pag
 
 Write `summary` as a concise, human-readable result note for project members who may not inspect the code: what changed, what was found, or why the Run cannot continue. Do not narrate process, repeat structured Tutti status such as checks / docs / promotion / changed paths, or include secrets, host paths, raw logs, provider output, or long excerpts.
 
+For `completed` and `completed_no_repo_changes`, also return `user_note_candidate`. Use a short user-facing sentence only when the final completion card should tell project members a conclusion, result, or generated file name directly. Use `null` when there is no distinct user-facing note. Do not repeat `summary`, and do not include file paths.
+
 # Output
 
 Return JSON matching the structured output schema. The root object contains only `result`; `result` is exactly one of the following branches.
@@ -103,7 +107,8 @@ Completed:
 {
   "result": {
     "completed": {
-      "summary": "The task result is now complete within the frozen scope after correcting the previous candidate."
+      "summary": "The task result is now complete within the frozen scope after correcting the previous candidate.",
+      "user_note_candidate": "The corrected export file is ready to review."
     }
   }
 }
@@ -115,7 +120,8 @@ Completed with no repository changes:
 {
   "result": {
     "completed_no_repo_changes": {
-      "summary": "The requested retry is complete and did not require repository changes."
+      "summary": "The requested retry is complete and did not require repository changes.",
+      "user_note_candidate": null
     }
   }
 }

package/prompts/runs/task-run.md

@@ -44,6 +44,8 @@ Use attached skills only when they help the current task:
 
 Human-uploaded reference material is kept in the repository under `docs/reference/`. If the task contract or project docs make a reference file relevant, read the actual repo file before relying on it. Do not infer reference contents from names, upload messages, media types, or paths.
 
+`docs/reference/` is a user-visible file exchange area. Human uploads live under `docs/reference/files/` and `docs/reference/images/`. When this task produces files that project members should inspect directly, write them under `docs/reference/tutti/`. Use `docs/reference/tutti/<meaningful-folder>/...` when a folder name helps explain the output group; that folder name is shown directly in the References UI. Do not create ad hoc folders at the `docs/reference/` root. Files under `docs/reference/tutti/` are displayed automatically, so `user_note_candidate` may mention generated file names but should not include paths.
+
 # Documentation
 
 If this change affects stable project facts, usage, public behavior, interfaces, setup, project organization, maintenance context, or project working rules, update the relevant project documentation in the same worktree.
@@ -75,6 +77,8 @@ If the task creates or updates a user-viewable web page, static page, single-pag
 
 Write `summary` as a concise, human-readable result note for project members who may not inspect the code: what changed, what was found, or why the Run cannot continue. Do not narrate process, repeat structured Tutti status such as checks / docs / promotion / changed paths, or include secrets, host paths, raw logs, provider output, or long excerpts.
 
+For `completed` and `completed_no_repo_changes`, also return `user_note_candidate`. Use a short user-facing sentence only when the final completion card should tell project members a conclusion, result, or generated file name directly. Use `null` when there is no distinct user-facing note. Do not repeat `summary`, and do not include file paths.
+
 # Output
 
 Return JSON matching the structured output schema. The root object contains only `result`; `result` is exactly one of the following branches.
@@ -85,7 +89,8 @@ Completed:
 {
   "result": {
     "completed": {
-      "summary": "The requested UI state is now available, with the related usage notes updated."
+      "summary": "The requested UI state is now available, with the related usage notes updated.",
+      "user_note_candidate": "The updated usage notes file is ready to review."
     }
   }
 }
@@ -97,7 +102,8 @@ Completed with no repository changes:
 {
   "result": {
     "completed_no_repo_changes": {
-      "summary": "The requested review is complete and did not require repository changes."
+      "summary": "The requested review is complete and did not require repository changes.",
+      "user_note_candidate": null
     }
   }
 }