@cat-factory/contracts 0.33.0 → 0.35.0

package/dist/routes/clarity.d.ts

@@ -0,0 +1,462 @@
+import { ContractNoBody } from '@toad-contracts/valibot';
+import * as v from 'valibot';
+export declare const getClarityReviewContract: {
+    readonly method: "get";
+    readonly requestPathParamsSchema: v.ObjectSchema<{
+        readonly blockId: v.StringSchema<undefined>;
+    }, undefined> & import("@toad-contracts/core").ObjectKeysCarrier;
+    readonly pathResolver: ({ blockId }: {
+        blockId: string;
+    }) => string;
+    readonly responsesByStatusCode: {
+        readonly '4xx': v.ObjectSchema<{
+            readonly error: v.ObjectSchema<{
+                readonly code: v.StringSchema<undefined>;
+                readonly message: v.StringSchema<undefined>;
+                readonly details: v.OptionalSchema<v.UnknownSchema, undefined>;
+                readonly issues: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+                    readonly path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly message: v.StringSchema<undefined>;
+                }, undefined>, undefined>, undefined>;
+            }, undefined>;
+        }, undefined>;
+        readonly '5xx': v.ObjectSchema<{
+            readonly error: v.ObjectSchema<{
+                readonly code: v.StringSchema<undefined>;
+                readonly message: v.StringSchema<undefined>;
+                readonly details: v.OptionalSchema<v.UnknownSchema, undefined>;
+                readonly issues: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+                    readonly path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly message: v.StringSchema<undefined>;
+                }, undefined>, undefined>, undefined>;
+            }, undefined>;
+        }, undefined>;
+        readonly 200: v.NullableSchema<v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+            readonly blockId: v.StringSchema<undefined>;
+            readonly status: v.PicklistSchema<["ready", "incorporating", "reviewing", "merged", "exceeded", "incorporated"], undefined>;
+            readonly items: v.ArraySchema<v.ObjectSchema<{
+                readonly id: v.StringSchema<undefined>;
+                readonly category: v.PicklistSchema<["gap", "clarification", "assumption", "risk", "question"], undefined>;
+                readonly severity: v.PicklistSchema<["low", "medium", "high"], undefined>;
+                readonly title: v.StringSchema<undefined>;
+                readonly detail: v.StringSchema<undefined>;
+                readonly status: v.PicklistSchema<["open", "answered", "resolved", "dismissed", "recommend_requested"], undefined>;
+                readonly reply: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                readonly createdAt: v.NumberSchema<undefined>;
+                readonly updatedAt: v.NumberSchema<undefined>;
+            }, undefined>, undefined>;
+            readonly model: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly clarifiedReport: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly iteration: v.OptionalSchema<v.NumberSchema<undefined>, 1>;
+            readonly maxIterations: v.OptionalSchema<v.NumberSchema<undefined>, 1>;
+            readonly createdAt: v.NumberSchema<undefined>;
+            readonly updatedAt: v.NumberSchema<undefined>;
+        }, undefined>, undefined>;
+    };
+};
+export declare const reviewClarityContract: {
+    readonly method: "post";
+    readonly requestPathParamsSchema: v.ObjectSchema<{
+        readonly blockId: v.StringSchema<undefined>;
+    }, undefined> & import("@toad-contracts/core").ObjectKeysCarrier;
+    readonly pathResolver: ({ blockId }: {
+        blockId: string;
+    }) => string;
+    readonly requestBodySchema: typeof ContractNoBody;
+    readonly responsesByStatusCode: {
+        readonly '4xx': v.ObjectSchema<{
+            readonly error: v.ObjectSchema<{
+                readonly code: v.StringSchema<undefined>;
+                readonly message: v.StringSchema<undefined>;
+                readonly details: v.OptionalSchema<v.UnknownSchema, undefined>;
+                readonly issues: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+                    readonly path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly message: v.StringSchema<undefined>;
+                }, undefined>, undefined>, undefined>;
+            }, undefined>;
+        }, undefined>;
+        readonly '5xx': v.ObjectSchema<{
+            readonly error: v.ObjectSchema<{
+                readonly code: v.StringSchema<undefined>;
+                readonly message: v.StringSchema<undefined>;
+                readonly details: v.OptionalSchema<v.UnknownSchema, undefined>;
+                readonly issues: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+                    readonly path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly message: v.StringSchema<undefined>;
+                }, undefined>, undefined>, undefined>;
+            }, undefined>;
+        }, undefined>;
+        readonly 201: v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+            readonly blockId: v.StringSchema<undefined>;
+            readonly status: v.PicklistSchema<["ready", "incorporating", "reviewing", "merged", "exceeded", "incorporated"], undefined>;
+            readonly items: v.ArraySchema<v.ObjectSchema<{
+                readonly id: v.StringSchema<undefined>;
+                readonly category: v.PicklistSchema<["gap", "clarification", "assumption", "risk", "question"], undefined>;
+                readonly severity: v.PicklistSchema<["low", "medium", "high"], undefined>;
+                readonly title: v.StringSchema<undefined>;
+                readonly detail: v.StringSchema<undefined>;
+                readonly status: v.PicklistSchema<["open", "answered", "resolved", "dismissed", "recommend_requested"], undefined>;
+                readonly reply: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                readonly createdAt: v.NumberSchema<undefined>;
+                readonly updatedAt: v.NumberSchema<undefined>;
+            }, undefined>, undefined>;
+            readonly model: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly clarifiedReport: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly iteration: v.OptionalSchema<v.NumberSchema<undefined>, 1>;
+            readonly maxIterations: v.OptionalSchema<v.NumberSchema<undefined>, 1>;
+            readonly createdAt: v.NumberSchema<undefined>;
+            readonly updatedAt: v.NumberSchema<undefined>;
+        }, undefined>;
+    };
+};
+export declare const replyClarityItemContract: {
+    readonly method: "post";
+    readonly requestPathParamsSchema: v.ObjectSchema<{
+        readonly reviewId: v.StringSchema<undefined>;
+        readonly itemId: v.StringSchema<undefined>;
+    }, undefined> & import("@toad-contracts/core").ObjectKeysCarrier;
+    readonly pathResolver: ({ reviewId, itemId }: {
+        reviewId: string;
+        itemId: string;
+    }) => string;
+    readonly requestBodySchema: v.ObjectSchema<{
+        readonly reply: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 4000, undefined>]>;
+    }, undefined>;
+    readonly responsesByStatusCode: {
+        readonly '4xx': v.ObjectSchema<{
+            readonly error: v.ObjectSchema<{
+                readonly code: v.StringSchema<undefined>;
+                readonly message: v.StringSchema<undefined>;
+                readonly details: v.OptionalSchema<v.UnknownSchema, undefined>;
+                readonly issues: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+                    readonly path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly message: v.StringSchema<undefined>;
+                }, undefined>, undefined>, undefined>;
+            }, undefined>;
+        }, undefined>;
+        readonly '5xx': v.ObjectSchema<{
+            readonly error: v.ObjectSchema<{
+                readonly code: v.StringSchema<undefined>;
+                readonly message: v.StringSchema<undefined>;
+                readonly details: v.OptionalSchema<v.UnknownSchema, undefined>;
+                readonly issues: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+                    readonly path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly message: v.StringSchema<undefined>;
+                }, undefined>, undefined>, undefined>;
+            }, undefined>;
+        }, undefined>;
+        readonly 200: v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+            readonly blockId: v.StringSchema<undefined>;
+            readonly status: v.PicklistSchema<["ready", "incorporating", "reviewing", "merged", "exceeded", "incorporated"], undefined>;
+            readonly items: v.ArraySchema<v.ObjectSchema<{
+                readonly id: v.StringSchema<undefined>;
+                readonly category: v.PicklistSchema<["gap", "clarification", "assumption", "risk", "question"], undefined>;
+                readonly severity: v.PicklistSchema<["low", "medium", "high"], undefined>;
+                readonly title: v.StringSchema<undefined>;
+                readonly detail: v.StringSchema<undefined>;
+                readonly status: v.PicklistSchema<["open", "answered", "resolved", "dismissed", "recommend_requested"], undefined>;
+                readonly reply: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                readonly createdAt: v.NumberSchema<undefined>;
+                readonly updatedAt: v.NumberSchema<undefined>;
+            }, undefined>, undefined>;
+            readonly model: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly clarifiedReport: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly iteration: v.OptionalSchema<v.NumberSchema<undefined>, 1>;
+            readonly maxIterations: v.OptionalSchema<v.NumberSchema<undefined>, 1>;
+            readonly createdAt: v.NumberSchema<undefined>;
+            readonly updatedAt: v.NumberSchema<undefined>;
+        }, undefined>;
+    };
+};
+export declare const updateClarityItemStatusContract: {
+    readonly method: "patch";
+    readonly requestPathParamsSchema: v.ObjectSchema<{
+        readonly reviewId: v.StringSchema<undefined>;
+        readonly itemId: v.StringSchema<undefined>;
+    }, undefined> & import("@toad-contracts/core").ObjectKeysCarrier;
+    readonly pathResolver: ({ reviewId, itemId }: {
+        reviewId: string;
+        itemId: string;
+    }) => string;
+    readonly requestBodySchema: v.ObjectSchema<{
+        readonly status: v.PicklistSchema<["open", "answered", "resolved", "dismissed"], undefined>;
+    }, undefined>;
+    readonly responsesByStatusCode: {
+        readonly '4xx': v.ObjectSchema<{
+            readonly error: v.ObjectSchema<{
+                readonly code: v.StringSchema<undefined>;
+                readonly message: v.StringSchema<undefined>;
+                readonly details: v.OptionalSchema<v.UnknownSchema, undefined>;
+                readonly issues: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+                    readonly path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly message: v.StringSchema<undefined>;
+                }, undefined>, undefined>, undefined>;
+            }, undefined>;
+        }, undefined>;
+        readonly '5xx': v.ObjectSchema<{
+            readonly error: v.ObjectSchema<{
+                readonly code: v.StringSchema<undefined>;
+                readonly message: v.StringSchema<undefined>;
+                readonly details: v.OptionalSchema<v.UnknownSchema, undefined>;
+                readonly issues: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+                    readonly path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly message: v.StringSchema<undefined>;
+                }, undefined>, undefined>, undefined>;
+            }, undefined>;
+        }, undefined>;
+        readonly 200: v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+            readonly blockId: v.StringSchema<undefined>;
+            readonly status: v.PicklistSchema<["ready", "incorporating", "reviewing", "merged", "exceeded", "incorporated"], undefined>;
+            readonly items: v.ArraySchema<v.ObjectSchema<{
+                readonly id: v.StringSchema<undefined>;
+                readonly category: v.PicklistSchema<["gap", "clarification", "assumption", "risk", "question"], undefined>;
+                readonly severity: v.PicklistSchema<["low", "medium", "high"], undefined>;
+                readonly title: v.StringSchema<undefined>;
+                readonly detail: v.StringSchema<undefined>;
+                readonly status: v.PicklistSchema<["open", "answered", "resolved", "dismissed", "recommend_requested"], undefined>;
+                readonly reply: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                readonly createdAt: v.NumberSchema<undefined>;
+                readonly updatedAt: v.NumberSchema<undefined>;
+            }, undefined>, undefined>;
+            readonly model: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly clarifiedReport: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly iteration: v.OptionalSchema<v.NumberSchema<undefined>, 1>;
+            readonly maxIterations: v.OptionalSchema<v.NumberSchema<undefined>, 1>;
+            readonly createdAt: v.NumberSchema<undefined>;
+            readonly updatedAt: v.NumberSchema<undefined>;
+        }, undefined>;
+    };
+};
+export declare const incorporateClarityContract: {
+    readonly method: "post";
+    readonly requestPathParamsSchema: v.ObjectSchema<{
+        readonly blockId: v.StringSchema<undefined>;
+    }, undefined> & import("@toad-contracts/core").ObjectKeysCarrier;
+    readonly pathResolver: ({ blockId }: {
+        blockId: string;
+    }) => string;
+    readonly requestBodySchema: v.ObjectSchema<{
+        readonly feedback: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MaxLengthAction<string, 4000, undefined>]>, undefined>;
+    }, undefined>;
+    readonly responsesByStatusCode: {
+        readonly '4xx': v.ObjectSchema<{
+            readonly error: v.ObjectSchema<{
+                readonly code: v.StringSchema<undefined>;
+                readonly message: v.StringSchema<undefined>;
+                readonly details: v.OptionalSchema<v.UnknownSchema, undefined>;
+                readonly issues: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+                    readonly path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly message: v.StringSchema<undefined>;
+                }, undefined>, undefined>, undefined>;
+            }, undefined>;
+        }, undefined>;
+        readonly '5xx': v.ObjectSchema<{
+            readonly error: v.ObjectSchema<{
+                readonly code: v.StringSchema<undefined>;
+                readonly message: v.StringSchema<undefined>;
+                readonly details: v.OptionalSchema<v.UnknownSchema, undefined>;
+                readonly issues: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+                    readonly path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly message: v.StringSchema<undefined>;
+                }, undefined>, undefined>, undefined>;
+            }, undefined>;
+        }, undefined>;
+        readonly 200: v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+            readonly blockId: v.StringSchema<undefined>;
+            readonly status: v.PicklistSchema<["ready", "incorporating", "reviewing", "merged", "exceeded", "incorporated"], undefined>;
+            readonly items: v.ArraySchema<v.ObjectSchema<{
+                readonly id: v.StringSchema<undefined>;
+                readonly category: v.PicklistSchema<["gap", "clarification", "assumption", "risk", "question"], undefined>;
+                readonly severity: v.PicklistSchema<["low", "medium", "high"], undefined>;
+                readonly title: v.StringSchema<undefined>;
+                readonly detail: v.StringSchema<undefined>;
+                readonly status: v.PicklistSchema<["open", "answered", "resolved", "dismissed", "recommend_requested"], undefined>;
+                readonly reply: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                readonly createdAt: v.NumberSchema<undefined>;
+                readonly updatedAt: v.NumberSchema<undefined>;
+            }, undefined>, undefined>;
+            readonly model: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly clarifiedReport: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly iteration: v.OptionalSchema<v.NumberSchema<undefined>, 1>;
+            readonly maxIterations: v.OptionalSchema<v.NumberSchema<undefined>, 1>;
+            readonly createdAt: v.NumberSchema<undefined>;
+            readonly updatedAt: v.NumberSchema<undefined>;
+        }, undefined>;
+    };
+};
+export declare const reReviewClarityContract: {
+    readonly method: "post";
+    readonly requestPathParamsSchema: v.ObjectSchema<{
+        readonly blockId: v.StringSchema<undefined>;
+    }, undefined> & import("@toad-contracts/core").ObjectKeysCarrier;
+    readonly pathResolver: ({ blockId }: {
+        blockId: string;
+    }) => string;
+    readonly requestBodySchema: typeof ContractNoBody;
+    readonly responsesByStatusCode: {
+        readonly '4xx': v.ObjectSchema<{
+            readonly error: v.ObjectSchema<{
+                readonly code: v.StringSchema<undefined>;
+                readonly message: v.StringSchema<undefined>;
+                readonly details: v.OptionalSchema<v.UnknownSchema, undefined>;
+                readonly issues: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+                    readonly path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly message: v.StringSchema<undefined>;
+                }, undefined>, undefined>, undefined>;
+            }, undefined>;
+        }, undefined>;
+        readonly '5xx': v.ObjectSchema<{
+            readonly error: v.ObjectSchema<{
+                readonly code: v.StringSchema<undefined>;
+                readonly message: v.StringSchema<undefined>;
+                readonly details: v.OptionalSchema<v.UnknownSchema, undefined>;
+                readonly issues: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+                    readonly path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly message: v.StringSchema<undefined>;
+                }, undefined>, undefined>, undefined>;
+            }, undefined>;
+        }, undefined>;
+        readonly 200: v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+            readonly blockId: v.StringSchema<undefined>;
+            readonly status: v.PicklistSchema<["ready", "incorporating", "reviewing", "merged", "exceeded", "incorporated"], undefined>;
+            readonly items: v.ArraySchema<v.ObjectSchema<{
+                readonly id: v.StringSchema<undefined>;
+                readonly category: v.PicklistSchema<["gap", "clarification", "assumption", "risk", "question"], undefined>;
+                readonly severity: v.PicklistSchema<["low", "medium", "high"], undefined>;
+                readonly title: v.StringSchema<undefined>;
+                readonly detail: v.StringSchema<undefined>;
+                readonly status: v.PicklistSchema<["open", "answered", "resolved", "dismissed", "recommend_requested"], undefined>;
+                readonly reply: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                readonly createdAt: v.NumberSchema<undefined>;
+                readonly updatedAt: v.NumberSchema<undefined>;
+            }, undefined>, undefined>;
+            readonly model: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly clarifiedReport: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly iteration: v.OptionalSchema<v.NumberSchema<undefined>, 1>;
+            readonly maxIterations: v.OptionalSchema<v.NumberSchema<undefined>, 1>;
+            readonly createdAt: v.NumberSchema<undefined>;
+            readonly updatedAt: v.NumberSchema<undefined>;
+        }, undefined>;
+    };
+};
+export declare const proceedClarityContract: {
+    readonly method: "post";
+    readonly requestPathParamsSchema: v.ObjectSchema<{
+        readonly blockId: v.StringSchema<undefined>;
+    }, undefined> & import("@toad-contracts/core").ObjectKeysCarrier;
+    readonly pathResolver: ({ blockId }: {
+        blockId: string;
+    }) => string;
+    readonly requestBodySchema: typeof ContractNoBody;
+    readonly responsesByStatusCode: {
+        readonly '4xx': v.ObjectSchema<{
+            readonly error: v.ObjectSchema<{
+                readonly code: v.StringSchema<undefined>;
+                readonly message: v.StringSchema<undefined>;
+                readonly details: v.OptionalSchema<v.UnknownSchema, undefined>;
+                readonly issues: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+                    readonly path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly message: v.StringSchema<undefined>;
+                }, undefined>, undefined>, undefined>;
+            }, undefined>;
+        }, undefined>;
+        readonly '5xx': v.ObjectSchema<{
+            readonly error: v.ObjectSchema<{
+                readonly code: v.StringSchema<undefined>;
+                readonly message: v.StringSchema<undefined>;
+                readonly details: v.OptionalSchema<v.UnknownSchema, undefined>;
+                readonly issues: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+                    readonly path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly message: v.StringSchema<undefined>;
+                }, undefined>, undefined>, undefined>;
+            }, undefined>;
+        }, undefined>;
+        readonly 200: v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+            readonly blockId: v.StringSchema<undefined>;
+            readonly status: v.PicklistSchema<["ready", "incorporating", "reviewing", "merged", "exceeded", "incorporated"], undefined>;
+            readonly items: v.ArraySchema<v.ObjectSchema<{
+                readonly id: v.StringSchema<undefined>;
+                readonly category: v.PicklistSchema<["gap", "clarification", "assumption", "risk", "question"], undefined>;
+                readonly severity: v.PicklistSchema<["low", "medium", "high"], undefined>;
+                readonly title: v.StringSchema<undefined>;
+                readonly detail: v.StringSchema<undefined>;
+                readonly status: v.PicklistSchema<["open", "answered", "resolved", "dismissed", "recommend_requested"], undefined>;
+                readonly reply: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                readonly createdAt: v.NumberSchema<undefined>;
+                readonly updatedAt: v.NumberSchema<undefined>;
+            }, undefined>, undefined>;
+            readonly model: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly clarifiedReport: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly iteration: v.OptionalSchema<v.NumberSchema<undefined>, 1>;
+            readonly maxIterations: v.OptionalSchema<v.NumberSchema<undefined>, 1>;
+            readonly createdAt: v.NumberSchema<undefined>;
+            readonly updatedAt: v.NumberSchema<undefined>;
+        }, undefined>;
+    };
+};
+export declare const resolveClarityExceededContract: {
+    readonly method: "post";
+    readonly requestPathParamsSchema: v.ObjectSchema<{
+        readonly blockId: v.StringSchema<undefined>;
+    }, undefined> & import("@toad-contracts/core").ObjectKeysCarrier;
+    readonly pathResolver: ({ blockId }: {
+        blockId: string;
+    }) => string;
+    readonly requestBodySchema: v.ObjectSchema<{
+        readonly choice: v.PicklistSchema<["extra-round", "proceed", "stop-reset"], undefined>;
+    }, undefined>;
+    readonly responsesByStatusCode: {
+        readonly '4xx': v.ObjectSchema<{
+            readonly error: v.ObjectSchema<{
+                readonly code: v.StringSchema<undefined>;
+                readonly message: v.StringSchema<undefined>;
+                readonly details: v.OptionalSchema<v.UnknownSchema, undefined>;
+                readonly issues: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+                    readonly path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly message: v.StringSchema<undefined>;
+                }, undefined>, undefined>, undefined>;
+            }, undefined>;
+        }, undefined>;
+        readonly '5xx': v.ObjectSchema<{
+            readonly error: v.ObjectSchema<{
+                readonly code: v.StringSchema<undefined>;
+                readonly message: v.StringSchema<undefined>;
+                readonly details: v.OptionalSchema<v.UnknownSchema, undefined>;
+                readonly issues: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+                    readonly path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly message: v.StringSchema<undefined>;
+                }, undefined>, undefined>, undefined>;
+            }, undefined>;
+        }, undefined>;
+        readonly 200: v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+            readonly blockId: v.StringSchema<undefined>;
+            readonly status: v.PicklistSchema<["ready", "incorporating", "reviewing", "merged", "exceeded", "incorporated"], undefined>;
+            readonly items: v.ArraySchema<v.ObjectSchema<{
+                readonly id: v.StringSchema<undefined>;
+                readonly category: v.PicklistSchema<["gap", "clarification", "assumption", "risk", "question"], undefined>;
+                readonly severity: v.PicklistSchema<["low", "medium", "high"], undefined>;
+                readonly title: v.StringSchema<undefined>;
+                readonly detail: v.StringSchema<undefined>;
+                readonly status: v.PicklistSchema<["open", "answered", "resolved", "dismissed", "recommend_requested"], undefined>;
+                readonly reply: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                readonly createdAt: v.NumberSchema<undefined>;
+                readonly updatedAt: v.NumberSchema<undefined>;
+            }, undefined>, undefined>;
+            readonly model: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly clarifiedReport: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly iteration: v.OptionalSchema<v.NumberSchema<undefined>, 1>;
+            readonly maxIterations: v.OptionalSchema<v.NumberSchema<undefined>, 1>;
+            readonly createdAt: v.NumberSchema<undefined>;
+            readonly updatedAt: v.NumberSchema<undefined>;
+        }, undefined>;
+    };
+};
+//# sourceMappingURL=clarity.d.ts.map

package/dist/routes/clarity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clarity.d.ts","sourceRoot":"","sources":["../../src/routes/clarity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAqC,MAAM,yBAAyB,CAAA;AAC3F,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAmB5B,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKnC,CAAA;AAEF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMhC,CAAA;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMnC,CAAA;AAEF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAM1C,CAAA;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMrC,CAAA;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMlC,CAAA;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMjC,CAAA;AAEF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMzC,CAAA"}

package/dist/routes/clarity.js

@@ -0,0 +1,67 @@
+import { ContractNoBody, defineApiContract, withObjectKeys } from '@toad-contracts/valibot';
+import * as v from 'valibot';
+import { clarityReviewSchema, incorporateClaritySchema, replyClarityItemSchema, resolveClarityExceededSchema, updateClarityItemStatusSchema, } from '../clarity.js';
+import { errorResponses } from './_shared.js';
+// ---------------------------------------------------------------------------
+// Clarity-review (bug-report triage) route contracts. Mounted under
+// `/workspaces/:workspaceId`, so the paths here are relative to that prefix. See
+// ClarityReviewController in @cat-factory/server.
+// ---------------------------------------------------------------------------
+const blockIdParams = withObjectKeys(v.object({ blockId: v.string() }));
+const reviewItemParams = withObjectKeys(v.object({ reviewId: v.string(), itemId: v.string() }));
+export const getClarityReviewContract = defineApiContract({
+    method: 'get',
+    requestPathParamsSchema: blockIdParams,
+    pathResolver: ({ blockId }) => `/blocks/${blockId}/clarity-review`,
+    responsesByStatusCode: { 200: v.nullable(clarityReviewSchema), ...errorResponses },
+});
+export const reviewClarityContract = defineApiContract({
+    method: 'post',
+    requestPathParamsSchema: blockIdParams,
+    pathResolver: ({ blockId }) => `/blocks/${blockId}/clarity-review`,
+    requestBodySchema: ContractNoBody,
+    responsesByStatusCode: { 201: clarityReviewSchema, ...errorResponses },
+});
+export const replyClarityItemContract = defineApiContract({
+    method: 'post',
+    requestPathParamsSchema: reviewItemParams,
+    pathResolver: ({ reviewId, itemId }) => `/clarity-reviews/${reviewId}/items/${itemId}/reply`,
+    requestBodySchema: replyClarityItemSchema,
+    responsesByStatusCode: { 200: clarityReviewSchema, ...errorResponses },
+});
+export const updateClarityItemStatusContract = defineApiContract({
+    method: 'patch',
+    requestPathParamsSchema: reviewItemParams,
+    pathResolver: ({ reviewId, itemId }) => `/clarity-reviews/${reviewId}/items/${itemId}`,
+    requestBodySchema: updateClarityItemStatusSchema,
+    responsesByStatusCode: { 200: clarityReviewSchema, ...errorResponses },
+});
+export const incorporateClarityContract = defineApiContract({
+    method: 'post',
+    requestPathParamsSchema: blockIdParams,
+    pathResolver: ({ blockId }) => `/blocks/${blockId}/clarity-review/incorporate`,
+    requestBodySchema: incorporateClaritySchema,
+    responsesByStatusCode: { 200: clarityReviewSchema, ...errorResponses },
+});
+export const reReviewClarityContract = defineApiContract({
+    method: 'post',
+    requestPathParamsSchema: blockIdParams,
+    pathResolver: ({ blockId }) => `/blocks/${blockId}/clarity-review/re-review`,
+    requestBodySchema: ContractNoBody,
+    responsesByStatusCode: { 200: clarityReviewSchema, ...errorResponses },
+});
+export const proceedClarityContract = defineApiContract({
+    method: 'post',
+    requestPathParamsSchema: blockIdParams,
+    pathResolver: ({ blockId }) => `/blocks/${blockId}/clarity-review/proceed`,
+    requestBodySchema: ContractNoBody,
+    responsesByStatusCode: { 200: clarityReviewSchema, ...errorResponses },
+});
+export const resolveClarityExceededContract = defineApiContract({
+    method: 'post',
+    requestPathParamsSchema: blockIdParams,
+    pathResolver: ({ blockId }) => `/blocks/${blockId}/clarity-review/resolve-exceeded`,
+    requestBodySchema: resolveClarityExceededSchema,
+    responsesByStatusCode: { 200: clarityReviewSchema, ...errorResponses },
+});
+//# sourceMappingURL=clarity.js.map

package/dist/routes/clarity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clarity.js","sourceRoot":"","sources":["../../src/routes/clarity.ts"],"names":[],"mappings":"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"}

package/dist/routes/consensus.d.ts

@@ -0,0 +1,71 @@
+import * as v from 'valibot';
+export declare const getConsensusSessionContract: {
+    readonly method: "get";
+    readonly requestPathParamsSchema: v.ObjectSchema<{
+        readonly blockId: v.StringSchema<undefined>;
+    }, undefined> & import("@toad-contracts/core").ObjectKeysCarrier;
+    readonly pathResolver: ({ blockId }: {
+        blockId: string;
+    }) => string;
+    readonly responsesByStatusCode: {
+        readonly '4xx': v.ObjectSchema<{
+            readonly error: v.ObjectSchema<{
+                readonly code: v.StringSchema<undefined>;
+                readonly message: v.StringSchema<undefined>;
+                readonly details: v.OptionalSchema<v.UnknownSchema, undefined>;
+                readonly issues: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+                    readonly path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly message: v.StringSchema<undefined>;
+                }, undefined>, undefined>, undefined>;
+            }, undefined>;
+        }, undefined>;
+        readonly '5xx': v.ObjectSchema<{
+            readonly error: v.ObjectSchema<{
+                readonly code: v.StringSchema<undefined>;
+                readonly message: v.StringSchema<undefined>;
+                readonly details: v.OptionalSchema<v.UnknownSchema, undefined>;
+                readonly issues: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+                    readonly path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly message: v.StringSchema<undefined>;
+                }, undefined>, undefined>, undefined>;
+            }, undefined>;
+        }, undefined>;
+        readonly 200: v.ObjectSchema<{
+            readonly session: v.NullableSchema<v.ObjectSchema<{
+                readonly id: v.StringSchema<undefined>;
+                readonly blockId: v.StringSchema<undefined>;
+                readonly executionId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                readonly stepIndex: v.NumberSchema<undefined>;
+                readonly agentKind: v.StringSchema<undefined>;
+                readonly strategy: v.PicklistSchema<["specialist-panel", "debate", "ranked-voting"], undefined>;
+                readonly status: v.PicklistSchema<["running", "synthesizing", "done", "failed"], undefined>;
+                readonly participants: v.ArraySchema<v.ObjectSchema<{
+                    readonly id: v.StringSchema<undefined>;
+                    readonly role: v.StringSchema<undefined>;
+                    readonly systemFraming: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly modelId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                }, undefined>, undefined>;
+                readonly rounds: v.ArraySchema<v.ObjectSchema<{
+                    readonly index: v.NumberSchema<undefined>;
+                    readonly kind: v.OptionalSchema<v.PicklistSchema<["draft", "critique", "score"], undefined>, undefined>;
+                    readonly contributions: v.ArraySchema<v.ObjectSchema<{
+                        readonly participantId: v.StringSchema<undefined>;
+                        readonly text: v.StringSchema<undefined>;
+                        readonly scores: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+                            readonly dimension: v.StringSchema<undefined>;
+                            readonly value: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+                            readonly rationale: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                        }, undefined>, undefined>, undefined>;
+                    }, undefined>, undefined>;
+                }, undefined>, undefined>;
+                readonly synthesis: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                readonly confidence: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+                readonly dissent: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+                readonly error: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+                readonly createdAt: v.NumberSchema<undefined>;
+                readonly updatedAt: v.NumberSchema<undefined>;
+            }, undefined>, undefined>;
+        }, undefined>;
+    };
+};
+//# sourceMappingURL=consensus.d.ts.map

package/dist/routes/consensus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consensus.d.ts","sourceRoot":"","sources":["../../src/routes/consensus.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAmB5B,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKtC,CAAA"}

package/dist/routes/consensus.js

@@ -0,0 +1,23 @@
+import { defineApiContract, withObjectKeys } from '@toad-contracts/valibot';
+import * as v from 'valibot';
+import { consensusSessionSchema } from '../consensus.js';
+import { errorResponses } from './_shared.js';
+// ---------------------------------------------------------------------------
+// Read-only consensus route contracts. Mounted under `/workspaces/:workspaceId`,
+// so the paths here are relative to that prefix. The single route loads the most
+// recent consensus session for a block; it always 200s with `{ session: null }`
+// when consensus is off or no session has run. See ConsensusController in
+// @cat-factory/server.
+// ---------------------------------------------------------------------------
+const blockIdParams = withObjectKeys(v.object({ blockId: v.string() }));
+/** The `{ session }` envelope the read route returns (session null when none). */
+const consensusSessionResponseSchema = v.object({
+    session: v.nullable(consensusSessionSchema),
+});
+export const getConsensusSessionContract = defineApiContract({
+    method: 'get',
+    requestPathParamsSchema: blockIdParams,
+    pathResolver: ({ blockId }) => `/blocks/${blockId}/consensus-session`,
+    responsesByStatusCode: { 200: consensusSessionResponseSchema, ...errorResponses },
+});
+//# sourceMappingURL=consensus.js.map

package/dist/routes/consensus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consensus.js","sourceRoot":"","sources":["../../src/routes/consensus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC3E,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAE7C,8EAA8E;AAC9E,iFAAiF;AACjF,iFAAiF;AACjF,gFAAgF;AAChF,0EAA0E;AAC1E,uBAAuB;AACvB,8EAA8E;AAE9E,MAAM,aAAa,GAAG,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAA;AAEvE,kFAAkF;AAClF,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC;CAC5C,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG,iBAAiB,CAAC;IAC3D,MAAM,EAAE,KAAK;IACb,uBAAuB,EAAE,aAAa;IACtC,YAAY,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,WAAW,OAAO,oBAAoB;IACrE,qBAAqB,EAAE,EAAE,GAAG,EAAE,8BAA8B,EAAE,GAAG,cAAc,EAAE;CAClF,CAAC,CAAA"}