@xfey/tutti 0.1.21 → 0.1.22

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

@@ -1,7 +1,7 @@
 export { CollaborationStateCursorError } from "./serialization.js";
 export { createIdleExecutionStatusProjection } from "./execution-status.js";
 export { createMainChatAgentMessage, createMainChatMessage, createMainChatSystemMessage, hasMainChatWorklistFeedbackMessage, readCompletedWorklistFeedbackTaskIds, readMessageProjectionById, readMainChatMessageWindow, readMainChatMessagesAfter, readMainChatMessagesAfterCursor, readMainChatMessagesBeforeCursor, } from "./messages.js";
-export { createEmptyScratchpadProjection, readScratchpadProjection, submitScratchpadProjection, upsertScratchpadProjection, } from "./scratchpad.js";
+export { createEmptyScratchpadProjection, readScratchpadReceiptSourceRefs, readScratchpadProjection, submitScratchpadProjection, upsertScratchpadProjection, } from "./scratchpad.js";
 export { advanceScratchpadTaskCompileSourceCursor, markScratchpadRefreshFailed, markScratchpadRefreshStarted, markScratchpadRefreshSucceeded, markScratchpadSourceDirty, readScratchpadSourceState, } from "./scratchpad-source-state.js";
 export { deleteStaleClarificationSubmitReplayHints, readActiveClarificationProjection, readClarificationRoundProjection, readClarificationRoundsForThread, readClarificationThreadResponse, readSealedClarificationRoundsWithoutSuccessor, readSubmittedTaskCompileClarificationRounds, readSubmittedTaskCompileClarificationRoundsAfterCursor, } from "./clarification-records.js";
 export { createClarificationRoundAgentMessage, createClarificationRoundMessage, readClarificationRoundMessagesWindow, } from "./clarification-messages.js";

package/dist/collaboration-state/index.js

@@ -1,7 +1,7 @@
 export { CollaborationStateCursorError } from "./serialization.js";
 export { createIdleExecutionStatusProjection } from "./execution-status.js";
 export { createMainChatAgentMessage, createMainChatMessage, createMainChatSystemMessage, hasMainChatWorklistFeedbackMessage, readCompletedWorklistFeedbackTaskIds, readMessageProjectionById, readMainChatMessageWindow, readMainChatMessagesAfter, readMainChatMessagesAfterCursor, readMainChatMessagesBeforeCursor, } from "./messages.js";
-export { createEmptyScratchpadProjection, readScratchpadProjection, submitScratchpadProjection, upsertScratchpadProjection, } from "./scratchpad.js";
+export { createEmptyScratchpadProjection, readScratchpadReceiptSourceRefs, readScratchpadProjection, submitScratchpadProjection, upsertScratchpadProjection, } from "./scratchpad.js";
 export { advanceScratchpadTaskCompileSourceCursor, markScratchpadRefreshFailed, markScratchpadRefreshStarted, markScratchpadRefreshSucceeded, markScratchpadSourceDirty, readScratchpadSourceState, } from "./scratchpad-source-state.js";
 export { deleteStaleClarificationSubmitReplayHints, readActiveClarificationProjection, readClarificationRoundProjection, readClarificationRoundsForThread, readClarificationThreadResponse, readSealedClarificationRoundsWithoutSuccessor, readSubmittedTaskCompileClarificationRounds, readSubmittedTaskCompileClarificationRoundsAfterCursor, } from "./clarification-records.js";
 export { createClarificationRoundAgentMessage, createClarificationRoundMessage, readClarificationRoundMessagesWindow, } from "./clarification-messages.js";

package/dist/collaboration-state/messages.js

@@ -245,10 +245,59 @@ export function readMainChatMessageWindow(db, options = {}) {
     if (before !== null && after !== null) {
         throw new Error("before and after cursors cannot be used together");
     }
+    if (options.around !== undefined && (before !== null || after !== null)) {
+        throw new Error("around cannot be used with before or after cursors");
+    }
     let rows;
     let hasOlder = false;
     let hasNewer = false;
-    if (before !== null) {
+    if (options.around !== undefined) {
+        const target = db
+            .prepare(`
+          SELECT *
+          FROM messages
+          WHERE scope_kind = 'main_chat'
+            AND id = ?
+        `)
+            .get(options.around);
+        if (target === undefined) {
+            rows = [];
+        }
+        else {
+            const beforeLimit = Math.floor((limit - 1) / 2);
+            const afterLimit = Math.max(0, limit - beforeLimit - 1);
+            const olderRows = db
+                .prepare(`
+            SELECT *
+            FROM messages
+            WHERE scope_kind = 'main_chat'
+              AND (
+                created_at < ?
+                OR (created_at = ? AND id < ?)
+              )
+            ORDER BY created_at DESC, id DESC
+            LIMIT ?
+          `)
+                .all(target.created_at, target.created_at, target.id, beforeLimit + 1);
+            const newerRows = db
+                .prepare(`
+            SELECT *
+            FROM messages
+            WHERE scope_kind = 'main_chat'
+              AND (
+                created_at > ?
+                OR (created_at = ? AND id > ?)
+              )
+            ORDER BY created_at ASC, id ASC
+            LIMIT ?
+          `)
+                .all(target.created_at, target.created_at, target.id, afterLimit + 1);
+            hasOlder = olderRows.length > beforeLimit;
+            hasNewer = newerRows.length > afterLimit;
+            rows = [...olderRows.slice(0, beforeLimit).reverse(), target, ...newerRows.slice(0, afterLimit)];
+        }
+    }
+    else if (before !== null) {
         rows = db
             .prepare(`
           SELECT *

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

@@ -1,8 +1,10 @@
 import type { ScratchpadProjection } from "@tutti/shared/schemas/api";
 import type { SqliteDatabase } from "../store/index.js";
+import type { ScratchpadSourceRefRow } from "./storage-types.js";
 import type { ScratchpadSnapshotInput, SubmitScratchpadInput } from "./types.js";
 export declare function createEmptyScratchpadProjection(): ScratchpadProjection;
 export declare function upsertScratchpadProjection(db: SqliteDatabase, input: ScratchpadSnapshotInput): ScratchpadProjection;
 export declare function submitScratchpadProjection(db: SqliteDatabase, input: SubmitScratchpadInput): ScratchpadProjection;
 export declare function readScratchpadProjection(db: SqliteDatabase): ScratchpadProjection;
+export declare function readScratchpadReceiptSourceRefs(db: SqliteDatabase, workflowRef: string): ScratchpadSourceRefRow[];
 //# sourceMappingURL=scratchpad.d.ts.map

package/dist/collaboration-state/scratchpad.js

@@ -1,5 +1,56 @@
 import { nowIso, parseJson, stringifyJson } from "./serialization.js";
 const SCRATCHPAD_RECEIPT_LIMIT = 100;
+function normalizeSourceRefs(sourceRefs = []) {
+    const byMessageId = new Map();
+    for (const sourceRef of sourceRefs) {
+        if (sourceRef.message_id.trim() === "" || sourceRef.created_at.trim() === "") {
+            continue;
+        }
+        byMessageId.set(sourceRef.message_id, sourceRef);
+    }
+    return [...byMessageId.values()].sort((left, right) => {
+        const timeOrder = left.created_at.localeCompare(right.created_at);
+        return timeOrder === 0 ? left.message_id.localeCompare(right.message_id) : timeOrder;
+    });
+}
+function replaceCurrentScratchpadSourceRefs(db, sourceRefs) {
+    db.prepare("DELETE FROM scratchpad_source_refs WHERE scratchpad_id = 'current'").run();
+    const normalized = normalizeSourceRefs(sourceRefs);
+    if (normalized.length === 0) {
+        return;
+    }
+    const insert = db.prepare(`
+      INSERT INTO scratchpad_source_refs (
+        scratchpad_id,
+        message_id,
+        source_scope,
+        created_at
+      )
+      VALUES ('current', ?, ?, ?)
+    `);
+    for (const sourceRef of normalized) {
+        insert.run(sourceRef.message_id, sourceRef.source_scope, sourceRef.created_at);
+    }
+}
+function copyCurrentScratchpadSourcesToReceipt(db, workflowRef) {
+    db.prepare("DELETE FROM scratchpad_receipt_sources WHERE workflow_ref = ?").run(workflowRef);
+    db.prepare(`
+      INSERT INTO scratchpad_receipt_sources (
+        workflow_ref,
+        message_id,
+        source_scope,
+        created_at
+      )
+      SELECT
+        ?,
+        message_id,
+        source_scope,
+        created_at
+      FROM scratchpad_source_refs
+      WHERE scratchpad_id = 'current'
+      ORDER BY created_at ASC, message_id ASC
+    `).run(workflowRef);
+}
 export function createEmptyScratchpadProjection() {
     return {
         id: "current",
@@ -76,6 +127,7 @@ export function upsertScratchpadProjection(db, input) {
         submitted_by_workflow_ref = NULL,
         submitted_at = NULL
     `).run(input.topic, input.background_summary, stringifyJson(input.current_consensus), stringifyJson(input.open_questions), stringifyJson(input.task_changes), input.updated_by_activity_ref ?? null, updatedAt);
+    replaceCurrentScratchpadSourceRefs(db, input.source_refs);
     return readScratchpadProjection(db);
 }
 export function submitScratchpadProjection(db, input) {
@@ -105,6 +157,7 @@ export function submitScratchpadProjection(db, input) {
         task_changes_json = excluded.task_changes_json,
         submitted_at = excluded.submitted_at
     `).run(input.workflow_ref, input.activity_ref, scratchpad.topic, scratchpad.background_summary, stringifyJson(scratchpad.current_consensus), stringifyJson(scratchpad.open_questions), stringifyJson(scratchpad.task_changes), submittedAt);
+    copyCurrentScratchpadSourcesToReceipt(db, input.workflow_ref);
     db.prepare(`
       UPDATE scratchpad
       SET
@@ -168,4 +221,14 @@ export function readScratchpadProjection(db) {
     }
     return scratchpad;
 }
+export function readScratchpadReceiptSourceRefs(db, workflowRef) {
+    return db
+        .prepare(`
+        SELECT message_id, source_scope, created_at
+        FROM scratchpad_receipt_sources
+        WHERE workflow_ref = ?
+        ORDER BY created_at ASC, message_id ASC
+      `)
+        .all(workflowRef);
+}
 //# sourceMappingURL=scratchpad.js.map

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

@@ -35,6 +35,11 @@ export type ScratchpadReceiptRow = {
     task_changes_json: string;
     submitted_at: string;
 };
+export type ScratchpadSourceRefRow = {
+    message_id: MessageId;
+    source_scope: "main_chat" | "clarification_round";
+    created_at: string;
+};
 export type ScratchpadSourceStateRow = {
     main_chat_cursor_created_at: string | null;
     main_chat_cursor_message_id: string | null;

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

@@ -1,6 +1,6 @@
 import type { RunLineage } from "@tutti/shared/domain";
 import type { AccountAvatarProjection } from "@tutti/shared/domain";
-import type { ActivityRef, ClarificationRoundRef, TaskId, TaskModuleId, WorkflowInvocationRef } from "@tutti/shared/ids";
+import type { ActivityRef, ClarificationRoundRef, MessageId, TaskId, TaskModuleId, WorkflowInvocationRef } from "@tutti/shared/ids";
 import type { ClarificationRequestPayload, ClarificationRoundProjection, ClarificationSuccessorRef, ClarificationThreadProjection, MessageProjection, ReadStateScope, ReadStateSummaryProjection, RecoverySummaryProjection, RunResultProjection, ScratchpadProjection, TaskContractProjection, TaskDetailProjection, TaskDetailResultProjection, TaskProjection, WorklistProjection } from "@tutti/shared/schemas/api";
 export type MessageAuthorInput = {
     kind: "human" | "system" | "agent";
@@ -53,9 +53,15 @@ export type ScratchpadSnapshotInput = {
     current_consensus: string[];
     open_questions: string[];
     task_changes: string[];
+    source_refs?: ScratchpadSourceRefInput[];
     updated_by_activity_ref?: ActivityRef;
     now?: () => Date;
 };
+export type ScratchpadSourceRefInput = {
+    message_id: MessageId;
+    source_scope: "main_chat" | "clarification_round";
+    created_at: string;
+};
 export type SubmitScratchpadInput = {
     workflow_ref: WorkflowInvocationRef;
     activity_ref: ActivityRef;
@@ -286,6 +292,7 @@ export type ReadMessageWindowOptions = {
     anchor?: "latest" | "start";
     before?: string;
     after?: string;
+    around?: string;
 };
 export type ReadMainChatMessagesAfterOptions = {
     after_created_at: string;

package/dist/control-plane/scratchpad-refresh-start.d.ts

@@ -1,6 +1,7 @@
 import { createWorkflowInvocationRef, type ActivityRef } from "@tutti/shared/ids";
 import type { RefreshScratchpadDisposition, RefreshScratchpadResult, ProcedureLane } from "@tutti/shared/schemas/api";
 import type { ScratchpadSourceCursorUpdate } from "../collaboration-state/scratchpad-source-state.js";
+import type { ScratchpadSourceRefInput } from "../collaboration-state/types.js";
 import type { ProcedureEngine, ProcedureEngineState } from "../procedure-engine/index.js";
 import type { HostProjectStore } from "../store/index.js";
 import type { WorkspaceEventBus } from "../server-shell/http/workspace-events.js";
@@ -12,6 +13,7 @@ type ScratchpadProjectContext = {
 export type ScratchpadSourceBatch = {
     workflow_input: Parameters<ProcedureWorkflowRunner["runScratchpadRefresh"]>[0];
     cursor_update: ScratchpadSourceCursorUpdate;
+    source_refs: ScratchpadSourceRefInput[];
     source_message_count: number;
 };
 export declare function readControlPlaneScratchpadSourceBatch(store: HostProjectStore, options?: {

package/dist/control-plane/scratchpad-refresh-start.js

@@ -96,6 +96,10 @@ export function readControlPlaneScratchpadSourceBatch(store, options = {}) {
         ...newMainChatSourceMessages,
         ...clarificationSourceMessages,
     ]);
+    const sourceRefMessages = sortScratchpadSourceMessages([
+        ...(isInitialMainChatRefresh ? recentMessages : []),
+        ...sourceMessages,
+    ]);
     const latestMainChatSource = mainChatSourceMessages.at(-1);
     const latestClarificationRound = clarificationRounds.at(-1);
     const cursorUpdate = {};
@@ -124,6 +128,11 @@ export function readControlPlaneScratchpadSourceBatch(store, options = {}) {
             new_messages: compactScratchpadSourceMessages(sourceMessages),
         },
         cursor_update: cursorUpdate,
+        source_refs: sourceRefMessages.map((message) => ({
+            message_id: message.id,
+            source_scope: message.scope.kind,
+            created_at: message.created_at,
+        })),
         source_message_count: sourceMessages.length + (isInitialMainChatRefresh ? recentMessages.length : 0),
     };
 }
@@ -153,6 +162,7 @@ export async function runControlPlaneScratchpadRefreshProcedure(options) {
         workflowRef: options.workflowRef,
         activityRef: options.activityRef,
         cursorUpdate: options.sourceBatch.cursor_update,
+        sourceRefs: options.sourceBatch.source_refs,
         now: options.now,
     });
 }

package/dist/control-plane/scratchpad-refresh.d.ts

@@ -1,5 +1,6 @@
 import type { ActivityRef, WorkflowInvocationRef } from "@tutti/shared/ids";
 import type { ScratchpadSourceCursorUpdate } from "../collaboration-state/scratchpad-source-state.js";
+import type { ScratchpadSourceRefInput } from "../collaboration-state/types.js";
 import type { WorkspaceEventBus } from "../server-shell/http/workspace-events.js";
 import type { HostProjectStore } from "../store/index.js";
 import type { ScratchpadRefreshWorkflowOutput } from "./workflows/index.js";
@@ -10,6 +11,7 @@ export declare function applyScratchpadRefreshOutput(input: {
     workflowRef: WorkflowInvocationRef;
     activityRef: ActivityRef;
     cursorUpdate: ScratchpadSourceCursorUpdate;
+    sourceRefs: ScratchpadSourceRefInput[];
     now: () => Date;
 }): {
     kind: "needs_human";

package/dist/control-plane/scratchpad-refresh.js

@@ -31,6 +31,7 @@ export function applyScratchpadRefreshOutput(input) {
         current_consensus: input.output.scratchpad_snapshot.current_consensus,
         open_questions: input.output.scratchpad_snapshot.open_questions,
         task_changes: input.output.scratchpad_snapshot.task_changes,
+        source_refs: input.sourceRefs,
         updated_by_activity_ref: input.activityRef,
         now: input.now,
     });

package/dist/project-timeline/index.d.ts

@@ -1,10 +1,24 @@
 import { type ActivityRef, type EventRef, type TaskId, type WorkflowInvocationRef } from "@tutti/shared/ids";
-import type { ProjectTimelineItem } from "@tutti/shared/schemas/api";
 import type { SqliteDatabase } from "../store/index.js";
 export type ProjectTimelineEventKind = "context_sync" | "reference_summary" | "promotion_reconcile";
+export type ProjectTimelineEventStatus = "completed" | "failed";
+export type ProjectTimelineEventItem = {
+    id: string;
+    kind: "procedure" | "promotion";
+    occurred_at: string;
+    title: string;
+    status: ProjectTimelineEventStatus;
+    summary?: string;
+    activity_ref?: ActivityRef;
+    workflow_ref?: WorkflowInvocationRef;
+    task_id?: TaskId;
+    commit_oid?: string;
+    commit_short_oid?: string;
+    meta?: string[];
+};
 export type ProjectTimelineEventInput = {
     event_kind: ProjectTimelineEventKind;
-    status: NonNullable<ProjectTimelineItem["status"]>;
+    status: ProjectTimelineEventStatus;
     summary?: string;
     activity_ref?: ActivityRef;
     workflow_ref?: WorkflowInvocationRef;
@@ -16,5 +30,5 @@ export type ProjectTimelineEventInput = {
 export declare function recordProjectTimelineEvent(db: SqliteDatabase, input: ProjectTimelineEventInput): EventRef;
 export declare function readProjectTimelineEventItems(db: SqliteDatabase, options?: {
     limit?: number;
-}): ProjectTimelineItem[];
+}): ProjectTimelineEventItem[];
 //# sourceMappingURL=index.d.ts.map

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

@@ -8,6 +8,7 @@ export declare const HOST_PROJECT_COLLABORATION_OPENAPI_ROUTES: ({
         anchor: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"latest">, import("@sinclair/typebox").TLiteral<"start">]>>;
         before: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
         after: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        around: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     }>;
     responses: {
         200: {

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

@@ -67,7 +67,7 @@ export declare const HOST_PROJECT_TIMELINE_OPENAPI_ROUTES: {
                 }>;
                 items: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
                     id: import("@sinclair/typebox").TString;
-                    kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"run">, import("@sinclair/typebox").TLiteral<"procedure">, import("@sinclair/typebox").TLiteral<"commit">, import("@sinclair/typebox").TLiteral<"usage">, import("@sinclair/typebox").TLiteral<"clarification">, import("@sinclair/typebox").TLiteral<"checks">, import("@sinclair/typebox").TLiteral<"promotion">, import("@sinclair/typebox").TLiteral<"recovery">]>;
+                    kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"task_accepted">, import("@sinclair/typebox").TLiteral<"task_update">, import("@sinclair/typebox").TLiteral<"checkpoint">]>;
                     occurred_at: import("@sinclair/typebox").TString;
                     title: import("@sinclair/typebox").TString;
                     summary: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
@@ -75,9 +75,10 @@ export declare const HOST_PROJECT_TIMELINE_OPENAPI_ROUTES: {
                     task_title: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                     activity_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                     workflow_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-                    commit_oid: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-                    commit_short_oid: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-                    status: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"running">, import("@sinclair/typebox").TLiteral<"completed">, import("@sinclair/typebox").TLiteral<"failed">, import("@sinclair/typebox").TLiteral<"needs_human">, import("@sinclair/typebox").TLiteral<"skipped">]>>;
+                    run_result_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    message_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    status: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"completed">, import("@sinclair/typebox").TLiteral<"failed">, import("@sinclair/typebox").TLiteral<"needs_human">]>>;
+                    update_state: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"needs_input">, import("@sinclair/typebox").TLiteral<"completed">, import("@sinclair/typebox").TLiteral<"failed">]>>;
                     token_usage: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
                         input_tokens: import("@sinclair/typebox").TInteger;
                         cached_input_tokens: import("@sinclair/typebox").TInteger;
@@ -106,7 +107,95 @@ export declare const HOST_PROJECT_TIMELINE_OPENAPI_ROUTES: {
                         total_tokens: import("@sinclair/typebox").TInteger;
                         event_count: import("@sinclair/typebox").TInteger;
                     }>>>;
-                    meta: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+                    trace_card: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                        tone: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"neutral">, import("@sinclair/typebox").TLiteral<"success">, import("@sinclair/typebox").TLiteral<"warning">, import("@sinclair/typebox").TLiteral<"error">]>;
+                        summary: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                        origin: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                            title: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            summary: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            snippets: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+                                message_id: import("@sinclair/typebox").TString;
+                                author: import("@sinclair/typebox").TString;
+                                body: import("@sinclair/typebox").TString;
+                                created_at: import("@sinclair/typebox").TString;
+                            }>>>;
+                            source_count: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+                            unavailable_reason: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                        }>>;
+                        decisions: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+                            title: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            summary: import("@sinclair/typebox").TString;
+                            source: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"scratchpad">, import("@sinclair/typebox").TLiteral<"clarification">, import("@sinclair/typebox").TLiteral<"contract">]>>;
+                        }>>>;
+                        clarification: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                            title: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            summary: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            request: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            status: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"active">, import("@sinclair/typebox").TLiteral<"resolved">]>>;
+                            answer_count: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+                            answers: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+                                message_id: import("@sinclair/typebox").TString;
+                                author: import("@sinclair/typebox").TString;
+                                body: import("@sinclair/typebox").TString;
+                                created_at: import("@sinclair/typebox").TString;
+                            }>>>;
+                        }>>;
+                        contract: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                            goal: import("@sinclair/typebox").TString;
+                            scope: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+                            truncated: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+                        }>>;
+                        result: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                            summary: import("@sinclair/typebox").TString;
+                            error_code: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                        }>>;
+                        changes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                            items: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+                                status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"added">, import("@sinclair/typebox").TLiteral<"modified">, import("@sinclair/typebox").TLiteral<"deleted">, import("@sinclair/typebox").TLiteral<"renamed">, import("@sinclair/typebox").TLiteral<"unknown">]>;
+                                path: import("@sinclair/typebox").TString;
+                                previous_path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            }>>;
+                            total_count: import("@sinclair/typebox").TInteger;
+                            truncated: import("@sinclair/typebox").TBoolean;
+                        }>>;
+                        verification: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                            checks: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"passed">, import("@sinclair/typebox").TLiteral<"failed">, import("@sinclair/typebox").TLiteral<"skipped">]>;
+                            skip_reason_code: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            skip_reason_summary: 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">]>;
+                            commit_oid: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            commit_short_oid: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            summary: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            reason_code: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                        }>>;
+                        checkpoint: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                            counters: import("@sinclair/typebox").TObject<{
+                                completed: import("@sinclair/typebox").TInteger;
+                                failed: import("@sinclair/typebox").TInteger;
+                                remaining: import("@sinclair/typebox").TInteger;
+                            }>;
+                            items: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+                                task_id: import("@sinclair/typebox").TString;
+                                title: import("@sinclair/typebox").TString;
+                                status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"done">, import("@sinclair/typebox").TLiteral<"failed">]>;
+                                summary: 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;
+                            }>>>;
+                            truncated: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+                        }>>;
+                        links: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+                            kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"worklist_task">, import("@sinclair/typebox").TLiteral<"chat_message">, import("@sinclair/typebox").TLiteral<"reference_file">, import("@sinclair/typebox").TLiteral<"repo_path">]>;
+                            label: import("@sinclair/typebox").TString;
+                            task_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            message_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                        }>>;
+                    }>>;
                 }>>;
             }>;
         };

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

@@ -170,6 +170,7 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
         anchor: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"latest">, import("@sinclair/typebox").TLiteral<"start">]>>;
         before: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
         after: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        around: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     }>;
     responses: {
         200: {
@@ -963,7 +964,7 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
                 }>;
                 items: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
                     id: import("@sinclair/typebox").TString;
-                    kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"run">, import("@sinclair/typebox").TLiteral<"procedure">, import("@sinclair/typebox").TLiteral<"commit">, import("@sinclair/typebox").TLiteral<"usage">, import("@sinclair/typebox").TLiteral<"clarification">, import("@sinclair/typebox").TLiteral<"checks">, import("@sinclair/typebox").TLiteral<"promotion">, import("@sinclair/typebox").TLiteral<"recovery">]>;
+                    kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"task_accepted">, import("@sinclair/typebox").TLiteral<"task_update">, import("@sinclair/typebox").TLiteral<"checkpoint">]>;
                     occurred_at: import("@sinclair/typebox").TString;
                     title: import("@sinclair/typebox").TString;
                     summary: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
@@ -971,9 +972,10 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
                     task_title: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                     activity_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                     workflow_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-                    commit_oid: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-                    commit_short_oid: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-                    status: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"running">, import("@sinclair/typebox").TLiteral<"completed">, import("@sinclair/typebox").TLiteral<"failed">, import("@sinclair/typebox").TLiteral<"needs_human">, import("@sinclair/typebox").TLiteral<"skipped">]>>;
+                    run_result_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    message_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    status: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"completed">, import("@sinclair/typebox").TLiteral<"failed">, import("@sinclair/typebox").TLiteral<"needs_human">]>>;
+                    update_state: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"needs_input">, import("@sinclair/typebox").TLiteral<"completed">, import("@sinclair/typebox").TLiteral<"failed">]>>;
                     token_usage: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
                         input_tokens: import("@sinclair/typebox").TInteger;
                         cached_input_tokens: import("@sinclair/typebox").TInteger;
@@ -1002,7 +1004,95 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
                         total_tokens: import("@sinclair/typebox").TInteger;
                         event_count: import("@sinclair/typebox").TInteger;
                     }>>>;
-                    meta: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+                    trace_card: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                        tone: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"neutral">, import("@sinclair/typebox").TLiteral<"success">, import("@sinclair/typebox").TLiteral<"warning">, import("@sinclair/typebox").TLiteral<"error">]>;
+                        summary: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                        origin: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                            title: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            summary: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            snippets: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+                                message_id: import("@sinclair/typebox").TString;
+                                author: import("@sinclair/typebox").TString;
+                                body: import("@sinclair/typebox").TString;
+                                created_at: import("@sinclair/typebox").TString;
+                            }>>>;
+                            source_count: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+                            unavailable_reason: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                        }>>;
+                        decisions: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+                            title: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            summary: import("@sinclair/typebox").TString;
+                            source: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"scratchpad">, import("@sinclair/typebox").TLiteral<"clarification">, import("@sinclair/typebox").TLiteral<"contract">]>>;
+                        }>>>;
+                        clarification: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                            title: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            summary: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            request: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            status: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"active">, import("@sinclair/typebox").TLiteral<"resolved">]>>;
+                            answer_count: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+                            answers: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+                                message_id: import("@sinclair/typebox").TString;
+                                author: import("@sinclair/typebox").TString;
+                                body: import("@sinclair/typebox").TString;
+                                created_at: import("@sinclair/typebox").TString;
+                            }>>>;
+                        }>>;
+                        contract: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                            goal: import("@sinclair/typebox").TString;
+                            scope: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+                            truncated: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+                        }>>;
+                        result: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                            summary: import("@sinclair/typebox").TString;
+                            error_code: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                        }>>;
+                        changes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                            items: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+                                status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"added">, import("@sinclair/typebox").TLiteral<"modified">, import("@sinclair/typebox").TLiteral<"deleted">, import("@sinclair/typebox").TLiteral<"renamed">, import("@sinclair/typebox").TLiteral<"unknown">]>;
+                                path: import("@sinclair/typebox").TString;
+                                previous_path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            }>>;
+                            total_count: import("@sinclair/typebox").TInteger;
+                            truncated: import("@sinclair/typebox").TBoolean;
+                        }>>;
+                        verification: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                            checks: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"passed">, import("@sinclair/typebox").TLiteral<"failed">, import("@sinclair/typebox").TLiteral<"skipped">]>;
+                            skip_reason_code: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            skip_reason_summary: 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">]>;
+                            commit_oid: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            commit_short_oid: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            summary: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            reason_code: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                        }>>;
+                        checkpoint: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                            counters: import("@sinclair/typebox").TObject<{
+                                completed: import("@sinclair/typebox").TInteger;
+                                failed: import("@sinclair/typebox").TInteger;
+                                remaining: import("@sinclair/typebox").TInteger;
+                            }>;
+                            items: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+                                task_id: import("@sinclair/typebox").TString;
+                                title: import("@sinclair/typebox").TString;
+                                status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"done">, import("@sinclair/typebox").TLiteral<"failed">]>;
+                                summary: 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;
+                            }>>>;
+                            truncated: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+                        }>>;
+                        links: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+                            kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"worklist_task">, import("@sinclair/typebox").TLiteral<"chat_message">, import("@sinclair/typebox").TLiteral<"reference_file">, import("@sinclair/typebox").TLiteral<"repo_path">]>;
+                            label: import("@sinclair/typebox").TString;
+                            task_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            message_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                        }>>;
+                    }>>;
                 }>>;
             }>;
         };