@xfey/tutti 0.1.127 → 0.1.128

package/dist/server-shell/http/routes/project-api/workflow-routes.js

@@ -1,10 +1,34 @@
-import { RunSchedulerNowBodySchema, RunSchedulerNowResponseSchema, ScratchpadProjectionSchema, SubmitWorklistBodySchema, SubmitWorklistResponseSchema, WorklistProjectionSchema, } from "@tutti/shared/schemas/api";
+import { Value } from "@sinclair/typebox/value";
+import { HostProjectBadRequestError } from "./errors.js";
+import { readTaskCompileRequestStatus, readTaskCompileCommandRef, } from "../../../../control-plane/task-compile-request-status.js";
+import { RunSchedulerNowBodySchema, CurrentWorklistSubmissionSchema, WorklistSubmissionQuerySchema, RunSchedulerNowResponseSchema, ScratchpadProjectionSchema, SubmitWorklistBodySchema, SubmitWorklistResponseSchema, WorklistProjectionSchema, } from "@tutti/shared/schemas/api";
 import { readScratchpadProjection, readWorklistProjection, } from "../../../../collaboration-state/index.js";
 import { executeIdempotentCommand } from "../../../command-idempotency/index.js";
 import { HOST_PROJECT_API_BASE_PATH } from "./constants.js";
-import { schedulerRunNowInvalidates, worklistSubmitInvalidates, } from "./invalidations.js";
+import { schedulerRunNowInvalidates, worklistSubmitInvalidates } from "./invalidations.js";
 import { requireControlPlane, requireHostProjectSession, requireProjectStore, } from "./session-requirements.js";
 export function registerWorkflowRoutes(app, options) {
+    app.get(`${HOST_PROJECT_API_BASE_PATH}/worklist/submission`, {
+        preValidation: (request, _reply, done) => done(Value.Check(WorklistSubmissionQuerySchema, request.query)
+            ? undefined
+            : new HostProjectBadRequestError("Request status query is invalid")),
+        schema: {
+            querystring: WorklistSubmissionQuerySchema,
+            response: { 200: CurrentWorklistSubmissionSchema },
+        },
+    }, (request, reply) => {
+        requireHostProjectSession(request, options);
+        reply.header("cache-control", "no-store");
+        const db = requireProjectStore(options).db;
+        const ref = request.query.command_id === undefined
+            ? request.query.workflow_ref
+            : readTaskCompileCommandRef(db, request.query.command_id);
+        return {
+            request: request.query.command_id !== undefined && ref === undefined
+                ? null
+                : readTaskCompileRequestStatus(db, requireControlPlane(options).getExecutionStatus(), ref),
+        };
+    });
     app.get(`${HOST_PROJECT_API_BASE_PATH}/scratchpad`, {
         schema: {
             response: {
@@ -43,7 +67,14 @@ export function registerWorkflowRoutes(app, options) {
             target_ref: "scratchpad:current",
             payload: request.body.payload,
             ...(options.now === undefined ? {} : { now: options.now }),
-            execute: () => controlPlane.startTaskCompile(request.body.payload),
+            execute: (tx) => {
+                const result = controlPlane.startTaskCompile(request.body.payload);
+                const ref = result.result?.submission_ref;
+                if (ref !== undefined) {
+                    tx.prepare("INSERT INTO task_compile_request_commands (command_id, workflow_ref) VALUES (?, ?)").run(request.body.command_id, ref);
+                }
+                return result;
+            },
         });
         const response = {
             command_id: execution.command_id,
@@ -53,6 +84,11 @@ export function registerWorkflowRoutes(app, options) {
         if (execution.result !== undefined) {
             response.result = execution.result;
         }
+        else if (execution.replayed) {
+            const ref = readTaskCompileCommandRef(store.db, request.body.command_id);
+            if (ref !== undefined)
+                response.result = { submission_ref: ref };
+        }
         return response;
     });
     app.post(`${HOST_PROJECT_API_BASE_PATH}/scheduler/run-now`, {

package/dist/server-shell/http/routes/project-api/workspace-projections.js

@@ -4,6 +4,7 @@ import { HOST_MAINLINE_BRANCH } from "./constants.js";
 function defaultCapabilities(options) {
     const overrides = options.capabilities;
     return {
+        request_status_v1: options.controlPlane !== undefined && (overrides?.request_status_v1 ?? true),
         sse: overrides?.sse ?? true,
         relay_join: overrides?.relay_join ?? true,
         repo_viewer: overrides?.repo_viewer ?? false,

package/dist/server-shell/http/validation.js

@@ -125,14 +125,20 @@ export function toApiErrorResponse(error) {
 export function registerApiErrorHandler(app) {
     app.setErrorHandler((error, request, reply) => {
         if (getValidationArray(error) !== undefined) {
-            void reply.status(400).send(toValidationErrorResponse(error));
+            const response = toValidationErrorResponse(error);
+            if (/^[A-Za-z0-9_-]{1,128}$/u.test(request.id))
+                response.error.request_id = request.id;
+            void reply.status(400).send(response);
             return;
         }
         const statusCode = statusCodeFromError(error);
         if (statusCode >= 500) {
             request.log.error({ err: error }, "Unhandled host request error");
         }
-        void reply.status(statusCode).send(toApiErrorResponse(error));
+        const response = toApiErrorResponse(error);
+        if (/^[A-Za-z0-9_-]{1,128}$/u.test(request.id))
+            response.error.request_id = request.id;
+        void reply.status(statusCode).send(response);
     });
 }
 //# sourceMappingURL=validation.js.map

package/dist/server-shell/local-console/managed-project-service.d.ts

@@ -139,7 +139,7 @@ export declare class LocalConsoleManagedProjectService {
     }>;
     validate(requestRef: string, context: LocalConsoleInvocationContext): Promise<{
         validation: {
-            state: "failed" | "unknown" | "started" | "succeeded";
+            state: "failed" | "succeeded" | "unknown" | "started";
             installation_ref: string;
             reason_code: "validation_started" | "validation_succeeded" | "validation_route_unavailable" | "validation_http_rejected" | "validation_response_invalid" | "validation_transport_unknown" | "validation_interrupted";
             project_id: string;

package/dist/server-shell/managed-access/transport.d.ts

@@ -34,7 +34,7 @@ export declare function validateNativePreparation(options: {
     fetchImpl?: typeof fetch;
     signal?: AbortSignal;
 }): Promise<{
-    state: "failed" | "unknown" | "started" | "succeeded";
+    state: "failed" | "succeeded" | "unknown" | "started";
     installation_ref: string;
     reason_code: "validation_started" | "validation_succeeded" | "validation_route_unavailable" | "validation_http_rejected" | "validation_response_invalid" | "validation_transport_unknown" | "validation_interrupted";
     project_id: string;

package/migrations/0024_chat_requests.sql

@@ -0,0 +1,19 @@
+CREATE TABLE chat_requests (
+  enqueue_order INTEGER PRIMARY KEY AUTOINCREMENT,
+  trigger_message_id TEXT NOT NULL UNIQUE REFERENCES messages(id),
+  status TEXT NOT NULL CHECK (status IN ('queued', 'running', 'succeeded', 'failed')),
+  phase TEXT NOT NULL CHECK (phase IN ('queue', 'workspace_wait', 'answer', 'settled')),
+  revision INTEGER NOT NULL DEFAULT 1 CHECK (revision > 0),
+  attempt_ref TEXT,
+  response_message_id TEXT UNIQUE REFERENCES messages(id),
+  failure_json TEXT,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  CHECK (
+    (status = 'queued' AND phase = 'queue' AND failure_json IS NULL AND response_message_id IS NULL) OR
+    (status = 'running' AND phase IN ('workspace_wait', 'answer') AND attempt_ref IS NOT NULL AND failure_json IS NULL AND response_message_id IS NULL) OR
+    (status = 'succeeded' AND phase = 'settled' AND response_message_id IS NOT NULL AND failure_json IS NULL) OR
+    (status = 'failed' AND phase = 'settled' AND failure_json IS NOT NULL)
+  )
+);
+CREATE INDEX chat_requests_pending ON chat_requests(status, enqueue_order);

package/migrations/0025_task_compile_requests.sql

@@ -0,0 +1,50 @@
+-- Identity / closure evidence only. Pending inputs, clarification and receipts
+-- remain authoritative; this table does not schedule or replay work.
+CREATE TABLE task_compile_requests (
+  workflow_ref TEXT PRIMARY KEY,
+  accepted_activity_ref TEXT NOT NULL,
+  current_activity_ref TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  failure_code TEXT CHECK (failure_code IN ('task_compile_failed', 'scratchpad_empty_after_refresh')),
+  closed_at TEXT,
+  CHECK ((failure_code IS NULL) = (closed_at IS NULL))
+);
+
+CREATE TABLE task_compile_request_commands (
+  command_id TEXT PRIMARY KEY REFERENCES command_idempotency_records(command_id),
+  workflow_ref TEXT NOT NULL REFERENCES task_compile_requests(workflow_ref)
+);
+
+CREATE INDEX idx_task_compile_requests_latest ON task_compile_requests(created_at DESC);
+
+-- Only live submissions have provable identity at migration time. Do not infer
+-- failed historical requests from missing contexts or unrelated activities.
+INSERT INTO task_compile_requests
+  (workflow_ref, accepted_activity_ref, current_activity_ref, created_at)
+SELECT workflow_ref, accepted_activity_ref, accepted_activity_ref, requested_at
+FROM pending_task_compile_submissions;
+INSERT OR IGNORE INTO task_compile_requests
+  (workflow_ref, accepted_activity_ref, current_activity_ref, created_at)
+SELECT workflow_ref, captured_by_activity_ref, captured_by_activity_ref, submitted_at
+FROM active_task_compile_context;
+
+-- Read requirement evidence, not an authorization/token mirror. Several model
+-- invocations may encounter the same Integration-owned authorization request.
+CREATE TABLE external_reference_access_requirements (
+  invocation_ref TEXT NOT NULL,
+  request_ref TEXT NOT NULL,
+  activity_ref TEXT,
+  authorization_ref TEXT NOT NULL,
+  profile TEXT NOT NULL CHECK (profile IN ('docx', 'wiki_docx', 'drive_file')),
+  observed_at TEXT NOT NULL,
+  PRIMARY KEY (invocation_ref, request_ref)
+);
+CREATE INDEX idx_external_reference_requirements_activity
+  ON external_reference_access_requirements(activity_ref);
+
+CREATE TABLE chat_request_invocations (
+  message_id TEXT NOT NULL REFERENCES chat_requests(trigger_message_id),
+  attempt_ref TEXT NOT NULL,
+  invocation_ref TEXT NOT NULL,
+  PRIMARY KEY (message_id, attempt_ref)
+);

package/migrations/README.md

@@ -13,6 +13,8 @@
 
 ## 当前 migrations
 
+后续 `0021`／`0022`／`0023` 分别增加外部读取证据、clarification 投影 cursor 和协作语言 metadata。`0024_chat_requests.sql` 为普通 Chat 增加持久 FIFO、状态／阶段 CHECK、attempt／revision、原始与回复 message FK；不回填历史提问，不保存正文／prompt。最新 `0025_task_compile_requests.sql` 增加 Submit identity／明确关闭证据、command 关联、外部授权 requirement 与 Chat attempt→invocation 关联；仅回填 live pending／captured submission，不重建历史状态／command，不复制 token 或授权状态。恢复仍由原 owner 负责，见 [请求状态与恢复](../../../docs/system/request-status-and-recovery.md)。
+
 - `0001_init.sql`：初始化本地 `tutti.sqlite`，包含协作 truth records、store metadata、command idempotency、clarification replay hint、索引和关键 trigger。
 - `0002_allow_sealed_round_successor_note.sql`：允许 Control Plane 在 sealed clarification round 内追加只读 Tutti successor 结论消息，同时继续禁止人类补充消息写入 sealed round。
 - `0003_drop_scratchpad_source_message_refs.sql`：从 Scratchpad 持久化中移除不再暴露给模型、API 或 UI 的来源消息追溯字段。
@@ -36,7 +38,7 @@
 
 ## 当前实现状态
 
-- `0001_init.sql` 至 `0020_managed_reference_sources.sql` 已存在，代表当前 host project SQLite schema contract。`0014` 明确采用开发数据库重建策略，不提供旧 Scratchpad source/cursor 数据兼容；`0016`–`0017`不要求为既有internal Chat message或agent response回填external mapping / outbound intent，`0018`保留旧intent并以runtime capture boundary阻止历史status回填，`0019`无损加入structured card content，`0020`加入独立managed Reference recovery checkpoint。
+- 当前 Host migrations 已到 `0025_task_compile_requests.sql`，后续表的 owner 见上方说明。`0014` 明确采用开发数据库重建策略，不提供旧 Scratchpad source/cursor 数据兼容；`0016`–`0017`不回填既有 internal Chat message／agent response 的 external mapping／outbound intent，`0018`保留旧 intent 并阻止历史 status 回填，`0019`无损加入 structured card content，`0020`加入独立 managed Reference recovery checkpoint；`0024`不回填历史 Chat 请求，`0025`只回填 live submission identity。
 - SQLite adapter、migration runner、checksum 校验、store metadata 初始化、transaction helper 与 command recovery scan helper 已实现。
 - 协作 repository 与 Control Plane 已实现第一批业务读写；Phase 7 首批已复用 `0001_init.sql` 中的 `tasks.latest_run_result_id`、`task_details.result_json` 与 `run_results` 表完成 Run result / checks / promotion 摘要持久化。Control Plane recovery resolver 与 task-bound continuation / retry 复用现有 schema；新 Run 的 accepted checkpoint 业务 truth 继续写入最终 Run result / task detail result，Git tag / commit trailer 承担 crash recovery evidence。Timeline 默认从 `tasks`、`run_results` 与历史主群聊 `refs.worklist_feedback` 投影任务级审计节点，当前 task terminal Chat feedback 写入 `refs.task_result` 消息；`project_timeline_events` 只保留缺少稳定 record 的轻量可观测性事件和历史 reconcile 兼容记录。project workspace、working diff 与 ignored runtime state 都不进入 SQLite truth。`provider_usage_events` 只保存 token 计数、调用来源、模型名、记录时间和可空 anchor，不保存 provider secret、prompt 或 raw response。store 基础设施本身已经可以创建并迁移 `tutti.sqlite`。
 

package/node_modules/@tutti/relay-client/dist/host-control.d.ts

@@ -48,6 +48,7 @@ export type RegisterRelayHostConnectionPayload = {
             integration_development_bot_v1?: boolean;
             integration_clarification_v1?: boolean;
             feishu_supporting_reads_v1?: boolean;
+            request_status_v1?: boolean;
             integration_external_references_v1?: boolean;
             integration_attachment_ingestion_v1?: boolean;
             integration_managed_reference_ingestion_v1?: boolean;

package/node_modules/@tutti/relay-client/dist/host-control.js

@@ -71,6 +71,7 @@ function createRegisterPayload(options) {
                 ...(capabilities.feishu_supporting_reads_v1 === true
                     ? { feishu_supporting_reads_v1: true }
                     : {}),
+                ...(capabilities.request_status_v1 === true ? { request_status_v1: true } : {}),
             },
         },
     };

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

@@ -1,5 +1,6 @@
 export * from "./openapi.js";
 export * from "./managed-account.js";
+export * from "./operation-status.js";
 export type * from "./types.js";
 export { ARTIFACT_FEEDBACK_MAX_ANNOTATIONS, ARTIFACT_FEEDBACK_MAX_AUTHORED_TEXT_LENGTH, ARTIFACT_FEEDBACK_MAX_COMMENT_LENGTH, ARTIFACT_FEEDBACK_MAX_SERIALIZED_BYTES, ARTIFACT_FEEDBACK_MAX_SUMMARY_LENGTH, ArtifactElementAnchorSchema, ArtifactElementKindSchema, ArtifactElementTargetSchema, ArtifactFeedbackAnnotationSchema, ArtifactFeedbackCommandSchema, ArtifactFeedbackRefSchema, ArtifactSemanticContextSchema, ArtifactSemanticSnapshotSchema, ArtifactSemanticStateSchema, } from "./artifact-feedback.js";
 export { CompleteDesktopEntryContinuationBodySchema, CompleteDesktopEntryContinuationResponseSchema, CreateDesktopEntryContinuationResponseSchema, DESKTOP_ENTRY_COMPLETION_TOKEN_LENGTH, DESKTOP_ENTRY_PAYLOAD_KEY_LENGTH, DESKTOP_ENTRY_SEALED_IV_LENGTH, DesktopEntryCompletionTokenSchema, DesktopEntryContinuationPendingProjectionSchema, DesktopEntryContinuationReadyProjectionSchema, DesktopEntryPayloadKeySchema, GetDesktopEntryContinuationResponseSchema, MAX_DESKTOP_ENTRY_SEALED_CIPHERTEXT_LENGTH, SealedDesktopEntryPayloadSchema, } from "./desktop-entry-continuations.js";

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

@@ -1,5 +1,6 @@
 export * from "./openapi.js";
 export * from "./managed-account.js";
+export * from "./operation-status.js";
 export { ARTIFACT_FEEDBACK_MAX_ANNOTATIONS, ARTIFACT_FEEDBACK_MAX_AUTHORED_TEXT_LENGTH, ARTIFACT_FEEDBACK_MAX_COMMENT_LENGTH, ARTIFACT_FEEDBACK_MAX_SERIALIZED_BYTES, ARTIFACT_FEEDBACK_MAX_SUMMARY_LENGTH, ArtifactElementAnchorSchema, ArtifactElementKindSchema, ArtifactElementTargetSchema, ArtifactFeedbackAnnotationSchema, ArtifactFeedbackCommandSchema, ArtifactFeedbackRefSchema, ArtifactSemanticContextSchema, ArtifactSemanticSnapshotSchema, ArtifactSemanticStateSchema, } from "./artifact-feedback.js";
 export { CompleteDesktopEntryContinuationBodySchema, CompleteDesktopEntryContinuationResponseSchema, CreateDesktopEntryContinuationResponseSchema, DESKTOP_ENTRY_COMPLETION_TOKEN_LENGTH, DESKTOP_ENTRY_PAYLOAD_KEY_LENGTH, DESKTOP_ENTRY_SEALED_IV_LENGTH, DesktopEntryCompletionTokenSchema, DesktopEntryContinuationPendingProjectionSchema, DesktopEntryContinuationReadyProjectionSchema, DesktopEntryPayloadKeySchema, GetDesktopEntryContinuationResponseSchema, MAX_DESKTOP_ENTRY_SEALED_CIPHERTEXT_LENGTH, SealedDesktopEntryPayloadSchema, } from "./desktop-entry-continuations.js";
 export { LOCAL_CONSOLE_ACCOUNT_HANDOFF_TOKEN_MAX_LENGTH, LOCAL_CONSOLE_ACCOUNT_HANDOFF_TOKEN_MIN_LENGTH, RegisterLocalConsoleAccountHandoffBodySchema, RegisterLocalConsoleAccountHandoffResponseSchema, } from "./local-console-account-handoffs.js";

package/node_modules/@tutti/shared/dist/schemas/api/operation-status.d.ts

@@ -0,0 +1,174 @@
+import { type Static } from "@sinclair/typebox";
+export declare const OperationFailureSchema: import("@sinclair/typebox").TObject<{
+    code: import("@sinclair/typebox").TString;
+    category: import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"capacity" | "access" | "configuration" | "dependency" | "interrupted" | "internal">[]>;
+    recovery: import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"resend_request" | "check_provider" | "restart_host" | "contact_support" | "none">[]>;
+    diagnostic_id: import("@sinclair/typebox").TString;
+}>;
+export declare const ChatRequestStatusSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+    status: import("@sinclair/typebox").TLiteral<"queued">;
+    phase: import("@sinclair/typebox").TLiteral<"queue">;
+    operation: import("@sinclair/typebox").TObject<{
+        kind: import("@sinclair/typebox").TLiteral<"chat_answer">;
+        ref: import("@sinclair/typebox").TString;
+    }>;
+    revision: import("@sinclair/typebox").TInteger;
+    created_at: import("@sinclair/typebox").TString;
+    updated_at: import("@sinclair/typebox").TString;
+}>, import("@sinclair/typebox").TObject<{
+    status: import("@sinclair/typebox").TLiteral<"running">;
+    phase: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"workspace_wait">, import("@sinclair/typebox").TLiteral<"answer">]>;
+    operation: import("@sinclair/typebox").TObject<{
+        kind: import("@sinclair/typebox").TLiteral<"chat_answer">;
+        ref: import("@sinclair/typebox").TString;
+    }>;
+    revision: import("@sinclair/typebox").TInteger;
+    created_at: import("@sinclair/typebox").TString;
+    updated_at: import("@sinclair/typebox").TString;
+}>, import("@sinclair/typebox").TObject<{
+    status: import("@sinclair/typebox").TLiteral<"succeeded">;
+    phase: import("@sinclair/typebox").TLiteral<"settled">;
+    response_message_id: import("@sinclair/typebox").TString;
+    operation: import("@sinclair/typebox").TObject<{
+        kind: import("@sinclair/typebox").TLiteral<"chat_answer">;
+        ref: import("@sinclair/typebox").TString;
+    }>;
+    revision: import("@sinclair/typebox").TInteger;
+    created_at: import("@sinclair/typebox").TString;
+    updated_at: import("@sinclair/typebox").TString;
+}>, import("@sinclair/typebox").TObject<{
+    status: import("@sinclair/typebox").TLiteral<"failed">;
+    phase: import("@sinclair/typebox").TLiteral<"settled">;
+    failure: import("@sinclair/typebox").TObject<{
+        code: import("@sinclair/typebox").TString;
+        category: import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"capacity" | "access" | "configuration" | "dependency" | "interrupted" | "internal">[]>;
+        recovery: import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"resend_request" | "check_provider" | "restart_host" | "contact_support" | "none">[]>;
+        diagnostic_id: import("@sinclair/typebox").TString;
+    }>;
+    response_message_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    operation: import("@sinclair/typebox").TObject<{
+        kind: import("@sinclair/typebox").TLiteral<"chat_answer">;
+        ref: import("@sinclair/typebox").TString;
+    }>;
+    revision: import("@sinclair/typebox").TInteger;
+    created_at: import("@sinclair/typebox").TString;
+    updated_at: import("@sinclair/typebox").TString;
+}>]>;
+export type OperationFailure = Static<typeof OperationFailureSchema>;
+export type ChatRequestStatus = Static<typeof ChatRequestStatusSchema>;
+export declare const WorklistSubmissionStatusSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+    status: import("@sinclair/typebox").TLiteral<"running">;
+    phase: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"preparing">, import("@sinclair/typebox").TLiteral<"scratchpad_refresh">, import("@sinclair/typebox").TLiteral<"reference_summary_refresh">, import("@sinclair/typebox").TLiteral<"project_context_bootstrap">, import("@sinclair/typebox").TLiteral<"task_compile">]>;
+    operation: import("@sinclair/typebox").TObject<{
+        kind: import("@sinclair/typebox").TLiteral<"worklist_submit">;
+        ref: import("@sinclair/typebox").TString;
+    }>;
+    created_at: import("@sinclair/typebox").TString;
+    activity_ref: import("@sinclair/typebox").TString;
+}>, import("@sinclair/typebox").TObject<{
+    status: import("@sinclair/typebox").TLiteral<"waiting_input">;
+    phase: import("@sinclair/typebox").TLiteral<"clarification">;
+    round_id: import("@sinclair/typebox").TString;
+    operation: import("@sinclair/typebox").TObject<{
+        kind: import("@sinclair/typebox").TLiteral<"worklist_submit">;
+        ref: import("@sinclair/typebox").TString;
+    }>;
+    created_at: import("@sinclair/typebox").TString;
+    activity_ref: import("@sinclair/typebox").TString;
+}>, import("@sinclair/typebox").TObject<{
+    status: import("@sinclair/typebox").TLiteral<"succeeded">;
+    phase: import("@sinclair/typebox").TLiteral<"settled">;
+    operation: import("@sinclair/typebox").TObject<{
+        kind: import("@sinclair/typebox").TLiteral<"worklist_submit">;
+        ref: import("@sinclair/typebox").TString;
+    }>;
+    created_at: import("@sinclair/typebox").TString;
+    activity_ref: import("@sinclair/typebox").TString;
+}>, import("@sinclair/typebox").TObject<{
+    status: import("@sinclair/typebox").TLiteral<"failed">;
+    phase: import("@sinclair/typebox").TLiteral<"settled">;
+    failure: import("@sinclair/typebox").TObject<{
+        code: import("@sinclair/typebox").TString;
+        category: import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"capacity" | "access" | "configuration" | "dependency" | "interrupted" | "internal">[]>;
+        recovery: import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"resend_request" | "check_provider" | "restart_host" | "contact_support" | "none">[]>;
+        diagnostic_id: import("@sinclair/typebox").TString;
+    }>;
+    operation: import("@sinclair/typebox").TObject<{
+        kind: import("@sinclair/typebox").TLiteral<"worklist_submit">;
+        ref: import("@sinclair/typebox").TString;
+    }>;
+    created_at: import("@sinclair/typebox").TString;
+    activity_ref: import("@sinclair/typebox").TString;
+}>, import("@sinclair/typebox").TObject<{
+    status: import("@sinclair/typebox").TLiteral<"unknown">;
+    phase: import("@sinclair/typebox").TLiteral<"unconfirmed">;
+    operation: import("@sinclair/typebox").TObject<{
+        kind: import("@sinclair/typebox").TLiteral<"worklist_submit">;
+        ref: import("@sinclair/typebox").TString;
+    }>;
+    created_at: import("@sinclair/typebox").TString;
+    activity_ref: import("@sinclair/typebox").TString;
+}>]>;
+export declare const CurrentWorklistSubmissionSchema: import("@sinclair/typebox").TObject<{
+    request: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        status: import("@sinclair/typebox").TLiteral<"running">;
+        phase: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"preparing">, import("@sinclair/typebox").TLiteral<"scratchpad_refresh">, import("@sinclair/typebox").TLiteral<"reference_summary_refresh">, import("@sinclair/typebox").TLiteral<"project_context_bootstrap">, import("@sinclair/typebox").TLiteral<"task_compile">]>;
+        operation: import("@sinclair/typebox").TObject<{
+            kind: import("@sinclair/typebox").TLiteral<"worklist_submit">;
+            ref: import("@sinclair/typebox").TString;
+        }>;
+        created_at: import("@sinclair/typebox").TString;
+        activity_ref: import("@sinclair/typebox").TString;
+    }>, import("@sinclair/typebox").TObject<{
+        status: import("@sinclair/typebox").TLiteral<"waiting_input">;
+        phase: import("@sinclair/typebox").TLiteral<"clarification">;
+        round_id: import("@sinclair/typebox").TString;
+        operation: import("@sinclair/typebox").TObject<{
+            kind: import("@sinclair/typebox").TLiteral<"worklist_submit">;
+            ref: import("@sinclair/typebox").TString;
+        }>;
+        created_at: import("@sinclair/typebox").TString;
+        activity_ref: import("@sinclair/typebox").TString;
+    }>, import("@sinclair/typebox").TObject<{
+        status: import("@sinclair/typebox").TLiteral<"succeeded">;
+        phase: import("@sinclair/typebox").TLiteral<"settled">;
+        operation: import("@sinclair/typebox").TObject<{
+            kind: import("@sinclair/typebox").TLiteral<"worklist_submit">;
+            ref: import("@sinclair/typebox").TString;
+        }>;
+        created_at: import("@sinclair/typebox").TString;
+        activity_ref: import("@sinclair/typebox").TString;
+    }>, import("@sinclair/typebox").TObject<{
+        status: import("@sinclair/typebox").TLiteral<"failed">;
+        phase: import("@sinclair/typebox").TLiteral<"settled">;
+        failure: import("@sinclair/typebox").TObject<{
+            code: import("@sinclair/typebox").TString;
+            category: import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"capacity" | "access" | "configuration" | "dependency" | "interrupted" | "internal">[]>;
+            recovery: import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"resend_request" | "check_provider" | "restart_host" | "contact_support" | "none">[]>;
+            diagnostic_id: import("@sinclair/typebox").TString;
+        }>;
+        operation: import("@sinclair/typebox").TObject<{
+            kind: import("@sinclair/typebox").TLiteral<"worklist_submit">;
+            ref: import("@sinclair/typebox").TString;
+        }>;
+        created_at: import("@sinclair/typebox").TString;
+        activity_ref: import("@sinclair/typebox").TString;
+    }>, import("@sinclair/typebox").TObject<{
+        status: import("@sinclair/typebox").TLiteral<"unknown">;
+        phase: import("@sinclair/typebox").TLiteral<"unconfirmed">;
+        operation: import("@sinclair/typebox").TObject<{
+            kind: import("@sinclair/typebox").TLiteral<"worklist_submit">;
+            ref: import("@sinclair/typebox").TString;
+        }>;
+        created_at: import("@sinclair/typebox").TString;
+        activity_ref: import("@sinclair/typebox").TString;
+    }>]>, import("@sinclair/typebox").TNull]>;
+}>;
+export type WorklistSubmissionStatus = Static<typeof WorklistSubmissionStatusSchema>;
+export type CurrentWorklistSubmission = Static<typeof CurrentWorklistSubmissionSchema>;
+export declare const WorklistSubmissionQuerySchema: import("@sinclair/typebox").TObject<{
+    workflow_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    command_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export type WorklistSubmissionQuery = Static<typeof WorklistSubmissionQuerySchema>;
+//# sourceMappingURL=operation-status.d.ts.map

package/node_modules/@tutti/shared/dist/schemas/api/operation-status.js

@@ -0,0 +1,75 @@
+import { Type } from "@sinclair/typebox";
+import { ActivityRefSchema, ClarificationRoundRefSchema, IdempotencyKeySchema, IsoDateTimeStringSchema, MessageIdSchema, WorkflowInvocationRefSchema, } from "../domain/index.js";
+// Shared vocabulary, not a second Task/Run state machine. Add operation kinds only
+// when an authoritative adapter and its query contract actually exist.
+export const OperationFailureSchema = Type.Object({
+    code: Type.String({ pattern: "^[a-z][a-z0-9_]{0,63}$" }),
+    category: Type.Union(["capacity", "access", "configuration", "dependency", "interrupted", "internal"].map((value) => Type.Literal(value))),
+    recovery: Type.Union(["resend_request", "check_provider", "restart_host", "contact_support", "none"].map((value) => Type.Literal(value))),
+    diagnostic_id: Type.String({ pattern: "^[A-Za-z0-9_-]{1,128}$" }),
+}, { additionalProperties: false });
+const common = {
+    operation: Type.Object({ kind: Type.Literal("chat_answer"), ref: MessageIdSchema }, { additionalProperties: false }),
+    revision: Type.Integer({ minimum: 1 }),
+    created_at: IsoDateTimeStringSchema,
+    updated_at: IsoDateTimeStringSchema,
+};
+export const ChatRequestStatusSchema = Type.Union([
+    Type.Object({ ...common, status: Type.Literal("queued"), phase: Type.Literal("queue") }, { additionalProperties: false }),
+    Type.Object({
+        ...common,
+        status: Type.Literal("running"),
+        phase: Type.Union([Type.Literal("workspace_wait"), Type.Literal("answer")]),
+    }, { additionalProperties: false }),
+    Type.Object({
+        ...common,
+        status: Type.Literal("succeeded"),
+        phase: Type.Literal("settled"),
+        response_message_id: MessageIdSchema,
+    }, { additionalProperties: false }),
+    Type.Object({
+        ...common,
+        status: Type.Literal("failed"),
+        phase: Type.Literal("settled"),
+        failure: OperationFailureSchema,
+        response_message_id: Type.Optional(MessageIdSchema),
+    }, { additionalProperties: false }),
+]);
+const submission = {
+    operation: Type.Object({ kind: Type.Literal("worklist_submit"), ref: WorkflowInvocationRefSchema }, { additionalProperties: false }),
+    created_at: IsoDateTimeStringSchema,
+    activity_ref: ActivityRefSchema,
+};
+export const WorklistSubmissionStatusSchema = Type.Union([
+    Type.Object({
+        ...submission,
+        status: Type.Literal("running"),
+        phase: Type.Union([
+            Type.Literal("preparing"),
+            Type.Literal("scratchpad_refresh"),
+            Type.Literal("reference_summary_refresh"),
+            Type.Literal("project_context_bootstrap"),
+            Type.Literal("task_compile"),
+        ]),
+    }, { additionalProperties: false }),
+    Type.Object({
+        ...submission,
+        status: Type.Literal("waiting_input"),
+        phase: Type.Literal("clarification"),
+        round_id: ClarificationRoundRefSchema,
+    }, { additionalProperties: false }),
+    Type.Object({ ...submission, status: Type.Literal("succeeded"), phase: Type.Literal("settled") }, { additionalProperties: false }),
+    Type.Object({
+        ...submission,
+        status: Type.Literal("failed"),
+        phase: Type.Literal("settled"),
+        failure: OperationFailureSchema,
+    }, { additionalProperties: false }),
+    Type.Object({ ...submission, status: Type.Literal("unknown"), phase: Type.Literal("unconfirmed") }, { additionalProperties: false }),
+]);
+export const CurrentWorklistSubmissionSchema = Type.Object({ request: Type.Union([WorklistSubmissionStatusSchema, Type.Null()]) }, { additionalProperties: false });
+export const WorklistSubmissionQuerySchema = Type.Object({
+    workflow_ref: Type.Optional(WorkflowInvocationRefSchema),
+    command_id: Type.Optional(IdempotencyKeySchema),
+}, { additionalProperties: false, maxProperties: 1 });
+//# sourceMappingURL=operation-status.js.map

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

@@ -79,6 +79,7 @@ export declare const ApiErrorResponseSchema: import("@sinclair/typebox").TObject
         message: import("@sinclair/typebox").TString;
         retryable: import("@sinclair/typebox").TBoolean;
         details: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnknown>;
+        request_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     }>;
 }>;
 export declare const WorkspaceSseEventTypeSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"connection.ready">, import("@sinclair/typebox").TLiteral<"message.created">, import("@sinclair/typebox").TLiteral<"scratchpad.updated">, import("@sinclair/typebox").TLiteral<"worklist.changed">, import("@sinclair/typebox").TLiteral<"task.updated">, import("@sinclair/typebox").TLiteral<"task_detail.updated">, import("@sinclair/typebox").TLiteral<"clarification.changed">, import("@sinclair/typebox").TLiteral<"approval.changed">, import("@sinclair/typebox").TLiteral<"activity.event">, import("@sinclair/typebox").TLiteral<"execution_status.changed">, import("@sinclair/typebox").TLiteral<"provider_config.changed">, import("@sinclair/typebox").TLiteral<"workspace.recovered">, import("@sinclair/typebox").TLiteral<"query.invalidate">]>;

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

@@ -115,6 +115,7 @@ export const ApiErrorResponseSchema = Type.Object({
         message: Type.String({ minLength: 1 }),
         retryable: Type.Boolean(),
         details: Type.Optional(Type.Unknown()),
+        request_id: Type.Optional(Type.String({ pattern: "^[A-Za-z0-9_-]{1,128}$" })),
     }, { additionalProperties: false }),
 }, { additionalProperties: false });
 export const WorkspaceSseEventTypeSchema = Type.Union([

package/node_modules/@tutti/shared/dist/schemas/api/workspace-commands.d.ts

@@ -106,6 +106,7 @@ export declare const SubmitWorklistDispositionSchema: import("@sinclair/typebox"
     retry_with_new_command_id: import("@sinclair/typebox").TLiteral<true>;
 }>]>;
 export declare const SubmitWorklistResultSchema: import("@sinclair/typebox").TObject<{
+    submission_ref: 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>;
 }>;

package/node_modules/@tutti/shared/dist/schemas/api/workspace-commands.js

@@ -2,7 +2,7 @@ import { Type } from "@sinclair/typebox";
 import { ActivityRefSchema, ClarificationRoundRefSchema, ClarificationThreadRefSchema, IsoDateTimeStringSchema, TaskIdSchema, RunResultIdSchema, WorkflowInvocationRefSchema, } from "../domain/index.js";
 import { ProviderUnavailableReasonCodeSchema } from "./provider-config.js";
 import { InterruptedCommandDispositionSchema, NonEmptyStringSchema, commandEnvelopeSchema, commandResponseSchema, commandResponseWithResultSchema, } from "./primitives.js";
-import { ProjectDocSummaryProjectionSchema, ViewerPathSchema, } from "./viewer-reference.js";
+import { ProjectDocSummaryProjectionSchema, ViewerPathSchema } from "./viewer-reference.js";
 import { ScratchpadProjectionSchema } from "./work-items.js";
 export const RefreshScratchpadDispositionSchema = Type.Union([
     Type.Object({ kind: Type.Literal("accepted") }, { additionalProperties: false }),
@@ -47,6 +47,7 @@ export const SubmitWorklistDispositionSchema = Type.Union([
     InterruptedCommandDispositionSchema,
 ]);
 export const SubmitWorklistResultSchema = Type.Object({
+    submission_ref: Type.Optional(WorkflowInvocationRefSchema),
     activity_ref: Type.Optional(ActivityRefSchema),
     workflow_ref: Type.Optional(WorkflowInvocationRefSchema),
 }, { additionalProperties: false });

package/package.json

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