@xfey/tutti 0.1.17 → 0.1.19

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/node_modules/ws/lib/receiver.js

@@ -40,6 +40,10 @@ class Receiver extends Writable {
    *     extensions
    * @param {Boolean} [options.isServer=false] Specifies whether to operate in
    *     client or server mode
+   * @param {Number} [options.maxBufferedChunks=0] The maximum number of
+   *     buffered data chunks
+   * @param {Number} [options.maxFragments=0] The maximum number of message
+   *     fragments
    * @param {Number} [options.maxPayload=0] The maximum allowed message length
    * @param {Boolean} [options.skipUTF8Validation=false] Specifies whether or
    *     not to skip UTF-8 validation for text and close messages
@@ -54,6 +58,8 @@ class Receiver extends Writable {
     this._binaryType = options.binaryType || BINARY_TYPES[0];
     this._extensions = options.extensions || {};
     this._isServer = !!options.isServer;
+    this._maxBufferedChunks = options.maxBufferedChunks | 0;
+    this._maxFragments = options.maxFragments | 0;
     this._maxPayload = options.maxPayload | 0;
     this._skipUTF8Validation = !!options.skipUTF8Validation;
     this[kWebSocket] = undefined;
@@ -89,6 +95,22 @@ class Receiver extends Writable {
   _write(chunk, encoding, cb) {
     if (this._opcode === 0x08 && this._state == GET_INFO) return cb();
 
+    if (
+      this._maxBufferedChunks > 0 &&
+      this._buffers.length >= this._maxBufferedChunks
+    ) {
+      cb(
+        this.createError(
+          RangeError,
+          'Too many buffered chunks',
+          false,
+          1008,
+          'WS_ERR_TOO_MANY_BUFFERED_PARTS'
+        )
+      );
+      return;
+    }
+
     this._bufferedBytes += chunk.length;
     this._buffers.push(chunk);
     this.startLoop(cb);
@@ -485,6 +507,22 @@ class Receiver extends Writable {
     }
 
     if (data.length) {
+      if (
+        this._maxFragments > 0 &&
+        this._fragments.length >= this._maxFragments
+      ) {
+        const error = this.createError(
+          RangeError,
+          'Too many message fragments',
+          false,
+          1008,
+          'WS_ERR_TOO_MANY_BUFFERED_PARTS'
+        );
+
+        cb(error);
+        return;
+      }
+
       //
       // This message is not compressed so its length is the sum of the payload
       // length of all fragments.
@@ -524,6 +562,22 @@ class Receiver extends Writable {
           return;
         }
 
+        if (
+          this._maxFragments > 0 &&
+          this._fragments.length >= this._maxFragments
+        ) {
+          const error = this.createError(
+            RangeError,
+            'Too many message fragments',
+            false,
+            1008,
+            'WS_ERR_TOO_MANY_BUFFERED_PARTS'
+          );
+
+          cb(error);
+          return;
+        }
+
         this._fragments.push(buf);
       }
 

package/node_modules/ws/lib/sender.js

@@ -4,6 +4,9 @@
 
 const { Duplex } = require('stream');
 const { randomFillSync } = require('crypto');
+const {
+  types: { isUint8Array }
+} = require('util');
 
 const PerMessageDeflate = require('./permessage-deflate');
 const { EMPTY_BUFFER, kWebSocket, NOOP } = require('./constants');
@@ -200,8 +203,10 @@ class Sender {
 
       if (typeof data === 'string') {
         buf.write(data, 2);
-      } else {
+      } else if (isUint8Array(data)) {
         buf.set(data, 2);
+      } else {
+        throw new TypeError('Second argument must be a string or a Uint8Array');
       }
     }
 

package/node_modules/ws/lib/websocket-server.js

@@ -43,6 +43,10 @@ class WebSocketServer extends EventEmitter {
    *     called
    * @param {Function} [options.handleProtocols] A hook to handle protocols
    * @param {String} [options.host] The hostname where to bind the server
+   * @param {Number} [options.maxBufferedChunks=1048576] The maximum number of
+   *     buffered data chunks
+   * @param {Number} [options.maxFragments=131072] The maximum number of message
+   *     fragments
    * @param {Number} [options.maxPayload=104857600] The maximum allowed message
    *     size
    * @param {Boolean} [options.noServer=false] Enable no server mode
@@ -65,6 +69,8 @@ class WebSocketServer extends EventEmitter {
     options = {
       allowSynchronousEvents: true,
       autoPong: true,
+      maxBufferedChunks: 1024 * 1024,
+      maxFragments: 128 * 1024,
       maxPayload: 100 * 1024 * 1024,
       skipUTF8Validation: false,
       perMessageDeflate: false,
@@ -424,6 +430,8 @@ class WebSocketServer extends EventEmitter {
 
     ws.setSocket(socket, head, {
       allowSynchronousEvents: this.options.allowSynchronousEvents,
+      maxBufferedChunks: this.options.maxBufferedChunks,
+      maxFragments: this.options.maxFragments,
       maxPayload: this.options.maxPayload,
       skipUTF8Validation: this.options.skipUTF8Validation
     });

package/node_modules/ws/lib/websocket.js

@@ -201,6 +201,10 @@ class WebSocket extends EventEmitter {
    *     multiple times in the same tick
    * @param {Function} [options.generateMask] The function used to generate the
    *     masking key
+   * @param {Number} [options.maxBufferedChunks=0] The maximum number of
+   *     buffered data chunks
+   * @param {Number} [options.maxFragments=0] The maximum number of message
+   *     fragments
    * @param {Number} [options.maxPayload=0] The maximum allowed message size
    * @param {Boolean} [options.skipUTF8Validation=false] Specifies whether or
    *     not to skip UTF-8 validation for text and close messages
@@ -212,6 +216,8 @@ class WebSocket extends EventEmitter {
       binaryType: this.binaryType,
       extensions: this._extensions,
       isServer: this._isServer,
+      maxBufferedChunks: options.maxBufferedChunks,
+      maxFragments: options.maxFragments,
       maxPayload: options.maxPayload,
       skipUTF8Validation: options.skipUTF8Validation
     });
@@ -640,6 +646,10 @@ module.exports = WebSocket;
  *     masking key
  * @param {Number} [options.handshakeTimeout] Timeout in milliseconds for the
  *     handshake request
+ * @param {Number} [options.maxBufferedChunks=1048576] The maximum number of
+ *     buffered data chunks
+ * @param {Number} [options.maxFragments=131072] The maximum number of message
+ *     fragments
  * @param {Number} [options.maxPayload=104857600] The maximum allowed message
  *     size
  * @param {Number} [options.maxRedirects=10] The maximum number of redirects
@@ -660,6 +670,8 @@ function initAsClient(websocket, address, protocols, options) {
     autoPong: true,
     closeTimeout: CLOSE_TIMEOUT,
     protocolVersion: protocolVersions[1],
+    maxBufferedChunks: 1024 * 1024,
+    maxFragments: 128 * 1024,
     maxPayload: 100 * 1024 * 1024,
     skipUTF8Validation: false,
     perMessageDeflate: true,
@@ -1017,6 +1029,8 @@ function initAsClient(websocket, address, protocols, options) {
     websocket.setSocket(socket, head, {
       allowSynchronousEvents: opts.allowSynchronousEvents,
       generateMask: opts.generateMask,
+      maxBufferedChunks: opts.maxBufferedChunks,
+      maxFragments: opts.maxFragments,
       maxPayload: opts.maxPayload,
       skipUTF8Validation: opts.skipUTF8Validation
     });

package/node_modules/ws/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ws",
-  "version": "8.20.0",
+  "version": "8.21.0",
   "description": "Simple to use, blazing fast and thoroughly tested websocket client and server for Node.js",
   "keywords": [
     "HyBi",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xfey/tutti",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -39,7 +39,7 @@
     "qrcode-terminal": "^0.12.0",
     "sharp": "^0.35.3",
     "ulid": "^3.0.2",
-    "ws": "^8.20.0",
+    "ws": "^8.21.0",
     "yauzl": "^3.3.2"
   },
   "bundledDependencies": [

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.