@cat-factory/contracts 0.34.0 → 0.35.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../src/routes/github.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAqC,MAAM,yBAAyB,CAAA;AAC3F,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AA4D5B,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAItC,CAAA;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAItC,CAAA;AAEF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAI1C,CAAA;AAEF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKhC,CAAA;AAEF,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAI3C,CAAA;AAEF,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKvC,CAAA;AAEF,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMxC,CAAA;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMrC,CAAA;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAInC,CAAA;AAIF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAK/B,CAAA;AAIF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAIlC,CAAA;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKrC,CAAA;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAIlC,CAAA;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAInC,CAAA;AAIF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKnC,CAAA;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMrC,CAAA;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMpC,CAAA;AAEF,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMxC,CAAA;AAEF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMzC,CAAA;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAOrC,CAAA"}

package/dist/routes/github.js

@@ -0,0 +1,157 @@
+import { ContractNoBody, defineApiContract, withObjectKeys } from '@toad-contracts/valibot';
+import * as v from 'valibot';
+import { commentSchema, commitFilesSchema, createBranchSchema, createRepoRequestSchema, githubAvailableRepoSchema, githubBranchSchema, githubConnectionSchema, githubInstallationOptionSchema, githubIssueSchema, githubPullRequestSchema, githubRepoSchema, linkReposSchema, mergePullRequestSchema, openPullRequestSchema, provisionedRepoSchema, repoTreeEntrySchema, resyncRequestSchema, setRepoMonorepoSchema, } from '../github.js';
+import { errorResponses } from './_shared.js';
+// ---------------------------------------------------------------------------
+// Workspace-scoped GitHub route contracts. Mounted under `/workspaces/:workspaceId`,
+// so the paths here are relative to that prefix. See GitHubController.
+// ---------------------------------------------------------------------------
+// Programmatic bind body — exists only inline in the controller today.
+const connectSchema = v.object({ installationId: v.number() });
+// Response wrappers that exist only inline in the controller today.
+const installUrlSchema = v.object({ url: v.string() });
+const connectionViewSchema = v.object({ connection: v.nullable(githubConnectionSchema) });
+const installationsViewSchema = v.object({
+    installations: v.array(githubInstallationOptionSchema),
+});
+const availableReposViewSchema = v.array(githubAvailableRepoSchema);
+const repoTreeViewSchema = v.array(repoTreeEntrySchema);
+const repoListSchema = v.array(githubRepoSchema);
+const branchListSchema = v.array(githubBranchSchema);
+const pullRequestListSchema = v.array(githubPullRequestSchema);
+const issueListSchema = v.array(githubIssueSchema);
+const repoProjectionListSchema = v.array(githubRepoSchema);
+const commitResultSchema = v.object({ sha: v.string() });
+// The createRepo success body is a freshly-provisioned repo; `provisionedRepoSchema`
+// (imported from `../github.js`) is the shared source of truth that the kernel
+// `ProvisionedRepo` port type also derives from.
+// The resync endpoint returns a `{ status }` envelope across both 200 and 202.
+const resyncResultSchema = v.object({
+    status: v.picklist(['backfill_started', 'backfilled', 'queued', 'synced']),
+});
+const repoGithubIdParams = withObjectKeys(v.object({ repoGithubId: v.string() }));
+const repoPullNumberParams = withObjectKeys(v.object({ repoGithubId: v.string(), number: v.string() }));
+// ---- connection -----------------------------------------------------------
+export const getGitHubInstallUrlContract = defineApiContract({
+    method: 'get',
+    pathResolver: () => '/github/install-url',
+    responsesByStatusCode: { 200: installUrlSchema, ...errorResponses },
+});
+export const getGitHubConnectionContract = defineApiContract({
+    method: 'get',
+    pathResolver: () => '/github/connection',
+    responsesByStatusCode: { 200: connectionViewSchema, ...errorResponses },
+});
+export const listGitHubInstallationsContract = defineApiContract({
+    method: 'get',
+    pathResolver: () => '/github/installations',
+    responsesByStatusCode: { 200: installationsViewSchema, ...errorResponses },
+});
+export const connectGitHubContract = defineApiContract({
+    method: 'post',
+    pathResolver: () => '/github/connect',
+    requestBodySchema: connectSchema,
+    responsesByStatusCode: { 201: githubConnectionSchema, ...errorResponses },
+});
+export const listGitHubAvailableReposContract = defineApiContract({
+    method: 'get',
+    pathResolver: () => '/github/available-repos',
+    responsesByStatusCode: { 200: availableReposViewSchema, ...errorResponses },
+});
+export const setGitHubLinkedReposContract = defineApiContract({
+    method: 'put',
+    pathResolver: () => '/github/repos',
+    requestBodySchema: linkReposSchema,
+    responsesByStatusCode: { 200: repoListSchema, ...errorResponses },
+});
+export const setGitHubRepoMonorepoContract = defineApiContract({
+    method: 'patch',
+    requestPathParamsSchema: repoGithubIdParams,
+    pathResolver: ({ repoGithubId }) => `/github/repos/${repoGithubId}`,
+    requestBodySchema: setRepoMonorepoSchema,
+    responsesByStatusCode: { 200: githubRepoSchema, ...errorResponses },
+});
+export const listGitHubRepoTreeContract = defineApiContract({
+    method: 'get',
+    requestPathParamsSchema: repoGithubIdParams,
+    pathResolver: ({ repoGithubId }) => `/github/repos/${repoGithubId}/tree`,
+    requestQuerySchema: v.object({ path: v.optional(v.string()) }),
+    responsesByStatusCode: { 200: repoTreeViewSchema, ...errorResponses },
+});
+export const disconnectGitHubContract = defineApiContract({
+    method: 'delete',
+    pathResolver: () => '/github/connection',
+    responsesByStatusCode: { 204: ContractNoBody, ...errorResponses },
+});
+// ---- resync ---------------------------------------------------------------
+export const resyncGitHubContract = defineApiContract({
+    method: 'post',
+    pathResolver: () => '/github/resync',
+    requestBodySchema: resyncRequestSchema,
+    responsesByStatusCode: { 200: resyncResultSchema, 202: resyncResultSchema, ...errorResponses },
+});
+// ---- projection reads -----------------------------------------------------
+export const listGitHubReposContract = defineApiContract({
+    method: 'get',
+    pathResolver: () => '/github/repos',
+    responsesByStatusCode: { 200: repoProjectionListSchema, ...errorResponses },
+});
+export const listGitHubBranchesContract = defineApiContract({
+    method: 'get',
+    requestPathParamsSchema: repoGithubIdParams,
+    pathResolver: ({ repoGithubId }) => `/github/repos/${repoGithubId}/branches`,
+    responsesByStatusCode: { 200: branchListSchema, ...errorResponses },
+});
+export const listGitHubPullsContract = defineApiContract({
+    method: 'get',
+    pathResolver: () => '/github/pulls',
+    responsesByStatusCode: { 200: pullRequestListSchema, ...errorResponses },
+});
+export const listGitHubIssuesContract = defineApiContract({
+    method: 'get',
+    pathResolver: () => '/github/issues',
+    responsesByStatusCode: { 200: issueListSchema, ...errorResponses },
+});
+// ---- writes ---------------------------------------------------------------
+export const createGitHubRepoContract = defineApiContract({
+    method: 'post',
+    pathResolver: () => '/github/repos',
+    requestBodySchema: createRepoRequestSchema,
+    responsesByStatusCode: { 201: provisionedRepoSchema, ...errorResponses },
+});
+export const createGitHubBranchContract = defineApiContract({
+    method: 'post',
+    requestPathParamsSchema: repoGithubIdParams,
+    pathResolver: ({ repoGithubId }) => `/github/repos/${repoGithubId}/branches`,
+    requestBodySchema: createBranchSchema,
+    responsesByStatusCode: { 201: githubBranchSchema, ...errorResponses },
+});
+export const commitGitHubFilesContract = defineApiContract({
+    method: 'post',
+    requestPathParamsSchema: repoGithubIdParams,
+    pathResolver: ({ repoGithubId }) => `/github/repos/${repoGithubId}/commits`,
+    requestBodySchema: commitFilesSchema,
+    responsesByStatusCode: { 201: commitResultSchema, ...errorResponses },
+});
+export const openGitHubPullRequestContract = defineApiContract({
+    method: 'post',
+    requestPathParamsSchema: repoGithubIdParams,
+    pathResolver: ({ repoGithubId }) => `/github/repos/${repoGithubId}/pulls`,
+    requestBodySchema: openPullRequestSchema,
+    responsesByStatusCode: { 201: githubPullRequestSchema, ...errorResponses },
+});
+export const mergeGitHubPullRequestContract = defineApiContract({
+    method: 'put',
+    requestPathParamsSchema: repoPullNumberParams,
+    pathResolver: ({ repoGithubId, number }) => `/github/repos/${repoGithubId}/pulls/${number}/merge`,
+    requestBodySchema: mergePullRequestSchema,
+    responsesByStatusCode: { 204: ContractNoBody, ...errorResponses },
+});
+export const commentGitHubIssueContract = defineApiContract({
+    method: 'post',
+    requestPathParamsSchema: repoPullNumberParams,
+    pathResolver: ({ repoGithubId, number }) => `/github/repos/${repoGithubId}/issues/${number}/comments`,
+    requestBodySchema: commentSchema,
+    responsesByStatusCode: { 204: ContractNoBody, ...errorResponses },
+});
+//# sourceMappingURL=github.js.map

package/dist/routes/github.js.map

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

package/dist/routes/human-review.d.ts

@@ -0,0 +1,290 @@
+import * as v from 'valibot';
+export declare const requestHumanReviewFixContract: {
+    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 instructions: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, 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 pipelineId: v.StringSchema<undefined>;
+            readonly pipelineName: v.StringSchema<undefined>;
+            readonly steps: v.ArraySchema<v.ObjectSchema<{
+                readonly runId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly agentKind: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+                readonly state: v.PicklistSchema<["pending", "working", "waiting_decision", "done"], undefined>;
+                readonly progress: v.NumberSchema<undefined>;
+                readonly metrics: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+                    readonly calls: v.NumberSchema<undefined>;
+                    readonly promptTokens: v.NumberSchema<undefined>;
+                    readonly completionTokens: v.NumberSchema<undefined>;
+                    readonly peakCompletionTokens: v.NumberSchema<undefined>;
+                    readonly maxOutputTokens: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+                    readonly truncatedCalls: v.NumberSchema<undefined>;
+                    readonly upstreamMs: v.NumberSchema<undefined>;
+                    readonly overheadMs: v.NumberSchema<undefined>;
+                    readonly errors: v.NumberSchema<undefined>;
+                    readonly warnings: v.NumberSchema<undefined>;
+                }, undefined>, undefined>, undefined>;
+                readonly gate: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+                    readonly phase: v.PicklistSchema<["checking", "working"], undefined>;
+                    readonly attempts: v.NumberSchema<undefined>;
+                    readonly maxAttempts: v.NumberSchema<undefined>;
+                    readonly headSha: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+                    readonly lastVerdict: v.OptionalSchema<v.NullableSchema<v.PicklistSchema<["pass", "pending", "fail"], undefined>, undefined>, undefined>;
+                    readonly lastFailureSummary: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+                    readonly failingChecks: v.OptionalSchema<v.NullableSchema<v.ArraySchema<v.ObjectSchema<{
+                        readonly name: v.StringSchema<undefined>;
+                        readonly conclusion: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                        readonly url: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+                    }, undefined>, undefined>, undefined>, undefined>;
+                    readonly watchSince: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+                    readonly watchWindowMinutes: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+                    readonly regressedSignals: v.OptionalSchema<v.NullableSchema<v.ArraySchema<v.ObjectSchema<{
+                        readonly kind: v.PicklistSchema<["monitor", "slo"], undefined>;
+                        readonly id: v.StringSchema<undefined>;
+                        readonly name: v.StringSchema<undefined>;
+                        readonly state: v.PicklistSchema<["ok", "warn", "alert", "no_data"], undefined>;
+                        readonly detail: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    }, undefined>, undefined>, undefined>, undefined>;
+                    readonly attemptLog: v.OptionalSchema<v.NullableSchema<v.ArraySchema<v.ObjectSchema<{
+                        readonly attempt: v.NumberSchema<undefined>;
+                        readonly at: v.NumberSchema<undefined>;
+                        readonly outcome: v.PicklistSchema<["completed", "failed"], undefined>;
+                        readonly headSha: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+                        readonly summary: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+                    }, undefined>, undefined>, undefined>, undefined>;
+                    readonly lastApprovals: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+                    readonly requiredApprovingReviewCount: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+                    readonly pendingThreadIds: v.OptionalSchema<v.NullableSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>, undefined>;
+                    readonly lastAddressedCommentAt: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+                    readonly humanReviewGraceMinutes: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+                    readonly pendingFix: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+                        readonly instructions: v.StringSchema<undefined>;
+                        readonly at: v.NumberSchema<undefined>;
+                    }, undefined>, undefined>, undefined>;
+                }, undefined>, undefined>, undefined>;
+                readonly test: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+                    readonly phase: v.PicklistSchema<["testing", "fixing"], undefined>;
+                    readonly attempts: v.NumberSchema<undefined>;
+                    readonly maxAttempts: v.NumberSchema<undefined>;
+                    readonly lastReport: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+                        readonly greenlight: v.BooleanSchema<undefined>;
+                        readonly summary: v.StringSchema<undefined>;
+                        readonly tested: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+                        readonly outcomes: v.ArraySchema<v.ObjectSchema<{
+                            readonly name: v.StringSchema<undefined>;
+                            readonly status: v.PicklistSchema<["passed", "failed", "skipped"], undefined>;
+                            readonly detail: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                        }, undefined>, undefined>;
+                        readonly concerns: v.ArraySchema<v.ObjectSchema<{
+                            readonly title: v.StringSchema<undefined>;
+                            readonly detail: v.StringSchema<undefined>;
+                            readonly severity: v.PicklistSchema<["low", "medium", "high", "critical"], undefined>;
+                        }, undefined>, undefined>;
+                        readonly environment: v.OptionalSchema<v.PicklistSchema<["local", "ephemeral"], undefined>, undefined>;
+                    }, undefined>, undefined>, undefined>;
+                }, undefined>, undefined>, undefined>;
+                readonly humanTest: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+                    readonly phase: v.PicklistSchema<["provisioning", "awaiting_human", "fixing", "resolving_conflicts", "passed"], undefined>;
+                    readonly environment: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+                        readonly id: v.StringSchema<undefined>;
+                        readonly url: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                        readonly status: v.PicklistSchema<["provisioning", "ready", "failed", "expired", "tearing_down", "torn_down"], undefined>;
+                        readonly expiresAt: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+                    }, undefined>, undefined>, undefined>;
+                    readonly degradedReason: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+                    readonly attempts: v.NumberSchema<undefined>;
+                    readonly maxAttempts: v.NumberSchema<undefined>;
+                    readonly headSha: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+                    readonly rounds: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+                        readonly kind: v.PicklistSchema<["fix", "pull-main"], undefined>;
+                        readonly findings: v.StringSchema<undefined>;
+                        readonly helperKind: v.StringSchema<undefined>;
+                        readonly jobId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+                        readonly outcome: v.OptionalSchema<v.NullableSchema<v.PicklistSchema<["completed", "failed"], undefined>, undefined>, undefined>;
+                        readonly at: v.NumberSchema<undefined>;
+                    }, undefined>, undefined>, undefined>;
+                    readonly pendingAction: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+                        readonly type: v.PicklistSchema<["confirm", "request-fix", "pull-main", "recreate"], undefined>;
+                        readonly findings: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    }, undefined>, undefined>, undefined>;
+                }, undefined>, undefined>, undefined>;
+                readonly environment: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+                    readonly id: v.StringSchema<undefined>;
+                    readonly url: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                    readonly status: v.PicklistSchema<["provisioning", "ready", "failed", "expired", "tearing_down", "torn_down"], undefined>;
+                    readonly expiresAt: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+                    readonly lastError: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+                }, undefined>, undefined>, undefined>;
+                readonly subtasks: v.OptionalSchema<v.ObjectSchema<{
+                    readonly completed: v.NumberSchema<undefined>;
+                    readonly inProgress: v.NumberSchema<undefined>;
+                    readonly total: v.NumberSchema<undefined>;
+                    readonly items: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+                        readonly label: v.StringSchema<undefined>;
+                        readonly status: v.PicklistSchema<["pending", "in_progress", "completed"], undefined>;
+                    }, undefined>, undefined>, undefined>;
+                }, undefined>, undefined>;
+                readonly startingContainer: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly decision: v.NullableSchema<v.ObjectSchema<{
+                    readonly id: v.StringSchema<undefined>;
+                    readonly question: v.StringSchema<undefined>;
+                    readonly options: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+                    readonly chosen: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                }, undefined>, undefined>;
+                readonly requiresApproval: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly approval: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+                    readonly id: v.StringSchema<undefined>;
+                    readonly status: v.PicklistSchema<["pending", "approved", "changes_requested", "rejected"], undefined>;
+                    readonly proposal: v.StringSchema<undefined>;
+                    readonly feedback: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly comments: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+                        readonly quotedSource: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                        readonly srcStart: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+                        readonly srcEnd: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+                        readonly anchorId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                        readonly body: v.StringSchema<undefined>;
+                    }, undefined>, undefined>, undefined>;
+                }, undefined>, undefined>, undefined>;
+                readonly companion: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+                    readonly threshold: v.NumberSchema<undefined>;
+                    readonly maxAttempts: v.NumberSchema<undefined>;
+                    readonly attempts: v.OptionalSchema<v.NumberSchema<undefined>, 0>;
+                    readonly verdicts: v.ArraySchema<v.ObjectSchema<{
+                        readonly rating: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+                        readonly threshold: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+                        readonly passed: v.BooleanSchema<undefined>;
+                        readonly feedback: v.StringSchema<undefined>;
+                    }, undefined>, undefined>;
+                    readonly exceeded: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                }, undefined>, undefined>, undefined>;
+                readonly followUps: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+                    readonly enabled: v.BooleanSchema<undefined>;
+                    readonly items: v.ArraySchema<v.ObjectSchema<{
+                        readonly id: v.StringSchema<undefined>;
+                        readonly kind: v.PicklistSchema<["follow_up", "question"], undefined>;
+                        readonly title: v.StringSchema<undefined>;
+                        readonly detail: v.StringSchema<undefined>;
+                        readonly suggestedAction: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+                        readonly status: v.PicklistSchema<["pending", "filed", "queued", "answered", "dismissed"], undefined>;
+                        readonly answer: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+                        readonly sentToCoder: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                        readonly ticketExternalId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+                        readonly ticketUrl: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+                        readonly createdAt: v.NumberSchema<undefined>;
+                        readonly updatedAt: v.NumberSchema<undefined>;
+                    }, undefined>, undefined>;
+                    readonly loops: v.OptionalSchema<v.NumberSchema<undefined>, 0>;
+                    readonly maxLoops: v.OptionalSchema<v.NumberSchema<undefined>, 3>;
+                }, undefined>, undefined>, undefined>;
+                readonly rework: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+                    readonly previousProposal: v.StringSchema<undefined>;
+                    readonly feedback: v.StringSchema<undefined>;
+                    readonly comments: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+                        readonly quotedSource: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                        readonly srcStart: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+                        readonly srcEnd: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+                        readonly anchorId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                        readonly body: v.StringSchema<undefined>;
+                    }, undefined>, undefined>, undefined>;
+                }, undefined>, undefined>, undefined>;
+                readonly pendingIncorporation: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+                    readonly feedback: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                }, undefined>, undefined>, undefined>;
+                readonly pendingRecommendation: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+                    readonly itemIds: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+                    readonly note: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                }, undefined>, undefined>, undefined>;
+                readonly consensus: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+                    readonly enabled: v.BooleanSchema<undefined>;
+                    readonly strategy: v.PicklistSchema<["specialist-panel", "debate", "ranked-voting"], 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 synthesizerModelId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly rounds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 5, undefined>]>, undefined>;
+                    readonly gating: v.OptionalSchema<v.ObjectSchema<{
+                        readonly enabled: v.BooleanSchema<undefined>;
+                        readonly minComplexity: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>;
+                        readonly minRisk: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>;
+                        readonly minImpact: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>;
+                        readonly onMissingEstimate: v.OptionalSchema<v.PicklistSchema<["consensus", "standard"], undefined>, "consensus">;
+                    }, undefined>, undefined>;
+                }, undefined>, undefined>, undefined>;
+                readonly gating: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+                    readonly enabled: v.BooleanSchema<undefined>;
+                    readonly minComplexity: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>;
+                    readonly minRisk: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>;
+                    readonly minImpact: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>;
+                    readonly onMissingEstimate: v.OptionalSchema<v.PicklistSchema<["run", "skip"], undefined>, "run">;
+                }, undefined>, undefined>, undefined>;
+                readonly skipped: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly noBusinessSpecs: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly technicalCorroborated: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly output: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly custom: v.OptionalSchema<v.UnknownSchema, undefined>;
+                readonly model: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly selectedFragmentIds: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+                readonly jobId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly startedAt: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+                readonly finishedAt: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+                readonly pausedAt: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+                readonly evictionRecoveries: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+                readonly transientEvictionRecoveries: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+            }, undefined>, undefined>;
+            readonly currentStep: v.NumberSchema<undefined>;
+            readonly status: v.PicklistSchema<["running", "blocked", "done", "paused", "failed"], undefined>;
+            readonly failure: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+                readonly kind: v.PicklistSchema<["preflight", "dispatch", "evicted", "timeout", "agent", "job_failed", "rejected", "companion_rejected", "cancelled", "unknown"], undefined>;
+                readonly message: v.StringSchema<undefined>;
+                readonly detail: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                readonly hint: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                readonly occurredAt: v.NumberSchema<undefined>;
+                readonly lastSubtasks: v.NullableSchema<v.ObjectSchema<{
+                    readonly completed: v.NumberSchema<undefined>;
+                    readonly inProgress: v.NumberSchema<undefined>;
+                    readonly total: v.NumberSchema<undefined>;
+                    readonly items: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+                        readonly label: v.StringSchema<undefined>;
+                        readonly status: v.PicklistSchema<["pending", "in_progress", "completed"], undefined>;
+                    }, undefined>, undefined>, undefined>;
+                }, undefined>, undefined>;
+            }, undefined>, undefined>, undefined>;
+            readonly initiatedBy: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        }, undefined>;
+    };
+};
+//# sourceMappingURL=human-review.d.ts.map

package/dist/routes/human-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"human-review.d.ts","sourceRoot":"","sources":["../../src/routes/human-review.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAc5B,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMxC,CAAA"}

package/dist/routes/human-review.js

@@ -0,0 +1,20 @@
+import { defineApiContract, withObjectKeys } from '@toad-contracts/valibot';
+import * as v from 'valibot';
+import { executionInstanceSchema } from '../entities.js';
+import { requestHumanReviewFixSchema } from '../human-review.js';
+import { errorResponses } from './_shared.js';
+// ---------------------------------------------------------------------------
+// Human-review gate route contracts. Mounted under `/workspaces/:workspaceId`,
+// so the paths here are relative to that prefix. The single route drives the
+// block's parked `human-review` step and returns the updated execution instance.
+// See HumanReviewController in @cat-factory/server.
+// ---------------------------------------------------------------------------
+const blockIdParams = withObjectKeys(v.object({ blockId: v.string() }));
+export const requestHumanReviewFixContract = defineApiContract({
+    method: 'post',
+    requestPathParamsSchema: blockIdParams,
+    pathResolver: ({ blockId }) => `/blocks/${blockId}/human-review/request-fix`,
+    requestBodySchema: requestHumanReviewFixSchema,
+    responsesByStatusCode: { 200: executionInstanceSchema, ...errorResponses },
+});
+//# sourceMappingURL=human-review.js.map

package/dist/routes/human-review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"human-review.js","sourceRoot":"","sources":["../../src/routes/human-review.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC3E,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AACxD,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAA;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAE7C,8EAA8E;AAC9E,+EAA+E;AAC/E,6EAA6E;AAC7E,iFAAiF;AACjF,oDAAoD;AACpD,8EAA8E;AAE9E,MAAM,aAAa,GAAG,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAA;AAEvE,MAAM,CAAC,MAAM,6BAA6B,GAAG,iBAAiB,CAAC;IAC7D,MAAM,EAAE,MAAM;IACd,uBAAuB,EAAE,aAAa;IACtC,YAAY,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,WAAW,OAAO,2BAA2B;IAC5E,iBAAiB,EAAE,2BAA2B;IAC9C,qBAAqB,EAAE,EAAE,GAAG,EAAE,uBAAuB,EAAE,GAAG,cAAc,EAAE;CAC3E,CAAC,CAAA"}