@xfey/tutti 0.1.111 → 0.1.113

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

@@ -1,9 +1,8 @@
 import { ActiveClarificationProjectionSchema, GetClarificationRoundMessagesRequestSchema, GetClarificationRoundResponseSchema, GetClarificationThreadResponseSchema, MessageWindowSchema, SendClarificationRoundMessageBodySchema, SendClarificationRoundMessageResponseSchema, SubmitClarificationRoundBodySchema, SubmitClarificationRoundResponseSchema, } from "@tutti/shared/schemas/api";
 import { readActiveClarificationProjection, readClarificationRoundMessagesWindow, readClarificationRoundProjection, readClarificationThreadResponse, } from "../../../../collaboration-state/index.js";
-import { executeIdempotentCommand } from "../../../command-idempotency/index.js";
+import { ingestClarificationMessage, submitClarificationAnswers, } from "../../../../collaboration-ingestion/index.js";
 import { HOST_PROJECT_API_BASE_PATH } from "./constants.js";
 import { HostProjectNotFoundError } from "./errors.js";
-import { clarificationRoundInvalidates } from "./invalidations.js";
 import { requireValidMessageWindowRequest, requireValidRoundMessagePayload, } from "./payload-validation.js";
 import { ClarificationRoundParamsSchema, ClarificationThreadParamsSchema, } from "./schemas.js";
 import { requireControlPlane, requireHostProjectSession, requireProjectStore, } from "./session-requirements.js";
@@ -85,35 +84,20 @@ export function registerClarificationRoutes(app, options) {
         const store = requireProjectStore(options);
         const controlPlane = requireControlPlane(options);
         const payload = requireValidRoundMessagePayload(request.body.payload);
-        const execution = executeIdempotentCommand({
-            db: store.db,
-            command_id: request.body.command_id,
-            command_name: "clarification.message.create",
-            target_ref: request.params.roundId,
-            payload: {
-                body: payload.body,
-                author_ref: session.account.account_ref,
-            },
-            ...(options.now === undefined ? {} : { now: options.now }),
-            execute: () => controlPlane.sendClarificationRoundMessage(request.params.roundId, payload, {
+        return ingestClarificationMessage({
+            store,
+            controlPlane,
+            commandId: request.body.command_id,
+            roundId: request.params.roundId,
+            payload,
+            author: {
                 account_ref: session.account.account_ref,
                 display_name: session.account.display_name,
                 avatar: session.account.avatar,
-            }),
+            },
+            ...(options.now === undefined ? {} : { now: options.now }),
+            ...(options.chatAssistant === undefined ? {} : { chatAssistant: options.chatAssistant }),
         });
-        const response = {
-            command_id: execution.command_id,
-            disposition: execution.disposition,
-            invalidates: clarificationRoundInvalidates(request.params.roundId),
-        };
-        if (execution.result !== undefined) {
-            response.result = execution.result;
-        }
-        const message = execution.result?.message;
-        if (!execution.replayed && message !== undefined) {
-            options.chatAssistant?.enqueue({ message });
-        }
-        return response;
     });
     app.post(`${HOST_PROJECT_API_BASE_PATH}/clarifications/rounds/:roundId/submit`, {
         schema: {
@@ -127,24 +111,14 @@ export function registerClarificationRoutes(app, options) {
         requireHostProjectSession(request, options);
         const store = requireProjectStore(options);
         const controlPlane = requireControlPlane(options);
-        const execution = executeIdempotentCommand({
-            db: store.db,
-            command_id: request.body.command_id,
-            command_name: "clarification.round.submit",
-            target_ref: request.params.roundId,
+        return submitClarificationAnswers({
+            store,
+            controlPlane,
+            commandId: request.body.command_id,
+            roundId: request.params.roundId,
             payload: request.body.payload,
             ...(options.now === undefined ? {} : { now: options.now }),
-            execute: () => controlPlane.submitClarificationRound(request.params.roundId, request.body.payload, request.body.command_id),
         });
-        const response = {
-            command_id: execution.command_id,
-            disposition: execution.disposition,
-            invalidates: clarificationRoundInvalidates(request.params.roundId),
-        };
-        if (execution.result !== undefined) {
-            response.result = execution.result;
-        }
-        return response;
     });
 }
 //# sourceMappingURL=clarification-routes.js.map

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

@@ -266,6 +266,7 @@ export declare const HOST_PROJECT_COLLABORATION_OPENAPI_ROUTES: ({
                     }>;
                     card_message_id: import("@sinclair/typebox").TString;
                     opening_message_id: import("@sinclair/typebox").TString;
+                    answer_revision: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
                     submitted_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                     submitted_message_refs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
                     successor_status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"not_materialized">, import("@sinclair/typebox").TLiteral<"materialized">]>;
@@ -421,6 +422,7 @@ export declare const HOST_PROJECT_COLLABORATION_OPENAPI_ROUTES: ({
                     }>;
                     card_message_id: import("@sinclair/typebox").TString;
                     opening_message_id: import("@sinclair/typebox").TString;
+                    answer_revision: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
                     submitted_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                     submitted_message_refs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
                     successor_status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"not_materialized">, import("@sinclair/typebox").TLiteral<"materialized">]>;

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

@@ -1117,6 +1117,7 @@ export declare const HOST_PROJECT_WORKSPACE_OPENAPI_ROUTES: ({
                                     }>;
                                     card_message_id: import("@sinclair/typebox").TString;
                                     opening_message_id: import("@sinclair/typebox").TString;
+                                    answer_revision: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
                                     submitted_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                                     submitted_message_refs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
                                     successor_status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"not_materialized">, import("@sinclair/typebox").TLiteral<"materialized">]>;

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

@@ -410,6 +410,7 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
                     }>;
                     card_message_id: import("@sinclair/typebox").TString;
                     opening_message_id: import("@sinclair/typebox").TString;
+                    answer_revision: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
                     submitted_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                     submitted_message_refs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
                     successor_status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"not_materialized">, import("@sinclair/typebox").TLiteral<"materialized">]>;
@@ -565,6 +566,7 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
                     }>;
                     card_message_id: import("@sinclair/typebox").TString;
                     opening_message_id: import("@sinclair/typebox").TString;
+                    answer_revision: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
                     submitted_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                     submitted_message_refs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
                     successor_status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"not_materialized">, import("@sinclair/typebox").TLiteral<"materialized">]>;
@@ -2400,6 +2402,7 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
                                     }>;
                                     card_message_id: import("@sinclair/typebox").TString;
                                     opening_message_id: import("@sinclair/typebox").TString;
+                                    answer_revision: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
                                     submitted_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                                     submitted_message_refs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
                                     successor_status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"not_materialized">, import("@sinclair/typebox").TLiteral<"materialized">]>;

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

@@ -1081,6 +1081,7 @@ export declare const BootstrapResponseSchema: {
                         }>;
                         card_message_id: import("@sinclair/typebox").TString;
                         opening_message_id: import("@sinclair/typebox").TString;
+                        answer_revision: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
                         submitted_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                         submitted_message_refs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
                         successor_status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"not_materialized">, import("@sinclair/typebox").TLiteral<"materialized">]>;

package/migrations/0022_clarification_projection_cursors.sql

@@ -0,0 +1,7 @@
+CREATE TABLE platform_clarification_projection_cursors (
+  round_id TEXT PRIMARY KEY REFERENCES clarification_rounds(id),
+  binding_ref TEXT NOT NULL,
+  version INTEGER NOT NULL CHECK (version >= 0),
+  closed INTEGER NOT NULL DEFAULT 0 CHECK (closed IN (0, 1))
+);
+CREATE INDEX idx_platform_clarification_live ON platform_clarification_projection_cursors(closed);

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

@@ -45,6 +45,7 @@ export type RegisterRelayHostConnectionPayload = {
             repo_viewer: boolean;
             integration_source_ingestion_v1?: boolean;
             integration_development_bot_v1?: boolean;
+            integration_clarification_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

@@ -65,6 +65,9 @@ function createRegisterPayload(options) {
                 integration_managed_reference_ingestion_v1: capabilities.integration_managed_reference_ingestion_v1 ?? false,
                 integration_outbound_v1: capabilities.integration_outbound_v1 ?? false,
                 integration_approval_decision_v1: capabilities.integration_approval_decision_v1 ?? false,
+                ...(capabilities.integration_clarification_v1 === true
+                    ? { integration_clarification_v1: true }
+                    : {}),
             },
         },
     };

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

@@ -201,6 +201,7 @@ export declare const ClarificationRoundProjectionSchema: import("@sinclair/typeb
     }>;
     card_message_id: import("@sinclair/typebox").TString;
     opening_message_id: import("@sinclair/typebox").TString;
+    answer_revision: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
     submitted_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     submitted_message_refs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
     successor_status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"not_materialized">, import("@sinclair/typebox").TLiteral<"materialized">]>;
@@ -299,6 +300,7 @@ export declare const ActiveClarificationProjectionSchema: import("@sinclair/type
         }>;
         card_message_id: import("@sinclair/typebox").TString;
         opening_message_id: import("@sinclair/typebox").TString;
+        answer_revision: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
         submitted_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
         submitted_message_refs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
         successor_status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"not_materialized">, import("@sinclair/typebox").TLiteral<"materialized">]>;
@@ -437,6 +439,7 @@ export declare const GetClarificationRoundResponseSchema: import("@sinclair/type
         }>;
         card_message_id: import("@sinclair/typebox").TString;
         opening_message_id: import("@sinclair/typebox").TString;
+        answer_revision: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
         submitted_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
         submitted_message_refs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
         successor_status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"not_materialized">, import("@sinclair/typebox").TLiteral<"materialized">]>;
@@ -471,6 +474,7 @@ export declare const SendClarificationRoundMessagePayloadSchema: import("@sincla
 }>;
 export declare const SendClarificationRoundMessageDispositionSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
     kind: import("@sinclair/typebox").TLiteral<"created">;
+    message_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
 }>, import("@sinclair/typebox").TObject<{
     kind: import("@sinclair/typebox").TLiteral<"stale_round">;
     current_round_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
@@ -706,9 +710,16 @@ export declare const SendClarificationRoundMessageResultSchema: import("@sinclai
 }>;
 export declare const SendClarificationRoundMessageBodySchema: import("@sinclair/typebox").TSchema;
 export declare const SendClarificationRoundMessageResponseSchema: import("@sinclair/typebox").TSchema;
-export declare const SubmitClarificationRoundPayloadSchema: import("@sinclair/typebox").TObject<{}>;
+export declare const SubmitClarificationRoundPayloadSchema: import("@sinclair/typebox").TObject<{
+    expected_answer_revision: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+}>;
 export declare const SubmitClarificationRoundDispositionSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
     kind: import("@sinclair/typebox").TLiteral<"accepted">;
+}>, import("@sinclair/typebox").TObject<{
+    kind: import("@sinclair/typebox").TLiteral<"no_answers">;
+}>, import("@sinclair/typebox").TObject<{
+    kind: import("@sinclair/typebox").TLiteral<"answers_changed">;
+    current_answer_revision: import("@sinclair/typebox").TInteger;
 }>, import("@sinclair/typebox").TObject<{
     kind: import("@sinclair/typebox").TLiteral<"already_submitted">;
     successor_status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"not_materialized">, import("@sinclair/typebox").TLiteral<"materialized">]>;
@@ -790,6 +801,7 @@ export declare const SubmitClarificationRoundResultSchema: import("@sinclair/typ
         }>;
         card_message_id: import("@sinclair/typebox").TString;
         opening_message_id: import("@sinclair/typebox").TString;
+        answer_revision: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
         submitted_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
         submitted_message_refs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
         successor_status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"not_materialized">, import("@sinclair/typebox").TLiteral<"materialized">]>;

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

@@ -119,6 +119,8 @@ export const ClarificationRoundProjectionSchema = Type.Object({
     request_payload: ClarificationRequestPayloadSchema,
     card_message_id: MessageIdSchema,
     opening_message_id: MessageIdSchema,
+    // Append-only eligible answers. Optional for compatibility with older Hosts.
+    answer_revision: Type.Optional(Type.Integer({ minimum: 0 })),
     submitted_at: Type.Optional(IsoDateTimeStringSchema),
     submitted_message_refs: Type.Optional(Type.Array(MessageIdSchema)),
     successor_status: Type.Union([Type.Literal("not_materialized"), Type.Literal("materialized")]),
@@ -168,7 +170,7 @@ export const SendClarificationRoundMessagePayloadSchema = Type.Object({
     body: Type.String({ minLength: 1, maxLength: 8000 }),
 }, { additionalProperties: false });
 export const SendClarificationRoundMessageDispositionSchema = Type.Union([
-    Type.Object({ kind: Type.Literal("created") }, { additionalProperties: false }),
+    Type.Object({ kind: Type.Literal("created"), message_id: Type.Optional(MessageIdSchema) }, { additionalProperties: false }),
     Type.Object({
         kind: Type.Literal("stale_round"),
         current_round_id: Type.Optional(ClarificationRoundRefSchema),
@@ -181,9 +183,14 @@ export const SendClarificationRoundMessageResultSchema = Type.Object({
 }, { additionalProperties: false });
 export const SendClarificationRoundMessageBodySchema = commandEnvelopeSchema(SendClarificationRoundMessagePayloadSchema);
 export const SendClarificationRoundMessageResponseSchema = commandResponseWithResultSchema(SendClarificationRoundMessageDispositionSchema, SendClarificationRoundMessageResultSchema);
-export const SubmitClarificationRoundPayloadSchema = Type.Object({}, { additionalProperties: false });
+export const SubmitClarificationRoundPayloadSchema = Type.Object({ expected_answer_revision: Type.Optional(Type.Integer({ minimum: 0 })) }, { additionalProperties: false });
 export const SubmitClarificationRoundDispositionSchema = Type.Union([
     Type.Object({ kind: Type.Literal("accepted") }, { additionalProperties: false }),
+    Type.Object({ kind: Type.Literal("no_answers") }, { additionalProperties: false }),
+    Type.Object({
+        kind: Type.Literal("answers_changed"),
+        current_answer_revision: Type.Integer({ minimum: 0 }),
+    }, { additionalProperties: false }),
     Type.Object({
         kind: Type.Literal("already_submitted"),
         successor_status: Type.Union([

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

@@ -75,4 +75,6 @@ export * from "./platform-integration.js";
 export * from "./feishu-user-credentials.js";
 export * from "./feishu-documents.js";
 export * from "./external-references.js";
+export * from "./platform-clarification-content.js";
+export * from "./platform-clarification.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -69,4 +69,6 @@ export * from "./platform-integration.js";
 export * from "./feishu-user-credentials.js";
 export * from "./feishu-documents.js";
 export * from "./external-references.js";
+export * from "./platform-clarification-content.js";
+export * from "./platform-clarification.js";
 //# sourceMappingURL=index.js.map

package/node_modules/@tutti/shared/dist/schemas/internal/platform-clarification-content.d.ts

@@ -0,0 +1,15 @@
+import type { Static } from "@sinclair/typebox";
+/** Immutable request plus a monotonic Host projection, never Integration-owned round truth. */
+export declare const PlatformClarificationContentSchema: import("@sinclair/typebox").TObject<{
+    kind: import("@sinclair/typebox").TLiteral<"clarification">;
+    round_id: import("@sinclair/typebox").TString;
+    version: import("@sinclair/typebox").TInteger;
+    answer_revision: import("@sinclair/typebox").TInteger;
+    closed_reason: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"resolved">, import("@sinclair/typebox").TLiteral<"contract_changed">, import("@sinclair/typebox").TLiteral<"cancelled">]>>;
+    state: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"writable">, import("@sinclair/typebox").TLiteral<"submitted">, import("@sinclair/typebox").TLiteral<"continued">, import("@sinclair/typebox").TLiteral<"closed">]>;
+    title: import("@sinclair/typebox").TString;
+    request: import("@sinclair/typebox").TString;
+    opened_at: import("@sinclair/typebox").TString;
+}>;
+export type PlatformClarificationContent = Static<typeof PlatformClarificationContentSchema>;
+//# sourceMappingURL=platform-clarification-content.d.ts.map

package/node_modules/@tutti/shared/dist/schemas/internal/platform-clarification-content.js

@@ -0,0 +1,24 @@
+import { Type } from "@sinclair/typebox";
+import { ClarificationRoundRefSchema, IsoDateTimeStringSchema } from "../domain/index.js";
+/** Immutable request plus a monotonic Host projection, never Integration-owned round truth. */
+export const PlatformClarificationContentSchema = Type.Object({
+    kind: Type.Literal("clarification"),
+    round_id: ClarificationRoundRefSchema,
+    version: Type.Integer({ minimum: 0 }),
+    answer_revision: Type.Integer({ minimum: 0 }),
+    closed_reason: Type.Optional(Type.Union([
+        Type.Literal("resolved"),
+        Type.Literal("contract_changed"),
+        Type.Literal("cancelled"),
+    ])),
+    state: Type.Union([
+        Type.Literal("writable"),
+        Type.Literal("submitted"),
+        Type.Literal("continued"),
+        Type.Literal("closed"),
+    ]),
+    title: Type.String({ minLength: 1, maxLength: 512 }),
+    request: Type.String({ minLength: 1, maxLength: 4_000 }),
+    opened_at: IsoDateTimeStringSchema,
+}, { additionalProperties: false });
+//# sourceMappingURL=platform-clarification-content.js.map