@xfey/tutti 0.1.127 → 0.1.129

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

@@ -17,6 +17,8 @@ export type Phase5ControlPlaneOptions = {
         mainline_clean: boolean;
     };
     readActiveApproval?: () => ActiveApprovalProjection;
+    /** Read-only Chat owner signal; does not merge Chat into the workflow state machine. */
+    hasPendingChatRequests?: () => boolean;
     logger?: ControlPlaneLogger;
     projectContext?: {
         workspaceRoot: string;

package/dist/providers/failure-classification.d.ts

@@ -0,0 +1,23 @@
+declare const aliases: {
+    readonly provider_not_configured: "provider_not_configured";
+    readonly provider_auth_invalid: "provider_auth_invalid";
+    readonly provider_quota_or_billing_required: "provider_quota_or_billing_required";
+    readonly provider_rate_limited: "provider_rate_limited";
+    readonly provider_model_unavailable: "provider_model_unavailable";
+    readonly provider_network_error: "provider_network_error";
+    readonly auth_failed: "provider_auth_invalid";
+    readonly host_delegation_revoked: "provider_auth_invalid";
+    readonly authority_invalid: "provider_auth_invalid";
+    readonly gateway_rate_limited: "provider_rate_limited";
+    readonly control_queue_full: "provider_rate_limited";
+    readonly turn_timeout: "provider_timeout";
+    readonly output_parse_failed: "provider_output_invalid";
+    readonly output_validation_failed: "provider_output_invalid";
+    readonly process_lifecycle_failed: "provider_lifecycle_failed";
+    readonly process_tree_not_terminated: "provider_lifecycle_failed";
+};
+export type ProviderFailureCode = (typeof aliases)[keyof typeof aliases];
+/** Facts only, never a retry policy. Do not parse provider prose or raw stderr. */
+export declare function providerFailureCode(error: unknown): ProviderFailureCode | undefined;
+export {};
+//# sourceMappingURL=failure-classification.d.ts.map

package/dist/providers/failure-classification.js

@@ -0,0 +1,43 @@
+const aliases = {
+    provider_not_configured: "provider_not_configured",
+    provider_auth_invalid: "provider_auth_invalid",
+    provider_quota_or_billing_required: "provider_quota_or_billing_required",
+    provider_rate_limited: "provider_rate_limited",
+    provider_model_unavailable: "provider_model_unavailable",
+    provider_network_error: "provider_network_error",
+    auth_failed: "provider_auth_invalid",
+    host_delegation_revoked: "provider_auth_invalid",
+    authority_invalid: "provider_auth_invalid",
+    gateway_rate_limited: "provider_rate_limited",
+    control_queue_full: "provider_rate_limited",
+    turn_timeout: "provider_timeout",
+    output_parse_failed: "provider_output_invalid",
+    output_validation_failed: "provider_output_invalid",
+    process_lifecycle_failed: "provider_lifecycle_failed",
+    process_tree_not_terminated: "provider_lifecycle_failed",
+};
+/** Facts only, never a retry policy. Do not parse provider prose or raw stderr. */
+export function providerFailureCode(error) {
+    if (typeof error !== "object" || error === null)
+        return undefined;
+    const value = error;
+    const code = typeof value.code === "string" ? value.code : value.reason;
+    if (typeof code === "string" && Object.hasOwn(aliases, code))
+        return aliases[code];
+    if (code !== "turn_failed" || typeof value.details !== "object" || value.details === null)
+        return undefined;
+    const details = value.details;
+    // Quota can also carry HTTP 429; the specific bounded code takes precedence.
+    if (details.turn_error_code === "insufficient_quota")
+        return "provider_quota_or_billing_required";
+    if (details.turn_error_code === "invalid_api_key")
+        return "provider_auth_invalid";
+    if (details.turn_error_code === "model_not_found")
+        return "provider_model_unavailable";
+    if (details.turn_error_code === "rate_limit_exceeded" || details.turn_error_http_status === 429)
+        return "provider_rate_limited";
+    if (details.turn_error_http_status === 401)
+        return "provider_auth_invalid";
+    return undefined;
+}
+//# sourceMappingURL=failure-classification.js.map

package/dist/providers/invocation-progress.d.ts

@@ -3,8 +3,14 @@ export type ProviderInvocationProgress = {
     invocation_ref?: string;
     skill_count?: number;
     completed_tool_count?: number;
+    turn_timeout_ms?: number;
+    notification_count?: number;
+    server_request_count?: number;
+    last_activity_age_ms?: number;
     reason_code?: "provider_unavailable" | "app_server_protocol_error" | "auth_failed" | "thread_start_failed" | "turn_failed" | "turn_timeout" | "unexpected_server_request" | "skill_selection_failed" | "output_parse_failed" | "output_validation_failed" | "file_read_not_observed" | "write_detected" | "secret_leak_detected" | "process_lifecycle_failed" | "admission_unavailable";
 };
 export type ProviderInvocationProgressObserver = (event: ProviderInvocationProgress) => void;
+/** Copy only finite counters. Do not forward raw error details/methods/prose. */
+export declare function providerInvocationFailureCounters(error: unknown, now?: number): Partial<ProviderInvocationProgress>;
 export declare function reportProviderInvocationProgress(observer: ProviderInvocationProgressObserver | undefined, event: ProviderInvocationProgress): void;
 //# sourceMappingURL=invocation-progress.d.ts.map

package/dist/providers/invocation-progress.js

@@ -1,3 +1,27 @@
+/** Copy only finite counters. Do not forward raw error details/methods/prose. */
+export function providerInvocationFailureCounters(error, now = Date.now()) {
+    if (typeof error !== "object" || error === null || !("details" in error))
+        return {};
+    const details = error.details;
+    if (typeof details !== "object" || details === null)
+        return {};
+    const source = details;
+    const counters = {};
+    for (const key of ["turn_timeout_ms", "notification_count", "completed_tool_count"]) {
+        const value = source[key];
+        if (typeof value === "number" && Number.isSafeInteger(value) && value >= 0)
+            counters[key] = value;
+    }
+    if (Array.isArray(source.server_request_methods))
+        counters.server_request_count = source.server_request_methods.length;
+    if (typeof source.last_activity_at === "string" &&
+        /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/.test(source.last_activity_at)) {
+        const age = now - Date.parse(source.last_activity_at);
+        if (Number.isSafeInteger(age) && age >= 0)
+            counters.last_activity_age_ms = age;
+    }
+    return counters;
+}
 export function reportProviderInvocationProgress(observer, event) {
     try {
         observer?.(event);

package/dist/providers/openai/app-server/read-only-procedure.js

@@ -55,6 +55,7 @@ function readOnlyTimeoutDetails(input) {
     const details = {
         turn_timeout_ms: input.turnTimeoutMs,
         notification_count: input.client.notifications.length,
+        completed_tool_count: structuredOutputDetails(input.client, "").completed_tool_count ?? 0,
         server_request_methods: input.client.serverRequests.map(extractServerRequestMethod),
         notification_methods: input.client.notifications
             .map((notification) => notification.method)

package/dist/providers/openai/chat-assistant.js

@@ -3,7 +3,7 @@ import { readOpenAiApiKeyCredential } from "./credential-store.js";
 import { resolveOpenAiProviderConfig } from "./provider-config.js";
 import { openAiCredentialAccess, } from "./execution-access.js";
 import { CodexAppServerReadOnlyProcedureError, runCodexAppServerReadOnlyProcedure, } from "./app-server/read-only-procedure.js";
-import { reportProviderInvocationProgress } from "../invocation-progress.js";
+import { reportProviderInvocationProgress, providerInvocationFailureCounters, } from "../invocation-progress.js";
 import { getProjectUserSkillsRoot } from "../../skills/index.js";
 export function createOpenAiReadOnlyChatAssistantModel(options) {
     return {
@@ -42,6 +42,7 @@ export function createOpenAiReadOnlyChatAssistantModel(options) {
                     : { onLifecycleIncident: options.onLifecycleIncident }),
             }).catch((error) => {
                 reportProviderInvocationProgress(input.onProgress, {
+                    ...providerInvocationFailureCounters(error),
                     stage: "provider_failed",
                     reason_code: error instanceof CodexAppServerReadOnlyProcedureError
                         ? error.code

package/dist/reference-access/read-evidence.d.ts

@@ -1,6 +1,8 @@
 import type { SqliteDatabase } from "../store/index.js";
 import type { ReferenceCopy } from "./cache.js";
 import type { ReferenceInvocation } from "./service.js";
+import type { ReferenceAuthorization } from "@tutti/shared/schemas/api";
+export declare function recordExternalReferenceAccessRequirement(db: SqliteDatabase, invocation: ReferenceInvocation, requestRef: string, authorization: ReferenceAuthorization, now?: () => Date): void;
 /** Prior answer context only: a source reference is not proof of freshness in a later turn. */
 export declare function readExternalReferenceReadSources(db: SqliteDatabase, invocationRef: string): string[];
 /** Durable observation, separate from evictable cache metadata; no content or locator. */

package/dist/reference-access/read-evidence.js

@@ -1,3 +1,8 @@
+export function recordExternalReferenceAccessRequirement(db, invocation, requestRef, authorization, now = () => new Date()) {
+    db.prepare(`INSERT OR IGNORE INTO external_reference_access_requirements
+    (invocation_ref, request_ref, activity_ref, authorization_ref, profile, observed_at)
+    VALUES (?, ?, ?, ?, ?, ?)`).run(invocation.reference_invocation_ref, requestRef, invocation.activity_ref ?? null, authorization.authorization_ref, authorization.profile, now().toISOString());
+}
 /** Prior answer context only: a source reference is not proof of freshness in a later turn. */
 export function readExternalReferenceReadSources(db, invocationRef) {
     return db

package/dist/reference-access/service.d.ts

@@ -8,6 +8,8 @@ export type ReferenceInvocation = {
 };
 export declare class ReferenceAuthorizationRequiredError extends Error {
     readonly result: ReferenceAuthorizationRequired;
+    readonly code = "reference_authorization_required";
+    readonly continuation = "explicit_request";
     constructor(result: ReferenceAuthorizationRequired);
 }
 export declare class ExternalReferenceAccess {

package/dist/reference-access/service.js

@@ -1,6 +1,8 @@
 import { ReferenceCacheError } from "./cache.js";
 export class ReferenceAuthorizationRequiredError extends Error {
     result;
+    code = "reference_authorization_required";
+    continuation = "explicit_request";
     constructor(result) {
         super("reference_authorization_required");
         this.result = result;

package/dist/runtime-failures.js

@@ -1,3 +1,4 @@
+import { providerFailureCode } from "./providers/failure-classification.js";
 const STABLE_FAILURE_CODE = /^[a-z][a-z0-9_]{0,63}$/u;
 export function stableRuntimeFailureCode(error, fallback) {
     if (typeof error === "object" &&
@@ -17,6 +18,19 @@ export function safeRuntimeFailureSummary(subject, error, fallbackCode) {
     if (code === "admission_unavailable" || code === "admission_closed") {
         return `${subject} stopped because provider execution is unavailable while the Host is closing. Retry after the Host is ready. (${code})`;
     }
-    return `${subject} failed because the runtime returned an internal error. Retry the action. (${code})`;
+    if (code === "reference_authorization_required") {
+        return `${subject} needs document access. Authorize using the group card, then review the task or request before continuing. (${code})`;
+    }
+    const providerCode = providerFailureCode(error);
+    if (providerCode === "provider_auth_invalid" ||
+        providerCode === "provider_quota_or_billing_required" ||
+        providerCode === "provider_model_unavailable" ||
+        providerCode === "provider_not_configured") {
+        return `${subject} could not use model access. Ask the project owner to check the provider or account, then review available recovery actions. (${providerCode})`;
+    }
+    if (providerCode === "provider_rate_limited") {
+        return `${subject} stopped because the model service is busy. Wait, then review available recovery actions. (${providerCode})`;
+    }
+    return `${subject} could not complete. Review its status and available recovery actions before continuing. (${code})`;
 }
 //# sourceMappingURL=runtime-failures.js.map

package/dist/server-shell/cli/external-reference-runtime.js

@@ -4,7 +4,7 @@ import { requestExternalReferences } from "@tutti/relay-client";
 import { isExternalReferenceList, isExternalReferenceReadResult, isExternalReferenceDescriptor, isReferenceAuthorizationRequired, } from "@tutti/shared/schemas/internal";
 import { ExternalReferenceCache } from "../../reference-access/cache.js";
 import { ExternalReferenceAccess, ReferenceAuthorizationRequiredError, } from "../../reference-access/service.js";
-import { recordExternalReferenceRead } from "../../reference-access/read-evidence.js";
+import { recordExternalReferenceRead, recordExternalReferenceAccessRequirement, } from "../../reference-access/read-evidence.js";
 import { downloadStagedUploadWithResolver, cleanupDownloadedStagedUpload, } from "../http/routes/project-api/staged-uploads.js";
 import { readHostRegistrationSecret } from "./machine-local.js";
 export function createExternalReferenceRuntime(options) {
@@ -14,6 +14,7 @@ export function createExternalReferenceRuntime(options) {
         if (!relay)
             throw new Error("reference_host_offline");
         const secret = readHostRegistrationSecret(preparation.tutti_home, preparation.project_id);
+        const requestRef = `eref_${randomUUID().replaceAll("-", "")}`;
         const result = await requestExternalReferences({
             relayUrl: preparation.relay_url,
             body: {
@@ -22,15 +23,17 @@ export function createExternalReferenceRuntime(options) {
                 host_auth: { kind: "host_registration_secret_v1", secret: secret.secret },
                 relay_project_ref: relay.relay_project_ref,
                 host_connection_ref: relay.host_connection_ref,
-                request_ref: `eref_${randomUUID().replaceAll("-", "")}`,
+                request_ref: requestRef,
                 invocation_ref: invocation.reference_invocation_ref,
                 action,
                 ...(sourceRef === undefined ? {} : { source_ref: sourceRef }),
                 ...(documentUrl === undefined ? {} : { document_url: documentUrl }),
             },
         });
-        if (isReferenceAuthorizationRequired(result))
+        if (isReferenceAuthorizationRequired(result)) {
+            recordExternalReferenceAccessRequirement(options.store.db, invocation, requestRef, result.authorization);
             throw new ReferenceAuthorizationRequiredError(result);
+        }
         return result;
     }
     return new ExternalReferenceAccess({

package/dist/server-shell/cli/host-server-runtime.js

@@ -1,4 +1,5 @@
 import { basename, join } from "node:path";
+import { hasPendingChatRequests } from "../../chat-assistant/requests.js";
 import { MAX_PROVIDER_MODEL_NAME_LENGTH, } from "@tutti/shared/schemas/api";
 import { serializeRuntimeLogLine } from "@tutti/shared/utils";
 import { completeRelayUpload, deliverRelayPlatformOutbound, RelayHostControlClientError, resolveRelayUpload, } from "@tutti/relay-client";
@@ -397,6 +398,7 @@ export async function startForegroundHostServer(options) {
         events: workspaceEvents,
         now,
         logger: controlPlaneLogger,
+        hasPendingChatRequests: () => hasPendingChatRequests(store.db),
         projectContext,
         runLifecycle: {
             started: () => artifactPreviewManager.beginWorkspaceUpdate(),
@@ -464,12 +466,15 @@ export async function startForegroundHostServer(options) {
                         model: createManagedChatModel(managedRuntime, runtimeOptions),
                     };
                 if (resolution.kind !== "ready") {
-                    throw new Error("Provider is not configured.");
+                    throw Object.assign(new Error("Provider is not configured."), {
+                        code: "provider_not_configured",
+                    });
                 }
                 return await resolution.model.answer(input);
             },
         },
-        waitForInspectionAvailability: () => controlPlane.waitForRepoInspectionIdle(),
+        waitForInspectionAvailability: (onBlocked) => controlPlane.waitForRepoInspectionIdle(onBlocked),
+        onRequestsChanged: () => controlPlane.notifyChatRequestsChanged(),
         onScratchpadSourceChanged: (message) => controlPlane.notifyScratchpadSourceChanged(message),
         ...(platformOutboundCoordinator === undefined
             ? {}
@@ -704,6 +709,7 @@ export async function startForegroundHostServer(options) {
             workspaceRoot: options.preparation.workspace_root,
             recoverInProgressCommands: true,
         });
+        chatAssistant.start();
     };
     // Managed creation / reauthorization activates during Relay registration. Do
     // not recover a stored task against a not-yet-activated native delegation.

package/dist/server-shell/cli/relay-registration.js

@@ -66,6 +66,7 @@ export async function registerHostWithRelay(options) {
             integration_development_bot_v1: true,
             integration_clarification_v1: true,
             feishu_supporting_reads_v1: true,
+            request_status_v1: true,
             integration_external_references_v1: true,
             integration_attachment_ingestion_v1: true,
             integration_managed_reference_ingestion_v1: true,

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

@@ -1,11 +1,32 @@
-import { GetMessagesRequestSchema, MessageWindowSchema, SendMainChatMessageBodySchema, SendMainChatMessageResponseSchema, } from "@tutti/shared/schemas/api";
+import { Type } from "@sinclair/typebox";
+import { MessageIdSchema } from "@tutti/shared/schemas/domain";
+import { GetMessagesRequestSchema, ChatRequestStatusSchema, MessageWindowSchema, SendMainChatMessageBodySchema, SendMainChatMessageResponseSchema, } from "@tutti/shared/schemas/api";
 import { createArtifactFeedbackMessage } from "../../../../artifact-feedback/index.js";
 import { ingestMainChatMessage } from "../../../../collaboration-ingestion/index.js";
 import { readMainChatMessageWindow } from "../../../../collaboration-state/index.js";
 import { HOST_PROJECT_API_BASE_PATH } from "./constants.js";
 import { requireValidMessageWindowRequest, requireValidSendMainChatPayload, } from "./payload-validation.js";
 import { requireHostProjectSession, requireProjectStore, requireWorkspaceRoot, } from "./session-requirements.js";
+import { HostProjectNotFoundError, HostProjectBadRequestError } from "./errors.js";
+import { chatRequestStatus, readChatRequest } from "../../../../chat-assistant/requests.js";
 export function registerMessagesRoutes(app, { options, workspaceEvents, artifactPreviewManager, }) {
+    app.get(`${HOST_PROJECT_API_BASE_PATH}/chat-requests/:messageId`, {
+        preValidation: (request, _reply, done) => done(Object.keys(request.query).length === 0
+            ? undefined
+            : new HostProjectBadRequestError("Request status does not accept query parameters")),
+        schema: {
+            params: Type.Object({ messageId: MessageIdSchema }, { additionalProperties: false }),
+            querystring: Type.Object({}, { additionalProperties: false }),
+            response: { 200: ChatRequestStatusSchema },
+        },
+    }, (request, reply) => {
+        requireHostProjectSession(request, options);
+        reply.header("cache-control", "no-store");
+        const record = readChatRequest(requireProjectStore(options).db, request.params.messageId);
+        if (record === null)
+            throw new HostProjectNotFoundError();
+        return chatRequestStatus(record);
+    });
     app.get(`${HOST_PROJECT_API_BASE_PATH}/messages`, {
         schema: {
             querystring: GetMessagesRequestSchema,

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

@@ -1,4 +1,139 @@
 export declare const HOST_PROJECT_COLLABORATION_OPENAPI_ROUTES: ({
+    method: "get";
+    path: string;
+    summary: string;
+    tags: string[];
+    querystring: import("@sinclair/typebox").TObject<{
+        workflow_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        command_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>;
+    responses: {
+        200: {
+            description: string;
+            schema: 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<"interrupted" | "capacity" | "access" | "configuration" | "dependency" | "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]>;
+            }>;
+            contentType?: never;
+        };
+    };
+    parameters?: never;
+    requestBody?: never;
+} | {
+    method: "get";
+    path: string;
+    summary: string;
+    tags: string[];
+    parameters: import("@tutti/shared/schemas/api").BrowserFacingOpenApiParameter[];
+    responses: {
+        200: {
+            description: string;
+            schema: 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<"interrupted" | "capacity" | "access" | "configuration" | "dependency" | "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;
+            }>]>;
+            contentType?: never;
+        };
+    };
+    querystring?: never;
+    requestBody?: never;
+} | {
     method: "get";
     path: string;
     summary: string;
@@ -17,8 +152,8 @@ export declare const HOST_PROJECT_COLLABORATION_OPENAPI_ROUTES: ({
             contentType?: never;
         };
     };
-    requestBody?: never;
     parameters?: never;
+    requestBody?: never;
 } | {
     method: "post";
     path: string;
@@ -77,8 +212,8 @@ export declare const HOST_PROJECT_COLLABORATION_OPENAPI_ROUTES: ({
             };
         };
     };
-    requestBody?: never;
     parameters?: never;
+    requestBody?: never;
 } | {
     method: "get";
     path: string;
@@ -123,8 +258,8 @@ export declare const HOST_PROJECT_COLLABORATION_OPENAPI_ROUTES: ({
         };
     };
     querystring?: never;
-    requestBody?: never;
     parameters?: never;
+    requestBody?: never;
 } | {
     method: "get";
     path: string;
@@ -165,8 +300,8 @@ export declare const HOST_PROJECT_COLLABORATION_OPENAPI_ROUTES: ({
         };
     };
     querystring?: never;
-    requestBody?: never;
     parameters?: never;
+    requestBody?: never;
 } | {
     method: "post";
     path: string;
@@ -294,8 +429,8 @@ export declare const HOST_PROJECT_COLLABORATION_OPENAPI_ROUTES: ({
         };
     };
     querystring?: never;
-    requestBody?: never;
     parameters?: never;
+    requestBody?: never;
 } | {
     method: "get";
     path: string;

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

@@ -1,8 +1,35 @@
-import { ActiveClarificationProjectionSchema, GetClarificationRoundMessagesRequestSchema, GetClarificationRoundResponseSchema, GetClarificationThreadResponseSchema, GetMessagesRequestSchema, MessageWindowSchema, RunSchedulerNowBodySchema, RunSchedulerNowResponseSchema, ScratchpadProjectionSchema, SendClarificationRoundMessageBodySchema, SendClarificationRoundMessageResponseSchema, SendMainChatMessageResponseSchema, SubmitClarificationRoundBodySchema, SubmitClarificationRoundResponseSchema, SubmitWorklistBodySchema, SubmitWorklistResponseSchema, WorklistProjectionSchema, } from "@tutti/shared/schemas/api";
+import { ActiveClarificationProjectionSchema, ChatRequestStatusSchema, CurrentWorklistSubmissionSchema, WorklistSubmissionQuerySchema, GetClarificationRoundMessagesRequestSchema, GetClarificationRoundResponseSchema, GetClarificationThreadResponseSchema, GetMessagesRequestSchema, MessageWindowSchema, RunSchedulerNowBodySchema, RunSchedulerNowResponseSchema, ScratchpadProjectionSchema, SendClarificationRoundMessageBodySchema, SendClarificationRoundMessageResponseSchema, SendMainChatMessageResponseSchema, SubmitClarificationRoundBodySchema, SubmitClarificationRoundResponseSchema, SubmitWorklistBodySchema, SubmitWorklistResponseSchema, WorklistProjectionSchema, } from "@tutti/shared/schemas/api";
+import { MessageIdSchema } from "@tutti/shared/schemas/domain";
 import { HOST_PROJECT_API_BASE_PATH } from "./constants.js";
 import { EventStreamResponseSchema, GetEventsRequestSchema, SendMainChatMessageBodySchema, } from "./schemas.js";
-import { ClarificationRoundIdPathParameter, ClarificationThreadIdPathParameter, } from "./openapi-path-parameters.js";
+import { ClarificationRoundIdPathParameter, pathParameter, ClarificationThreadIdPathParameter, } from "./openapi-path-parameters.js";
 export const HOST_PROJECT_COLLABORATION_OPENAPI_ROUTES = [
+    {
+        method: "get",
+        path: `${HOST_PROJECT_API_BASE_PATH}/worklist/submission`,
+        summary: "Read the latest or identified Submit operation; acceptance is not completion.",
+        tags: ["worklist"],
+        querystring: WorklistSubmissionQuerySchema,
+        responses: {
+            200: {
+                description: "Submission evidence or null when not recorded.",
+                schema: CurrentWorklistSubmissionSchema,
+            },
+        },
+    },
+    {
+        method: "get",
+        path: `${HOST_PROJECT_API_BASE_PATH}/chat-requests/{message_id}`,
+        summary: "Read a durable answer request by its trigger message id.",
+        tags: ["messages"],
+        parameters: [pathParameter("message_id", MessageIdSchema, "Original question message id.")],
+        responses: {
+            200: {
+                description: "Host processing status, not platform delivery status.",
+                schema: ChatRequestStatusSchema,
+            },
+        },
+    },
     {
         method: "get",
         path: `${HOST_PROJECT_API_BASE_PATH}/messages`,

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

@@ -25,6 +25,7 @@ export declare const HOST_PROJECT_SKILLS_OPENAPI_ROUTES: ({
                     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>;
                 }>;
             }>;
         };
@@ -60,6 +61,7 @@ export declare const HOST_PROJECT_SKILLS_OPENAPI_ROUTES: ({
                     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>;
                 }>;
             }>;
         };

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

@@ -575,6 +575,9 @@ export declare const HOST_PROJECT_WORKSPACE_OPENAPI_ROUTES: ({
                             readonly artifact_feedback: {
                                 readonly type: "boolean";
                             };
+                            readonly request_status_v1: {
+                                readonly type: "boolean";
+                            };
                         };
                     };
                 };
@@ -769,6 +772,9 @@ export declare const HOST_PROJECT_WORKSPACE_OPENAPI_ROUTES: ({
                                     readonly artifact_feedback: {
                                         readonly type: "boolean";
                                     };
+                                    readonly request_status_v1: {
+                                        readonly type: "boolean";
+                                    };
                                 };
                             };
                         };