@xfey/tutti 0.1.110 → 0.1.112

package/dist/collaboration-state/clarification-snapshot.d.ts

@@ -0,0 +1,228 @@
+import type { ClarificationRoundRef } from "@tutti/shared/ids";
+import type { SqliteDatabase } from "../store/index.js";
+/** Round messages are append-only; the eligible answer count is a stable CAS revision. */
+export declare function readClarificationAnswerRevision(db: SqliteDatabase, roundId: ClarificationRoundRef): number;
+/** Read the immutable submitted refs, not a first page or messages appended after sealing. */
+export declare function readSubmittedClarificationMessages(db: SqliteDatabase, roundId: ClarificationRoundRef): {
+    clarification_card?: {
+        title?: string;
+        status: "writable" | "sealed";
+        round_id: string;
+        thread_id: string;
+        summary: string;
+        is_current_round: boolean;
+    };
+    refs?: {
+        task_id?: string;
+        activity_ref?: string;
+        artifact_feedback?: {
+            summary?: string;
+            kind: "artifact_feedback";
+            version: 1;
+            preview_generation: string;
+            annotations: {
+                document_url: string;
+                comment: string;
+                target: {
+                    fallback_context?: {
+                        snapshot: {
+                            role?: string;
+                            accessible_name?: string;
+                            text_excerpt?: string;
+                            state?: {
+                                expanded?: boolean;
+                                selected?: boolean;
+                                checked?: boolean;
+                                pressed?: boolean;
+                                disabled?: boolean;
+                            };
+                            tag_name: string;
+                            element_kind: "content" | "control" | "container";
+                            context: {
+                                role?: string;
+                                accessible_name?: string;
+                                tag_name: string;
+                            }[];
+                        };
+                        anchor: {
+                            explicit_anchor?: string;
+                            stable_attributes?: {
+                                id?: string;
+                                test_id?: string;
+                            };
+                            version: 1;
+                            semantic_path: {
+                                role?: string;
+                                accessible_name?: string;
+                            }[];
+                            selector_path: {
+                                root: "document" | "open_shadow_root";
+                                selector: string;
+                            }[];
+                        };
+                    };
+                    snapshot: {
+                        role?: string;
+                        accessible_name?: string;
+                        text_excerpt?: string;
+                        state?: {
+                            expanded?: boolean;
+                            selected?: boolean;
+                            checked?: boolean;
+                            pressed?: boolean;
+                            disabled?: boolean;
+                        };
+                        tag_name: string;
+                        element_kind: "content" | "control" | "container";
+                        context: {
+                            role?: string;
+                            accessible_name?: string;
+                            tag_name: string;
+                        }[];
+                    };
+                    anchor: {
+                        explicit_anchor?: string;
+                        stable_attributes?: {
+                            id?: string;
+                            test_id?: string;
+                        };
+                        version: 1;
+                        semantic_path: {
+                            role?: string;
+                            accessible_name?: string;
+                        }[];
+                        selector_path: {
+                            root: "document" | "open_shadow_root";
+                            selector: string;
+                        }[];
+                    };
+                };
+            }[];
+            artifact_title: string;
+            inspector_version: 1;
+        };
+        reference_file?: {
+            media_type?: string;
+            blob_oid?: string;
+            path: string;
+            name: string;
+            source: "human_upload" | "tutti_output";
+            category: "file" | "image";
+            size_bytes: number;
+            text_read: {
+                blocked_reason?: "unknown" | "binary" | "too_large" | "unsupported_encoding" | "restricted_path" | "secret_like";
+                can_read: boolean;
+            };
+        };
+        workflow_ref?: string;
+        clarification_round_ref?: string;
+        clarification_thread_ref?: string;
+        task_result?: {
+            error_code?: string;
+            activity_ref?: string;
+            generated_files?: {
+                media_type?: string;
+                group?: string;
+                path: string;
+                name: string;
+                size_bytes: number;
+            }[];
+            module_name?: string;
+            latest_run_result_id?: string;
+            retry_action?: "retryable" | "retried";
+            final_note?: string;
+            status: "completed" | "failed";
+            kind: "task_result";
+            task_id: string;
+            title: string;
+            summary: string;
+            task_title: string;
+            result_key: string;
+        };
+        worklist_compile?: {
+            kind: "worklist_compile";
+            title: string;
+            workflow_ref: string;
+            tasks: {
+                status: "failed" | "done" | "pending" | "todo" | "running";
+                task_id: string;
+                title: string;
+                summary: string;
+                module_id: string;
+                module_name: string;
+            }[];
+            task_count: number;
+        };
+        artifact_preview?: {
+            task_id?: string;
+            run_result_id?: string;
+            status: "available" | "updated";
+            kind: "artifact_preview";
+            title: string;
+        };
+        development_operator?: true;
+        external_reference_reads?: string[];
+        external_references?: {
+            name: string;
+            kind: "feishu_docx" | "feishu_drive_file" | "feishu_file" | "feishu_image";
+            created_at: string;
+            source_ref: string;
+        }[];
+        scratchpad_source?: "include" | "exclude";
+        worklist_feedback?: {
+            generated_files?: {
+                media_type?: string;
+                group?: string;
+                path: string;
+                name: string;
+                size_bytes: number;
+            }[];
+            final_note?: string;
+            primary_task_id?: string;
+            status: "completed" | "failed";
+            kind: "worklist_terminal";
+            items: {
+                module_name?: string;
+                latest_run_result_id?: string;
+                status: "failed" | "done";
+                task_id: string;
+                title: string;
+                summary: string;
+            }[];
+            title: string;
+            reason: "all_tasks_done" | "run_failed";
+            counters: {
+                completed: number;
+                failed: number;
+                remaining: number;
+            };
+            feedback_key: string;
+        };
+    };
+    scope: {
+        kind: "main_chat";
+    } | {
+        kind: "clarification_round";
+        clarification_round_ref: string;
+    };
+    id: string;
+    author: {
+        ref?: string;
+        display_name?: string;
+        avatar?: {
+            kind: "initials";
+            initials: string;
+            color: "neutral" | "green" | "blue" | "yellow";
+        } | {
+            kind: "image";
+            initials: string;
+            color: "neutral" | "green" | "blue" | "yellow";
+            image_url: string;
+        };
+        kind: "human" | "system" | "agent";
+    };
+    body: string;
+    created_at: string;
+    message_kind: "user_text" | "agent_text" | "system_notice" | "clarification_request" | "clarification_card";
+}[];
+//# sourceMappingURL=clarification-snapshot.d.ts.map

package/dist/collaboration-state/clarification-snapshot.js

@@ -0,0 +1,29 @@
+import { mapMessageRow } from "./messages.js";
+/** Round messages are append-only; the eligible answer count is a stable CAS revision. */
+export function readClarificationAnswerRevision(db, roundId) {
+    return db
+        .prepare(`
+    SELECT COUNT(*) AS count FROM messages
+    WHERE scope_kind = 'clarification_round' AND clarification_round_id = ?
+      AND message_kind = 'user_text'
+      AND (author_kind = 'human' OR
+        (author_kind = 'system' AND json_extract(refs_json, '$.development_operator') = 1))
+  `)
+        .get(roundId).count;
+}
+/** Read the immutable submitted refs, not a first page or messages appended after sealing. */
+export function readSubmittedClarificationMessages(db, roundId) {
+    return db
+        .prepare(`
+    SELECT messages.* FROM clarification_rounds AS rounds
+    JOIN json_each(rounds.submitted_message_refs_json) AS submitted
+    JOIN messages ON messages.id = submitted.value
+    WHERE rounds.id = ? AND rounds.status = 'sealed'
+      AND messages.scope_kind = 'clarification_round'
+      AND messages.clarification_round_id = rounds.id
+    ORDER BY CAST(submitted.key AS INTEGER)
+  `)
+        .all(roundId)
+        .map((row) => mapMessageRow(row));
+}
+//# sourceMappingURL=clarification-snapshot.js.map

package/dist/collaboration-state/clarification-successors.js

@@ -15,7 +15,7 @@ export function submitClarificationRound(db, input) {
             return;
         }
         if (row.status === "sealed") {
-            round = mapClarificationRoundRow(row);
+            round = mapClarificationRoundRow(row, db);
             return;
         }
         const messageRows = db
@@ -64,7 +64,7 @@ export function materializeClarificationSuccessor(db, input) {
             return;
         }
         if (row.successor_status === "materialized") {
-            round = mapClarificationRoundRow(row);
+            round = mapClarificationRoundRow(row, db);
             return;
         }
         db.prepare(`
@@ -120,7 +120,7 @@ export function materializeTaskBoundRunSuccessor(db, input) {
             result = {
                 kind: "already_materialized",
                 thread: mapClarificationThreadRow(thread),
-                round: mapClarificationRoundRow(row),
+                round: mapClarificationRoundRow(row, db),
                 task: readTaskProjection(db, thread.owner_task_id),
             };
             return;
@@ -182,7 +182,7 @@ export function materializeTaskBoundRunSuccessor(db, input) {
         result = {
             kind: "materialized",
             thread: mapClarificationThreadRow(updatedThread),
-            round: mapClarificationRoundRow(updatedRound),
+            round: mapClarificationRoundRow(updatedRound, db),
             task: updatedTask,
         };
     })();
@@ -210,7 +210,7 @@ export function closeTaskBoundClarificationAsRetaskingRequired(db, input) {
             return {
                 kind: "already_materialized",
                 thread: mapClarificationThreadRow(thread),
-                round: mapClarificationRoundRow(row),
+                round: mapClarificationRoundRow(row, db),
                 task: readTaskProjection(tx, taskId),
                 task_detail: readTaskDetailProjection(tx, taskId),
             };
@@ -308,7 +308,7 @@ export function closeTaskBoundClarificationAsRetaskingRequired(db, input) {
         return {
             kind: "closed",
             thread: mapClarificationThreadRow(updatedThread),
-            round: mapClarificationRoundRow(updatedRound),
+            round: mapClarificationRoundRow(updatedRound, db),
             task,
             task_detail: taskDetail,
             message,

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

@@ -1,4 +1,5 @@
 export { CollaborationStateCursorError } from "./serialization.js";
+export { readClarificationAnswerRevision, readSubmittedClarificationMessages, } from "./clarification-snapshot.js";
 export { createIdleExecutionStatusProjection } from "./execution-status.js";
 export { createMainChatAgentMessage, createMainChatMessage, createMainChatSystemMessage, ensureInitialProjectWelcomeMessage, hasMainChatArtifactPreviewMessage, hasMainChatTaskResultMessage, hasMainChatWorklistCompileMessage, hasMainChatWorklistFeedbackMessage, readCompletedWorklistFeedbackTaskIds, readMessageProjectionById, readMainChatMessageWindow, readMainChatMessagesBeforeCursor, readMainChatMessagesForScratchpadCycle, } from "./messages.js";
 export { createEmptyScratchpadProjection, readScratchpadReceiptSourceRefs, readScratchpadProjection, upsertScratchpadProjection, } from "./scratchpad.js";

package/dist/collaboration-state/index.js

@@ -1,4 +1,5 @@
 export { CollaborationStateCursorError } from "./serialization.js";
+export { readClarificationAnswerRevision, readSubmittedClarificationMessages, } from "./clarification-snapshot.js";
 export { createIdleExecutionStatusProjection } from "./execution-status.js";
 export { createMainChatAgentMessage, createMainChatMessage, createMainChatSystemMessage, ensureInitialProjectWelcomeMessage, hasMainChatArtifactPreviewMessage, hasMainChatTaskResultMessage, hasMainChatWorklistCompileMessage, hasMainChatWorklistFeedbackMessage, readCompletedWorklistFeedbackTaskIds, readMessageProjectionById, readMainChatMessageWindow, readMainChatMessagesBeforeCursor, readMainChatMessagesForScratchpadCycle, } from "./messages.js";
 export { createEmptyScratchpadProjection, readScratchpadReceiptSourceRefs, readScratchpadProjection, upsertScratchpadProjection, } from "./scratchpad.js";

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

@@ -227,7 +227,7 @@ export function recordRunNeedsHumanResult(db, input) {
             task: updatedTask,
             task_detail: taskDetail,
             thread: mapClarificationThreadRow(thread),
-            round: mapClarificationRoundRow(round),
+            round: mapClarificationRoundRow(round, db),
             card_message: mapMessageRow(cardMessage, tx),
             opening_message: mapMessageRow(openingMessage),
         };

package/dist/collaboration-state/task-compile-context.d.ts

@@ -15,8 +15,8 @@ export declare function completeTaskCompileContext(db: SqliteDatabase, input: Co
     updated_by_activity_ref?: string;
     submitted_by_activity_ref?: string;
     submitted_by_workflow_ref?: string;
-    id: "current";
     state: "ready" | "empty" | "submitted";
+    id: "current";
     topic: string;
     background_summary: string;
     current_consensus: string[];

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

@@ -279,6 +279,7 @@ export type CreateClarificationRoundMessageInput = {
     round_id: ClarificationRoundRef;
     body: string;
     author: MessageAuthorInput;
+    refs?: MessageProjection["refs"];
     now?: () => Date;
 };
 export type CreateClarificationRoundAgentMessageInput = {

package/dist/control-plane/clarification-commands.d.ts

@@ -2,13 +2,14 @@ import type { ClarificationRoundRef, IdempotencyKey } from "@tutti/shared/ids";
 import type { SendClarificationRoundMessageDisposition, SendClarificationRoundMessagePayload, SendClarificationRoundMessageResult, SubmitClarificationRoundDisposition, SubmitClarificationRoundPayload, SubmitClarificationRoundResult } from "@tutti/shared/schemas/api";
 import type { WorkspaceEventBus } from "../server-shell/http/workspace-events.js";
 import { type HostProjectStore } from "../store/index.js";
-import type { ControlPlaneCommandResult, TrustedHumanAuthor } from "./types.js";
+import type { ControlPlaneCommandResult } from "./types.js";
+import type { TrustedCollaborationAuthor } from "../collaboration-ingestion/types.js";
 export declare function runSendClarificationRoundMessage(options: {
     store: HostProjectStore;
     events: WorkspaceEventBus;
     roundId: ClarificationRoundRef;
     payload: SendClarificationRoundMessagePayload;
-    author: TrustedHumanAuthor;
+    author: TrustedCollaborationAuthor;
     now: () => Date;
 }): ControlPlaneCommandResult<SendClarificationRoundMessageDisposition, SendClarificationRoundMessageResult>;
 export declare function runSubmitClarificationRound(options: {

package/dist/control-plane/clarification-commands.js

@@ -1,4 +1,4 @@
-import { createClarificationRoundMessage, readActiveClarificationProjection, submitClarificationRound, } from "../collaboration-state/index.js";
+import { createClarificationRoundMessage, readActiveClarificationProjection, readClarificationAnswerRevision, submitClarificationRound, } from "../collaboration-state/index.js";
 import { withHostStoreTransaction } from "../store/index.js";
 import { enqueueControlPlaneIntent } from "./dispatch-intents.js";
 import { clarificationInvalidates } from "./invalidations.js";
@@ -19,11 +19,14 @@ export function runSendClarificationRoundMessage(options) {
         round_id: options.roundId,
         body: options.payload.body,
         author: {
-            kind: "human",
+            kind: options.author.kind === "development_operator" ? "system" : "human",
             ref: options.author.account_ref,
             display_name: options.author.display_name,
             ...(options.author.avatar === undefined ? {} : { avatar: options.author.avatar }),
         },
+        ...(options.author.kind === "development_operator"
+            ? { refs: { development_operator: true } }
+            : {}),
         now: options.now,
     });
     options.events.publish({
@@ -41,12 +44,11 @@ export function runSendClarificationRoundMessage(options) {
         invalidates: clarificationInvalidates(options.roundId, active.thread.id),
     });
     return {
-        disposition: { kind: "created" },
+        disposition: { kind: "created", message_id: message.id },
         result: { message },
     };
 }
 export function runSubmitClarificationRound(options) {
-    void options.payload;
     const active = readActiveClarificationProjection(options.store.db);
     if (active.state === "none") {
         return { disposition: { kind: "chain_closed" } };
@@ -71,6 +73,13 @@ export function runSubmitClarificationRound(options) {
             result: { round: active.round },
         };
     }
+    const answerRevision = readClarificationAnswerRevision(options.store.db, options.roundId);
+    if (options.payload.expected_answer_revision !== undefined &&
+        options.payload.expected_answer_revision !== answerRevision) {
+        return { disposition: { kind: "answers_changed", current_answer_revision: answerRevision } };
+    }
+    if (answerRevision === 0)
+        return { disposition: { kind: "no_answers" } };
     const sealed = withHostStoreTransaction(options.store.db, (tx) => {
         const submitted = submitClarificationRound(tx, {
             round_id: options.roundId,

package/dist/control-plane/follow-up-context.js

@@ -1,12 +1,10 @@
-import { readClarificationRoundMessagesWindow, readClarificationRoundProjection, readClarificationRoundsForThread, readTaskDetailProjection, readTaskRunResultsPage, } from "../collaboration-state/index.js";
+import { clarificationAnswerRole } from "@tutti/shared/utils";
+import { readSubmittedClarificationMessages, readClarificationRoundProjection, readClarificationRoundsForThread, readTaskDetailProjection, readTaskRunResultsPage, } from "../collaboration-state/index.js";
 import { toDomainRunLineage } from "./run-lineage.js";
 const CONTINUATION_CLARIFICATION_MESSAGE_LIMIT = 200;
 export function readFollowUpCheckInputFromStore(input) {
     const taskDetail = readTaskDetailProjection(input.db, input.task_id);
     const round = readClarificationRoundProjection(input.db, input.round_id);
-    const messagesWindow = readClarificationRoundMessagesWindow(input.db, input.round_id, {
-        anchor: "start",
-    });
     const latestRunResult = readTaskRunResultsPage(input.db, input.task_id, {
         limit: 1,
     })?.items[0];
@@ -29,7 +27,7 @@ export function readFollowUpCheckInputFromStore(input) {
             clarification_round_ref: input.round_id,
             clarification_request_payload: round.request_payload,
             submitted_message_refs: (round.submitted_message_refs ?? []),
-            round_messages: messagesWindow?.items ?? [],
+            round_messages: readSubmittedClarificationMessages(input.db, input.round_id),
             latest_run_result: latestRunResult,
             run_lineage: toDomainRunLineage(latestRunResult.run_lineage),
         },
@@ -51,18 +49,14 @@ export function readRunContinuationContextFromStore(input) {
     }
     let messagesTruncated = false;
     const resolvedRounds = rounds.map((round) => {
-        const messagesWindow = readClarificationRoundMessagesWindow(input.db, round.id, { anchor: "start", limit: CONTINUATION_CLARIFICATION_MESSAGE_LIMIT });
-        if (messagesWindow === null ||
-            messagesWindow.window.has_older ||
-            messagesWindow.window.has_newer) {
+        const submitted = readSubmittedClarificationMessages(input.db, round.id).filter((message) => clarificationAnswerRole(message) !== null);
+        if (submitted.length > CONTINUATION_CLARIFICATION_MESSAGE_LIMIT)
             messagesTruncated = true;
-        }
-        const submittedMessageRefs = new Set((round.submitted_message_refs ?? []));
-        const answerMessages = (messagesWindow?.items ?? [])
-            .filter((message) => message.author.kind === "human")
-            .filter((message) => submittedMessageRefs.size === 0 || submittedMessageRefs.has(message.id))
+        const answerMessages = submitted
+            .slice(0, CONTINUATION_CLARIFICATION_MESSAGE_LIMIT)
             .map((message) => ({
             author: message.author,
+            role: clarificationAnswerRole(message),
             text: message.body,
             created_at: message.created_at,
         }));

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

@@ -1,7 +1,8 @@
 import { type ActivityRef, type ClarificationRoundRef, type IdempotencyKey, type TaskId, type WorkflowInvocationRef } from "@tutti/shared/ids";
+import type { TrustedCollaborationAuthor } from "../collaboration-ingestion/types.js";
 import type { ExecutionStatusProjection, MessageProjection, ContextSyncDisposition, ContextSyncResult, RefreshScratchpadDisposition, RefreshScratchpadResult, RunSchedulerNowDisposition, RunSchedulerNowPayload, RetryTaskDisposition, RetryTaskPayload, RefreshReferenceSummariesDisposition, RefreshReferenceSummariesPayload, RefreshReferenceSummariesResult, SendClarificationRoundMessageDisposition, SendClarificationRoundMessagePayload, SendClarificationRoundMessageResult, SubmitClarificationRoundDisposition, SubmitClarificationRoundPayload, SubmitClarificationRoundResult, SubmitWorklistDisposition, SubmitWorklistPayload, SubmitWorklistResult, ProcedureLane } from "@tutti/shared/schemas/api";
 import type { ContextSyncWorkflowTrigger } from "./workflows/index.js";
-import type { ControlPlaneCommandResult, Phase5ControlPlaneOptions, StartupRecoveryOptions, StartupRecoveryResult, TrustedHumanAuthor } from "./types.js";
+import type { ControlPlaneCommandResult, Phase5ControlPlaneOptions, StartupRecoveryOptions, StartupRecoveryResult } from "./types.js";
 import { type ProjectBriefRefreshReason, type RefreshProjectBriefProjectionResult } from "./project-brief-refresh.js";
 export type { ControlPlaneCommandResult, ControlPlaneLogger, Phase5ControlPlaneOptions, RunCorrectionContext, RunContinuationContext, RunDispatchContext, RunDispatchTrigger, RunPipelineInput, RunPipelineResolution, RunPipelineResolver, RunPipelineResult, RunPipelineRunner, StartupRecoveryOptions, StartupRecoveryResult, TrustedHumanAuthor, } from "./types.js";
 export declare class Phase5ControlPlane {
@@ -50,7 +51,7 @@ export declare class Phase5ControlPlane {
     startContextSyncAnalysis(trigger?: ContextSyncWorkflowTrigger): ControlPlaneCommandResult<ContextSyncDisposition, ContextSyncResult>;
     startReferenceSummaryRefresh(payload?: RefreshReferenceSummariesPayload): ControlPlaneCommandResult<RefreshReferenceSummariesDisposition, RefreshReferenceSummariesResult>;
     private tryStartPendingReferenceSummaryRefresh;
-    sendClarificationRoundMessage(roundId: ClarificationRoundRef, payload: SendClarificationRoundMessagePayload, author: TrustedHumanAuthor): ControlPlaneCommandResult<SendClarificationRoundMessageDisposition, SendClarificationRoundMessageResult>;
+    sendClarificationRoundMessage(roundId: ClarificationRoundRef, payload: SendClarificationRoundMessagePayload, author: TrustedCollaborationAuthor): ControlPlaneCommandResult<SendClarificationRoundMessageDisposition, SendClarificationRoundMessageResult>;
     submitClarificationRound(roundId: ClarificationRoundRef, payload: SubmitClarificationRoundPayload, commandId: IdempotencyKey): ControlPlaneCommandResult<SubmitClarificationRoundDisposition, SubmitClarificationRoundResult>;
     waitForIdle(): Promise<void>;
     private trackAsyncOwner;

package/dist/control-plane/scratchpad-source-messages.js

@@ -19,7 +19,9 @@ export function shouldUseMessageAsScratchpadSource(message) {
     if (message.scope.kind !== "main_chat") {
         return false;
     }
-    if (message.message_kind === "user_text" && message.author.kind === "human") {
+    if (message.message_kind === "user_text" &&
+        (message.author.kind === "human" ||
+            (message.author.kind === "system" && message.refs?.development_operator === true))) {
         return true;
     }
     if (message.message_kind === "agent_text" && message.author.kind === "agent") {
@@ -31,7 +33,11 @@ export function filterScratchpadSourceMessages(messages) {
     return messages.filter(shouldUseMessageAsScratchpadSource);
 }
 function compactRole(message) {
-    return message.author.kind === "agent" ? "tutti" : "human";
+    return message.refs?.development_operator === true
+        ? "operator"
+        : message.author.kind === "agent"
+            ? "tutti"
+            : "human";
 }
 export function truncateTextMiddle(text, maxChars) {
     const trimmed = text.trim();
@@ -54,7 +60,7 @@ function sourceText(message) {
     return `Reference file (${reference.category}:${reference.name})\n${message.body}`;
 }
 function sourceAuthorDisplayName(message) {
-    if (message.author.kind !== "human") {
+    if (message.author.kind !== "human" && message.refs?.development_operator !== true) {
         return undefined;
     }
     const displayName = message.author.display_name?.trim();

package/dist/control-plane/task-compile-clarification-context.js

@@ -1,3 +1,4 @@
+import { clarificationAnswerRole } from "@tutti/shared/utils";
 import { readActiveClarificationProjection, readClarificationRoundProjection, readClarificationRoundsForThread, readMessageProjectionById, readTaskCompileClarificationRoundsByWorkflowRef, } from "../collaboration-state/index.js";
 function answerMessage(store, messageId, roundId) {
     const message = readMessageProjectionById(store.db, messageId);
@@ -7,11 +8,15 @@ function answerMessage(store, messageId, roundId) {
         (message.message_kind !== "user_text" && message.message_kind !== "agent_text")) {
         return null;
     }
-    const role = message.author.kind === "agent" ? "tutti" : "human";
+    const role = message.author.kind === "agent" && message.message_kind === "agent_text"
+        ? "tutti"
+        : clarificationAnswerRole(message);
+    if (role === null)
+        return null;
     const displayName = message.author.display_name?.trim();
     return {
         role,
-        ...(role === "human" && displayName !== undefined && displayName !== ""
+        ...(role !== "tutti" && displayName !== undefined && displayName !== ""
             ? { author_display_name: displayName }
             : {}),
         text: message.body,

package/dist/control-plane/task-source-context-types.d.ts

@@ -1,6 +1,6 @@
 import type { ClarificationRequestPayload, ExternalReferenceDescriptor } from "@tutti/shared/schemas/api";
 export type PromptSourceMessage = {
-    role: "human" | "tutti";
+    role: "human" | "tutti" | "operator";
     author_display_name?: string;
     text: string;
     external_references?: ExternalReferenceDescriptor[];

package/dist/control-plane/task-source-context.js

@@ -8,10 +8,12 @@ function promptSourceMessage(db, source) {
     if (message.scope.kind !== "main_chat") {
         throw new Error("Task source message is outside main chat");
     }
-    if (message.message_kind === "user_text" && message.author.kind === "human") {
+    if (message.message_kind === "user_text" &&
+        (message.author.kind === "human" ||
+            (message.author.kind === "system" && message.refs?.development_operator === true))) {
         const displayName = message.author.display_name?.trim();
         return {
-            role: "human",
+            role: message.refs?.development_operator === true ? "operator" : "human",
             ...(displayName === undefined || displayName === ""
                 ? {}
                 : { author_display_name: displayName }),

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

@@ -75,6 +75,7 @@ export type RunContinuationContext = {
             request_payload: ClarificationRequestPayload;
             answer_messages: Array<{
                 author: MessageProjection["author"];
+                role?: "human" | "operator";
                 text: string;
                 created_at: string;
             }>;

package/dist/control-plane/workflows/openai.js

@@ -2,6 +2,7 @@ import { copyFileSync, mkdtempSync } from "node:fs";
 import { rm } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { extname, isAbsolute, join, relative, resolve } from "node:path";
+import { clarificationAnswerRole } from "@tutti/shared/utils";
 import { renderPromptTemplate } from "../../prompt-templates/index.js";
 import { createOpenAiStructuredOutputClient, runOpenAiStructuredOutput, } from "../../providers/openai/sdk-procedure-runner.js";
 import { readOpenAiApiKeyCredential } from "../../providers/openai/credential-store.js";
@@ -162,10 +163,10 @@ function referenceFileSummaryWorkflowOutput(output, originalPath) {
 function followUpCheckPromptInput(input) {
     const submittedMessageRefs = new Set(input.submitted_message_refs);
     const answers = input.round_messages
-        .filter((message) => message.author.kind === "human")
-        .filter((message) => submittedMessageRefs.size === 0 || submittedMessageRefs.has(message.id))
-        .map((message) => message.body.trim())
-        .filter((text) => text.length > 0);
+        .filter((message) => clarificationAnswerRole(message) !== null)
+        .filter((message) => submittedMessageRefs.has(message.id))
+        .filter((message) => message.body.trim().length > 0)
+        .map((message) => ({ role: clarificationAnswerRole(message), text: message.body.trim() }));
     return {
         title: input.task_detail.task.title,
         goal: input.task_detail.detail.contract.goal,