@cat-factory/contracts 0.33.0 → 0.35.0

package/dist/routes/model-presets.js

@@ -0,0 +1,36 @@
+import { ContractNoBody, defineApiContract, withObjectKeys } from '@toad-contracts/valibot';
+import * as v from 'valibot';
+import { createModelPresetSchema, modelPresetSchema, updateModelPresetSchema, } from '../model-presets.js';
+import { errorResponses } from './_shared.js';
+// ---------------------------------------------------------------------------
+// Model preset route contracts. Mounted under `/workspaces/:workspaceId`, so the
+// paths here are relative to that prefix. See ModelPresetController in
+// @cat-factory/server.
+// ---------------------------------------------------------------------------
+const modelPresetListSchema = v.array(modelPresetSchema);
+const presetIdParams = withObjectKeys(v.object({ presetId: v.string() }));
+export const listModelPresetsContract = defineApiContract({
+    method: 'get',
+    pathResolver: () => '/model-presets',
+    responsesByStatusCode: { 200: modelPresetListSchema, ...errorResponses },
+});
+export const createModelPresetContract = defineApiContract({
+    method: 'post',
+    pathResolver: () => '/model-presets',
+    requestBodySchema: createModelPresetSchema,
+    responsesByStatusCode: { 201: modelPresetSchema, ...errorResponses },
+});
+export const updateModelPresetContract = defineApiContract({
+    method: 'patch',
+    requestPathParamsSchema: presetIdParams,
+    pathResolver: ({ presetId }) => `/model-presets/${presetId}`,
+    requestBodySchema: updateModelPresetSchema,
+    responsesByStatusCode: { 200: modelPresetSchema, ...errorResponses },
+});
+export const deleteModelPresetContract = defineApiContract({
+    method: 'delete',
+    requestPathParamsSchema: presetIdParams,
+    pathResolver: ({ presetId }) => `/model-presets/${presetId}`,
+    responsesByStatusCode: { 204: ContractNoBody, ...errorResponses },
+});
+//# sourceMappingURL=model-presets.js.map

package/dist/routes/model-presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-presets.js","sourceRoot":"","sources":["../../src/routes/model-presets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC3F,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAE7C,8EAA8E;AAC9E,iFAAiF;AACjF,uEAAuE;AACvE,uBAAuB;AACvB,8EAA8E;AAE9E,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAA;AACxD,MAAM,cAAc,GAAG,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAA;AAEzE,MAAM,CAAC,MAAM,wBAAwB,GAAG,iBAAiB,CAAC;IACxD,MAAM,EAAE,KAAK;IACb,YAAY,EAAE,GAAG,EAAE,CAAC,gBAAgB;IACpC,qBAAqB,EAAE,EAAE,GAAG,EAAE,qBAAqB,EAAE,GAAG,cAAc,EAAE;CACzE,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG,iBAAiB,CAAC;IACzD,MAAM,EAAE,MAAM;IACd,YAAY,EAAE,GAAG,EAAE,CAAC,gBAAgB;IACpC,iBAAiB,EAAE,uBAAuB;IAC1C,qBAAqB,EAAE,EAAE,GAAG,EAAE,iBAAiB,EAAE,GAAG,cAAc,EAAE;CACrE,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG,iBAAiB,CAAC;IACzD,MAAM,EAAE,OAAO;IACf,uBAAuB,EAAE,cAAc;IACvC,YAAY,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,kBAAkB,QAAQ,EAAE;IAC5D,iBAAiB,EAAE,uBAAuB;IAC1C,qBAAqB,EAAE,EAAE,GAAG,EAAE,iBAAiB,EAAE,GAAG,cAAc,EAAE;CACrE,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG,iBAAiB,CAAC;IACzD,MAAM,EAAE,QAAQ;IAChB,uBAAuB,EAAE,cAAc;IACvC,YAAY,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,kBAAkB,QAAQ,EAAE;IAC5D,qBAAqB,EAAE,EAAE,GAAG,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE;CAClE,CAAC,CAAA"}

package/dist/routes/models.d.ts

@@ -0,0 +1,123 @@
+import * as v from 'valibot';
+export declare const listModelsContract: {
+    readonly method: "get";
+    readonly pathResolver: () => 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.ArraySchema<v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+            readonly label: v.StringSchema<undefined>;
+            readonly description: v.StringSchema<undefined>;
+            readonly flavor: v.PicklistSchema<["cloudflare", "direct", "openrouter", "subscription"], undefined>;
+            readonly available: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+            readonly providerLabel: v.StringSchema<undefined>;
+            readonly provider: v.StringSchema<undefined>;
+            readonly model: v.StringSchema<undefined>;
+            readonly vendor: v.OptionalSchema<v.PicklistSchema<["claude", "codex", "glm", "kimi", "deepseek"], undefined>, undefined>;
+            readonly cost: v.OptionalSchema<v.ObjectSchema<{
+                readonly inputPerMillion: v.NumberSchema<undefined>;
+                readonly outputPerMillion: v.NumberSchema<undefined>;
+                readonly currency: v.StringSchema<undefined>;
+            }, undefined>, undefined>;
+            readonly contextTokens: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+            readonly quotaBased: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+            readonly subscription: v.OptionalSchema<v.ObjectSchema<{
+                readonly vendor: v.PicklistSchema<["claude", "codex", "glm", "kimi", "deepseek"], undefined>;
+                readonly providerLabel: v.StringSchema<undefined>;
+                readonly provider: v.StringSchema<undefined>;
+                readonly model: v.StringSchema<undefined>;
+                readonly cost: v.OptionalSchema<v.ObjectSchema<{
+                    readonly inputPerMillion: v.NumberSchema<undefined>;
+                    readonly outputPerMillion: v.NumberSchema<undefined>;
+                    readonly currency: v.StringSchema<undefined>;
+                }, undefined>, undefined>;
+                readonly contextTokens: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+            }, undefined>, undefined>;
+        }, undefined>, undefined>;
+    };
+};
+export declare const listWorkspaceModelsContract: {
+    readonly method: "get";
+    readonly requestPathParamsSchema: v.ObjectSchema<{
+        readonly workspaceId: v.StringSchema<undefined>;
+    }, undefined> & import("@toad-contracts/core").ObjectKeysCarrier;
+    readonly pathResolver: ({ workspaceId }: {
+        workspaceId: 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.ArraySchema<v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+            readonly label: v.StringSchema<undefined>;
+            readonly description: v.StringSchema<undefined>;
+            readonly flavor: v.PicklistSchema<["cloudflare", "direct", "openrouter", "subscription"], undefined>;
+            readonly available: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+            readonly providerLabel: v.StringSchema<undefined>;
+            readonly provider: v.StringSchema<undefined>;
+            readonly model: v.StringSchema<undefined>;
+            readonly vendor: v.OptionalSchema<v.PicklistSchema<["claude", "codex", "glm", "kimi", "deepseek"], undefined>, undefined>;
+            readonly cost: v.OptionalSchema<v.ObjectSchema<{
+                readonly inputPerMillion: v.NumberSchema<undefined>;
+                readonly outputPerMillion: v.NumberSchema<undefined>;
+                readonly currency: v.StringSchema<undefined>;
+            }, undefined>, undefined>;
+            readonly contextTokens: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+            readonly quotaBased: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+            readonly subscription: v.OptionalSchema<v.ObjectSchema<{
+                readonly vendor: v.PicklistSchema<["claude", "codex", "glm", "kimi", "deepseek"], undefined>;
+                readonly providerLabel: v.StringSchema<undefined>;
+                readonly provider: v.StringSchema<undefined>;
+                readonly model: v.StringSchema<undefined>;
+                readonly cost: v.OptionalSchema<v.ObjectSchema<{
+                    readonly inputPerMillion: v.NumberSchema<undefined>;
+                    readonly outputPerMillion: v.NumberSchema<undefined>;
+                    readonly currency: v.StringSchema<undefined>;
+                }, undefined>, undefined>;
+                readonly contextTokens: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+            }, undefined>, undefined>;
+        }, undefined>, undefined>;
+    };
+};
+//# sourceMappingURL=models.d.ts.map

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

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

package/dist/routes/models.js

@@ -0,0 +1,25 @@
+import { defineApiContract, withObjectKeys } from '@toad-contracts/valibot';
+import * as v from 'valibot';
+import { modelCatalogSchema } from '../entities.js';
+import { errorResponses } from './_shared.js';
+// ---------------------------------------------------------------------------
+// Model picker catalog route contracts. The ModelController is mounted at `/`,
+// so both paths are absolute and `workspaceId` IS a path param. See
+// ModelController in @cat-factory/server.
+// ---------------------------------------------------------------------------
+const workspaceIdParams = withObjectKeys(v.object({ workspaceId: v.string() }));
+// Deployment-level catalog (no workspace context).
+export const listModelsContract = defineApiContract({
+    method: 'get',
+    pathResolver: () => '/models',
+    responsesByStatusCode: { 200: modelCatalogSchema, ...errorResponses },
+});
+// Per-workspace catalog: selectability reflects the workspace's (+ account's + caller's)
+// configured keys and subscription tokens, plus the caller's local + OpenRouter models.
+export const listWorkspaceModelsContract = defineApiContract({
+    method: 'get',
+    requestPathParamsSchema: workspaceIdParams,
+    pathResolver: ({ workspaceId }) => `/workspaces/${workspaceId}/models`,
+    responsesByStatusCode: { 200: modelCatalogSchema, ...errorResponses },
+});
+//# sourceMappingURL=models.js.map

package/dist/routes/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/routes/models.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC3E,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAE7C,8EAA8E;AAC9E,+EAA+E;AAC/E,oEAAoE;AACpE,0CAA0C;AAC1C,8EAA8E;AAE9E,MAAM,iBAAiB,GAAG,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAA;AAE/E,mDAAmD;AACnD,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;IAClD,MAAM,EAAE,KAAK;IACb,YAAY,EAAE,GAAG,EAAE,CAAC,SAAS;IAC7B,qBAAqB,EAAE,EAAE,GAAG,EAAE,kBAAkB,EAAE,GAAG,cAAc,EAAE;CACtE,CAAC,CAAA;AAEF,yFAAyF;AACzF,wFAAwF;AACxF,MAAM,CAAC,MAAM,2BAA2B,GAAG,iBAAiB,CAAC;IAC3D,MAAM,EAAE,KAAK;IACb,uBAAuB,EAAE,iBAAiB;IAC1C,YAAY,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,eAAe,WAAW,SAAS;IACtE,qBAAqB,EAAE,EAAE,GAAG,EAAE,kBAAkB,EAAE,GAAG,cAAc,EAAE;CACtE,CAAC,CAAA"}

package/dist/routes/notifications.d.ts

@@ -0,0 +1,213 @@
+import { ContractNoBody } from '@toad-contracts/valibot';
+import * as v from 'valibot';
+export declare const listNotificationsContract: {
+    readonly method: "get";
+    readonly pathResolver: () => 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.ArraySchema<v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+            readonly type: v.PicklistSchema<["merge_review", "pipeline_complete", "ci_failed", "test_failed", "requirement_review", "clarity_review", "release_regression", "decision_required", "human_test_ready", "human_review", "followup_pending"], undefined>;
+            readonly status: v.PicklistSchema<["open", "acted", "dismissed"], undefined>;
+            readonly severity: v.OptionalSchema<v.PicklistSchema<["normal", "urgent"], undefined>, undefined>;
+            readonly blockId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly executionId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly title: v.StringSchema<undefined>;
+            readonly body: v.StringSchema<undefined>;
+            readonly payload: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+                readonly assessment: v.OptionalSchema<v.ObjectSchema<{
+                    readonly complexity: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+                    readonly risk: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+                    readonly impact: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+                    readonly rationale: v.StringSchema<undefined>;
+                }, undefined>, undefined>;
+                readonly prUrl: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly pipelineName: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly findingCount: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+                readonly onCallAssessment: v.OptionalSchema<v.ObjectSchema<{
+                    readonly culpritConfidence: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+                    readonly recommendation: v.PicklistSchema<["revert", "hold", "monitor"], undefined>;
+                    readonly rationale: v.StringSchema<undefined>;
+                    readonly evidence: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, readonly []>;
+                }, undefined>, undefined>;
+                readonly releaseSignals: v.OptionalSchema<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>;
+                readonly revertUrl: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly targetUserId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+            }, undefined>, undefined>, undefined>;
+            readonly createdAt: v.NumberSchema<undefined>;
+            readonly resolvedAt: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
+    };
+};
+export declare const actNotificationContract: {
+    readonly method: "post";
+    readonly requestPathParamsSchema: v.ObjectSchema<{
+        readonly notificationId: v.StringSchema<undefined>;
+    }, undefined> & import("@toad-contracts/core").ObjectKeysCarrier;
+    readonly pathResolver: ({ notificationId }: {
+        notificationId: 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 type: v.PicklistSchema<["merge_review", "pipeline_complete", "ci_failed", "test_failed", "requirement_review", "clarity_review", "release_regression", "decision_required", "human_test_ready", "human_review", "followup_pending"], undefined>;
+            readonly status: v.PicklistSchema<["open", "acted", "dismissed"], undefined>;
+            readonly severity: v.OptionalSchema<v.PicklistSchema<["normal", "urgent"], undefined>, undefined>;
+            readonly blockId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly executionId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly title: v.StringSchema<undefined>;
+            readonly body: v.StringSchema<undefined>;
+            readonly payload: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+                readonly assessment: v.OptionalSchema<v.ObjectSchema<{
+                    readonly complexity: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+                    readonly risk: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+                    readonly impact: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+                    readonly rationale: v.StringSchema<undefined>;
+                }, undefined>, undefined>;
+                readonly prUrl: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly pipelineName: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly findingCount: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+                readonly onCallAssessment: v.OptionalSchema<v.ObjectSchema<{
+                    readonly culpritConfidence: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+                    readonly recommendation: v.PicklistSchema<["revert", "hold", "monitor"], undefined>;
+                    readonly rationale: v.StringSchema<undefined>;
+                    readonly evidence: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, readonly []>;
+                }, undefined>, undefined>;
+                readonly releaseSignals: v.OptionalSchema<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>;
+                readonly revertUrl: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly targetUserId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+            }, undefined>, undefined>, undefined>;
+            readonly createdAt: v.NumberSchema<undefined>;
+            readonly resolvedAt: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+        }, undefined>;
+    };
+};
+export declare const dismissNotificationContract: {
+    readonly method: "post";
+    readonly requestPathParamsSchema: v.ObjectSchema<{
+        readonly notificationId: v.StringSchema<undefined>;
+    }, undefined> & import("@toad-contracts/core").ObjectKeysCarrier;
+    readonly pathResolver: ({ notificationId }: {
+        notificationId: 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 type: v.PicklistSchema<["merge_review", "pipeline_complete", "ci_failed", "test_failed", "requirement_review", "clarity_review", "release_regression", "decision_required", "human_test_ready", "human_review", "followup_pending"], undefined>;
+            readonly status: v.PicklistSchema<["open", "acted", "dismissed"], undefined>;
+            readonly severity: v.OptionalSchema<v.PicklistSchema<["normal", "urgent"], undefined>, undefined>;
+            readonly blockId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly executionId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly title: v.StringSchema<undefined>;
+            readonly body: v.StringSchema<undefined>;
+            readonly payload: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+                readonly assessment: v.OptionalSchema<v.ObjectSchema<{
+                    readonly complexity: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+                    readonly risk: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+                    readonly impact: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+                    readonly rationale: v.StringSchema<undefined>;
+                }, undefined>, undefined>;
+                readonly prUrl: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly pipelineName: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly findingCount: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+                readonly onCallAssessment: v.OptionalSchema<v.ObjectSchema<{
+                    readonly culpritConfidence: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+                    readonly recommendation: v.PicklistSchema<["revert", "hold", "monitor"], undefined>;
+                    readonly rationale: v.StringSchema<undefined>;
+                    readonly evidence: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, readonly []>;
+                }, undefined>, undefined>;
+                readonly releaseSignals: v.OptionalSchema<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>;
+                readonly revertUrl: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly targetUserId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+            }, undefined>, undefined>, undefined>;
+            readonly createdAt: v.NumberSchema<undefined>;
+            readonly resolvedAt: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+        }, undefined>;
+    };
+};
+//# sourceMappingURL=notifications.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../../src/routes/notifications.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAqC,MAAM,yBAAyB,CAAA;AAC3F,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAa5B,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAIpC,CAAA;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMlC,CAAA;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMtC,CAAA"}

package/dist/routes/notifications.js

@@ -0,0 +1,31 @@
+import { ContractNoBody, defineApiContract, withObjectKeys } from '@toad-contracts/valibot';
+import * as v from 'valibot';
+import { notificationSchema } from '../notifications.js';
+import { errorResponses } from './_shared.js';
+// ---------------------------------------------------------------------------
+// Notification inbox route contracts. Mounted under `/workspaces/:workspaceId`,
+// so the paths here are relative to that prefix (the frontend supplies it via
+// `pathPrefix`, the backend via the controller's mount point).
+// ---------------------------------------------------------------------------
+const notificationListSchema = v.array(notificationSchema);
+const notificationIdParams = withObjectKeys(v.object({ notificationId: v.string() }));
+export const listNotificationsContract = defineApiContract({
+    method: 'get',
+    pathResolver: () => '/notifications',
+    responsesByStatusCode: { 200: notificationListSchema, ...errorResponses },
+});
+export const actNotificationContract = defineApiContract({
+    method: 'post',
+    requestPathParamsSchema: notificationIdParams,
+    pathResolver: ({ notificationId }) => `/notifications/${notificationId}/act`,
+    requestBodySchema: ContractNoBody,
+    responsesByStatusCode: { 200: notificationSchema, ...errorResponses },
+});
+export const dismissNotificationContract = defineApiContract({
+    method: 'post',
+    requestPathParamsSchema: notificationIdParams,
+    pathResolver: ({ notificationId }) => `/notifications/${notificationId}/dismiss`,
+    requestBodySchema: ContractNoBody,
+    responsesByStatusCode: { 200: notificationSchema, ...errorResponses },
+});
+//# sourceMappingURL=notifications.js.map

package/dist/routes/notifications.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.js","sourceRoot":"","sources":["../../src/routes/notifications.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC3F,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAE7C,8EAA8E;AAC9E,gFAAgF;AAChF,8EAA8E;AAC9E,+DAA+D;AAC/D,8EAA8E;AAE9E,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAA;AAC1D,MAAM,oBAAoB,GAAG,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAA;AAErF,MAAM,CAAC,MAAM,yBAAyB,GAAG,iBAAiB,CAAC;IACzD,MAAM,EAAE,KAAK;IACb,YAAY,EAAE,GAAG,EAAE,CAAC,gBAAgB;IACpC,qBAAqB,EAAE,EAAE,GAAG,EAAE,sBAAsB,EAAE,GAAG,cAAc,EAAE;CAC1E,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,iBAAiB,CAAC;IACvD,MAAM,EAAE,MAAM;IACd,uBAAuB,EAAE,oBAAoB;IAC7C,YAAY,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,kBAAkB,cAAc,MAAM;IAC5E,iBAAiB,EAAE,cAAc;IACjC,qBAAqB,EAAE,EAAE,GAAG,EAAE,kBAAkB,EAAE,GAAG,cAAc,EAAE;CACtE,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG,iBAAiB,CAAC;IAC3D,MAAM,EAAE,MAAM;IACd,uBAAuB,EAAE,oBAAoB;IAC7C,YAAY,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,kBAAkB,cAAc,UAAU;IAChF,iBAAiB,EAAE,cAAc;IACjC,qBAAqB,EAAE,EAAE,GAAG,EAAE,kBAAkB,EAAE,GAAG,cAAc,EAAE;CACtE,CAAC,CAAA"}

package/dist/routes/openrouter.d.ts

@@ -0,0 +1,145 @@
+import { ContractNoBody } from '@toad-contracts/valibot';
+import * as v from 'valibot';
+export declare const getOpenRouterCatalogContract: {
+    readonly method: "get";
+    readonly requestPathParamsSchema: v.ObjectSchema<{
+        readonly workspaceId: v.StringSchema<undefined>;
+    }, undefined> & import("@toad-contracts/core").ObjectKeysCarrier;
+    readonly pathResolver: ({ workspaceId }: {
+        workspaceId: 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 models: v.ArraySchema<v.ObjectSchema<{
+                readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>;
+                readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 200, undefined>]>;
+                readonly contextLength: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+                readonly inputPerMillion: v.NumberSchema<undefined>;
+                readonly outputPerMillion: v.NumberSchema<undefined>;
+            }, undefined>, undefined>;
+            readonly createdAt: v.NumberSchema<undefined>;
+            readonly updatedAt: v.NumberSchema<undefined>;
+        }, undefined>;
+    };
+};
+export declare const upsertOpenRouterCatalogContract: {
+    readonly method: "put";
+    readonly requestPathParamsSchema: v.ObjectSchema<{
+        readonly workspaceId: v.StringSchema<undefined>;
+    }, undefined> & import("@toad-contracts/core").ObjectKeysCarrier;
+    readonly pathResolver: ({ workspaceId }: {
+        workspaceId: string;
+    }) => string;
+    readonly requestBodySchema: v.ObjectSchema<{
+        readonly models: v.ArraySchema<v.ObjectSchema<{
+            readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>;
+            readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 200, undefined>]>;
+            readonly contextLength: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+            readonly inputPerMillion: v.NumberSchema<undefined>;
+            readonly outputPerMillion: v.NumberSchema<undefined>;
+        }, 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 models: v.ArraySchema<v.ObjectSchema<{
+                readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>;
+                readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 200, undefined>]>;
+                readonly contextLength: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+                readonly inputPerMillion: v.NumberSchema<undefined>;
+                readonly outputPerMillion: v.NumberSchema<undefined>;
+            }, undefined>, undefined>;
+            readonly createdAt: v.NumberSchema<undefined>;
+            readonly updatedAt: v.NumberSchema<undefined>;
+        }, undefined>;
+    };
+};
+export declare const refreshOpenRouterCatalogContract: {
+    readonly method: "post";
+    readonly requestPathParamsSchema: v.ObjectSchema<{
+        readonly workspaceId: v.StringSchema<undefined>;
+    }, undefined> & import("@toad-contracts/core").ObjectKeysCarrier;
+    readonly pathResolver: ({ workspaceId }: {
+        workspaceId: 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 reachable: v.BooleanSchema<undefined>;
+            readonly models: v.ArraySchema<v.ObjectSchema<{
+                readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>;
+                readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 200, undefined>]>;
+                readonly contextLength: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+                readonly inputPerMillion: v.NumberSchema<undefined>;
+                readonly outputPerMillion: v.NumberSchema<undefined>;
+            }, undefined>, undefined>;
+            readonly error: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>;
+    };
+};
+//# sourceMappingURL=openrouter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openrouter.d.ts","sourceRoot":"","sources":["../../src/routes/openrouter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAqC,MAAM,yBAAyB,CAAA;AAC3F,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAiB5B,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKvC,CAAA;AAEF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAM1C,CAAA;AAEF,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAM3C,CAAA"}