@cat-factory/contracts 0.203.0 → 0.205.0

package/dist/routes/foundational-services.d.ts

@@ -0,0 +1,544 @@
+import { ContractNoBody } from '@toad-contracts/valibot';
+import * as v from 'valibot';
+export declare const listFoundationalServicesContract: {
+    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 ownerKind: v.PicklistSchema<["account", "workspace"], undefined>;
+            readonly name: v.StringSchema<undefined>;
+            readonly summary: v.StringSchema<undefined>;
+            readonly description: v.StringSchema<undefined>;
+            readonly capabilities: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+            readonly contracts: v.ArraySchema<v.ObjectSchema<{
+                readonly contractId: v.StringSchema<undefined>;
+                readonly format: v.PicklistSchema<["openapi", "toad-contract", "lokalise-api-contract"], undefined>;
+                readonly title: v.StringSchema<undefined>;
+                readonly size: v.NumberSchema<undefined>;
+                readonly path: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                readonly operations: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+                readonly omittedOperations: v.NumberSchema<undefined>;
+            }, undefined>, undefined>;
+            readonly sourceId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly sourcePath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly pinnedCommit: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly createdAt: v.NumberSchema<undefined>;
+            readonly updatedAt: v.NumberSchema<undefined>;
+        }, undefined>, undefined>;
+    };
+};
+export declare const createFoundationalServiceContract: {
+    readonly method: "post";
+    readonly pathResolver: () => string;
+    readonly requestBodySchema: v.ObjectSchema<{
+        readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 64, undefined>, v.RegexAction<string, "must be a lower-kebab slug">]>;
+        readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>;
+        readonly summary: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 400, undefined>]>;
+        readonly description: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MaxLengthAction<string, 20000, undefined>]>;
+        readonly capabilities: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 64, undefined>]>, undefined>, undefined>;
+        readonly contracts: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+            readonly contractId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 64, undefined>, v.RegexAction<string, "must be a lower-kebab slug">]>;
+            readonly format: v.PicklistSchema<["openapi", "toad-contract", "lokalise-api-contract"], undefined>;
+            readonly title: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>;
+            readonly body: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 1000000, undefined>]>;
+        }, 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 201: v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+            readonly ownerKind: v.PicklistSchema<["account", "workspace"], undefined>;
+            readonly name: v.StringSchema<undefined>;
+            readonly summary: v.StringSchema<undefined>;
+            readonly description: v.StringSchema<undefined>;
+            readonly capabilities: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+            readonly contracts: v.ArraySchema<v.ObjectSchema<{
+                readonly contractId: v.StringSchema<undefined>;
+                readonly format: v.PicklistSchema<["openapi", "toad-contract", "lokalise-api-contract"], undefined>;
+                readonly title: v.StringSchema<undefined>;
+                readonly size: v.NumberSchema<undefined>;
+                readonly path: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                readonly operations: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+                readonly omittedOperations: v.NumberSchema<undefined>;
+            }, undefined>, undefined>;
+            readonly sourceId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly sourcePath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly pinnedCommit: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly createdAt: v.NumberSchema<undefined>;
+            readonly updatedAt: v.NumberSchema<undefined>;
+        }, undefined>;
+    };
+};
+export declare const updateFoundationalServiceContract: {
+    readonly method: "patch";
+    readonly requestPathParamsSchema: v.ObjectSchema<{
+        serviceId: v.StringSchema<undefined>;
+    }, undefined> & import("@toad-contracts/core").StandardObjectKeysV1<unknown, unknown>;
+    readonly pathResolver: ({ serviceId }: {
+        serviceId: string;
+    }) => string;
+    readonly requestBodySchema: v.ObjectSchema<{
+        readonly name: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>, undefined>;
+        readonly summary: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 400, undefined>]>, undefined>;
+        readonly description: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MaxLengthAction<string, 20000, undefined>]>, undefined>;
+        readonly capabilities: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 64, undefined>]>, undefined>, undefined>;
+        readonly contracts: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+            readonly contractId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 64, undefined>, v.RegexAction<string, "must be a lower-kebab slug">]>;
+            readonly format: v.PicklistSchema<["openapi", "toad-contract", "lokalise-api-contract"], undefined>;
+            readonly title: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>;
+            readonly body: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 1000000, undefined>]>;
+        }, 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 id: v.StringSchema<undefined>;
+            readonly ownerKind: v.PicklistSchema<["account", "workspace"], undefined>;
+            readonly name: v.StringSchema<undefined>;
+            readonly summary: v.StringSchema<undefined>;
+            readonly description: v.StringSchema<undefined>;
+            readonly capabilities: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+            readonly contracts: v.ArraySchema<v.ObjectSchema<{
+                readonly contractId: v.StringSchema<undefined>;
+                readonly format: v.PicklistSchema<["openapi", "toad-contract", "lokalise-api-contract"], undefined>;
+                readonly title: v.StringSchema<undefined>;
+                readonly size: v.NumberSchema<undefined>;
+                readonly path: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                readonly operations: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+                readonly omittedOperations: v.NumberSchema<undefined>;
+            }, undefined>, undefined>;
+            readonly sourceId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly sourcePath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly pinnedCommit: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly createdAt: v.NumberSchema<undefined>;
+            readonly updatedAt: v.NumberSchema<undefined>;
+        }, undefined>;
+    };
+};
+export declare const deleteFoundationalServiceContract: {
+    readonly method: "delete";
+    readonly requestPathParamsSchema: v.ObjectSchema<{
+        serviceId: v.StringSchema<undefined>;
+    }, undefined> & import("@toad-contracts/core").StandardObjectKeysV1<unknown, unknown>;
+    readonly pathResolver: ({ serviceId }: {
+        serviceId: 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 204: typeof ContractNoBody;
+    };
+};
+/**
+ * The LAZY contract read: the full documents for one service. Deliberately its own
+ * endpoint rather than a field on the list — the whole point of the catalog is that a
+ * design-time reader pays for identity + operation names, and only a consumer that has
+ * settled on a service pays for its documents.
+ */
+export declare const getFoundationalServiceContractsContract: {
+    readonly method: "get";
+    readonly requestPathParamsSchema: v.ObjectSchema<{
+        serviceId: v.StringSchema<undefined>;
+    }, undefined> & import("@toad-contracts/core").StandardObjectKeysV1<unknown, unknown>;
+    readonly pathResolver: ({ serviceId }: {
+        serviceId: 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 contractId: v.StringSchema<undefined>;
+            readonly format: v.PicklistSchema<["openapi", "toad-contract", "lokalise-api-contract"], undefined>;
+            readonly title: v.StringSchema<undefined>;
+            readonly size: v.NumberSchema<undefined>;
+            readonly path: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly operations: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+            readonly omittedOperations: v.NumberSchema<undefined>;
+            readonly body: v.StringSchema<undefined>;
+        }, undefined>, undefined>;
+    };
+};
+/**
+ * The MERGED catalog an agent actually sees (account ⊕ workspace, workspace winning).
+ * Workspace-mount only — an account has no other tier to merge with.
+ */
+export declare const resolvedFoundationalServicesContract: {
+    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 ownerKind: v.PicklistSchema<["account", "workspace"], undefined>;
+            readonly name: v.StringSchema<undefined>;
+            readonly summary: v.StringSchema<undefined>;
+            readonly description: v.StringSchema<undefined>;
+            readonly capabilities: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+            readonly contracts: v.ArraySchema<v.ObjectSchema<{
+                readonly contractId: v.StringSchema<undefined>;
+                readonly format: v.PicklistSchema<["openapi", "toad-contract", "lokalise-api-contract"], undefined>;
+                readonly title: v.StringSchema<undefined>;
+                readonly size: v.NumberSchema<undefined>;
+                readonly path: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                readonly operations: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+                readonly omittedOperations: v.NumberSchema<undefined>;
+            }, undefined>, undefined>;
+            readonly sourceId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly sourcePath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly pinnedCommit: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly createdAt: v.NumberSchema<undefined>;
+            readonly updatedAt: v.NumberSchema<undefined>;
+            readonly tier: v.PicklistSchema<["account", "workspace"], undefined>;
+        }, undefined>, undefined>;
+    };
+};
+export declare const listFoundationalServiceSourcesContract: {
+    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 ownerKind: v.PicklistSchema<["account", "workspace"], undefined>;
+            readonly ownerId: v.StringSchema<undefined>;
+            readonly repoOwner: v.StringSchema<undefined>;
+            readonly repoName: v.StringSchema<undefined>;
+            readonly gitRef: v.StringSchema<undefined>;
+            readonly mode: v.PicklistSchema<["directory", "files"], undefined>;
+            readonly dirPath: v.StringSchema<undefined>;
+            readonly filePaths: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+            readonly serviceId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly serviceName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly serviceSummary: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly lastSyncedCommit: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly lastSyncedAt: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+            readonly createdAt: v.NumberSchema<undefined>;
+        }, undefined>, undefined>;
+    };
+};
+export declare const linkFoundationalServiceSourceContract: {
+    readonly method: "post";
+    readonly pathResolver: () => string;
+    readonly requestBodySchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+        readonly repoOwner: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 100, undefined>]>;
+        readonly repoName: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>;
+        readonly gitRef: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>, undefined>;
+        readonly mode: v.PicklistSchema<["directory", "files"], undefined>;
+        readonly dirPath: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MaxLengthAction<string, 300, undefined>]>, undefined>;
+        readonly filePaths: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 300, undefined>]>, undefined>, v.MaxLengthAction<string[], 50, undefined>]>, undefined>;
+        readonly serviceId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 64, undefined>, v.RegexAction<string, "must be a lower-kebab slug">]>, undefined>;
+        readonly serviceName: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>, undefined>;
+        readonly serviceSummary: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 400, undefined>]>, undefined>;
+    }, undefined>, v.CheckAction<{
+        repoOwner: string;
+        repoName: string;
+        gitRef?: string | undefined;
+        mode: "directory" | "files";
+        dirPath?: string | undefined;
+        filePaths?: string[] | undefined;
+        serviceId?: string | undefined;
+        serviceName?: string | undefined;
+        serviceSummary?: string | undefined;
+    }, "a `files` source must name serviceId, serviceName and at least one file path">]>;
+    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 ownerKind: v.PicklistSchema<["account", "workspace"], undefined>;
+            readonly ownerId: v.StringSchema<undefined>;
+            readonly repoOwner: v.StringSchema<undefined>;
+            readonly repoName: v.StringSchema<undefined>;
+            readonly gitRef: v.StringSchema<undefined>;
+            readonly mode: v.PicklistSchema<["directory", "files"], undefined>;
+            readonly dirPath: v.StringSchema<undefined>;
+            readonly filePaths: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+            readonly serviceId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly serviceName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly serviceSummary: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly lastSyncedCommit: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly lastSyncedAt: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+            readonly createdAt: v.NumberSchema<undefined>;
+        }, undefined>;
+    };
+};
+export declare const unlinkFoundationalServiceSourceContract: {
+    readonly method: "delete";
+    readonly requestPathParamsSchema: v.ObjectSchema<{
+        id: v.StringSchema<undefined>;
+    }, undefined> & import("@toad-contracts/core").StandardObjectKeysV1<unknown, unknown>;
+    readonly pathResolver: ({ id }: {
+        id: 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 204: typeof ContractNoBody;
+    };
+};
+export declare const foundationalServiceSourceStatusContract: {
+    readonly method: "get";
+    readonly requestPathParamsSchema: v.ObjectSchema<{
+        id: v.StringSchema<undefined>;
+    }, undefined> & import("@toad-contracts/core").StandardObjectKeysV1<unknown, unknown>;
+    readonly pathResolver: ({ id }: {
+        id: 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 changed: v.BooleanSchema<undefined>;
+            readonly lastSyncedCommit: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly remoteCommit: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>;
+    };
+};
+export declare const syncFoundationalServiceSourceContract: {
+    readonly method: "post";
+    readonly requestPathParamsSchema: v.ObjectSchema<{
+        id: v.StringSchema<undefined>;
+    }, undefined> & import("@toad-contracts/core").StandardObjectKeysV1<unknown, unknown>;
+    readonly pathResolver: ({ id }: {
+        id: 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 upserted: v.NumberSchema<undefined>;
+            readonly tombstoned: v.NumberSchema<undefined>;
+            readonly unchanged: v.NumberSchema<undefined>;
+            readonly lastSyncedCommit: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>;
+    };
+};
+//# sourceMappingURL=foundational-services.d.ts.map

package/dist/routes/foundational-services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"foundational-services.d.ts","sourceRoot":"","sources":["../../src/routes/foundational-services.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAqB,MAAM,yBAAyB,CAAA;AAC3E,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAkC5B,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAI3C,CAAA;AAEF,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAK5C,CAAA;AAEF,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAM5C,CAAA;AAEF,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAK5C,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,uCAAuC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKlD,CAAA;AAEF;;;GAGG;AACH,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAI/C,CAAA;AAIF,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAIjD,CAAA;AAEF,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKhD,CAAA;AAEF,eAAO,MAAM,uCAAuC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKlD,CAAA;AAEF,eAAO,MAAM,uCAAuC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKlD,CAAA;AAEF,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMhD,CAAA"}

package/dist/routes/foundational-services.js

@@ -0,0 +1,98 @@
+import { ContractNoBody, defineApiContract } from '@toad-contracts/valibot';
+import * as v from 'valibot';
+import { apiContractDocumentSchema, createFoundationalServiceSchema, foundationalServiceSchema, foundationalServiceSourceSchema, foundationalServiceSourceStatusSchema, foundationalServiceSyncResultSchema, linkFoundationalServiceSourceSchema, resolvedFoundationalServiceSchema, updateFoundationalServiceSchema, } from '../foundational-services.js';
+import { errorResponses, singleStringParam } from './_shared.js';
+// ---------------------------------------------------------------------------
+// Foundational-services route contracts. See FoundationalServiceController in
+// @cat-factory/server. Like the prompt-fragment library, the controller is mounted
+// TWICE — under `/accounts/:accountId` and `/workspaces/:workspaceId` — from one
+// factory, so these literals are RELATIVE to whichever prefix it is mounted under
+// and the owner id is read by the handler, not declared as a contract param.
+//
+// Service ids are lower-kebab slugs (never slash-bearing), so a plain `:serviceId`
+// (Hono's default `[^/]+`) matches them.
+// ---------------------------------------------------------------------------
+const foundationalServiceListSchema = v.array(foundationalServiceSchema);
+const resolvedFoundationalServiceListSchema = v.array(resolvedFoundationalServiceSchema);
+const contractDocumentListSchema = v.array(apiContractDocumentSchema);
+const sourceListSchema = v.array(foundationalServiceSourceSchema);
+const serviceIdParams = singleStringParam('serviceId');
+const sourceIdParams = singleStringParam('id');
+// ---- services (this tier, raw — not merged) -------------------------------
+export const listFoundationalServicesContract = defineApiContract({
+    method: 'get',
+    pathResolver: () => '/foundational-services',
+    responsesByStatusCode: { 200: foundationalServiceListSchema, ...errorResponses },
+});
+export const createFoundationalServiceContract = defineApiContract({
+    method: 'post',
+    pathResolver: () => '/foundational-services',
+    requestBodySchema: createFoundationalServiceSchema,
+    responsesByStatusCode: { 201: foundationalServiceSchema, ...errorResponses },
+});
+export const updateFoundationalServiceContract = defineApiContract({
+    method: 'patch',
+    requestPathParamsSchema: serviceIdParams,
+    pathResolver: ({ serviceId }) => `/foundational-services/${serviceId}`,
+    requestBodySchema: updateFoundationalServiceSchema,
+    responsesByStatusCode: { 200: foundationalServiceSchema, ...errorResponses },
+});
+export const deleteFoundationalServiceContract = defineApiContract({
+    method: 'delete',
+    requestPathParamsSchema: serviceIdParams,
+    pathResolver: ({ serviceId }) => `/foundational-services/${serviceId}`,
+    responsesByStatusCode: { 204: ContractNoBody, ...errorResponses },
+});
+/**
+ * The LAZY contract read: the full documents for one service. Deliberately its own
+ * endpoint rather than a field on the list — the whole point of the catalog is that a
+ * design-time reader pays for identity + operation names, and only a consumer that has
+ * settled on a service pays for its documents.
+ */
+export const getFoundationalServiceContractsContract = defineApiContract({
+    method: 'get',
+    requestPathParamsSchema: serviceIdParams,
+    pathResolver: ({ serviceId }) => `/foundational-services/${serviceId}/contracts`,
+    responsesByStatusCode: { 200: contractDocumentListSchema, ...errorResponses },
+});
+/**
+ * The MERGED catalog an agent actually sees (account ⊕ workspace, workspace winning).
+ * Workspace-mount only — an account has no other tier to merge with.
+ */
+export const resolvedFoundationalServicesContract = defineApiContract({
+    method: 'get',
+    pathResolver: () => '/foundational-services/resolved',
+    responsesByStatusCode: { 200: resolvedFoundationalServiceListSchema, ...errorResponses },
+});
+// ---- repo sources ---------------------------------------------------------
+export const listFoundationalServiceSourcesContract = defineApiContract({
+    method: 'get',
+    pathResolver: () => '/foundational-service-sources',
+    responsesByStatusCode: { 200: sourceListSchema, ...errorResponses },
+});
+export const linkFoundationalServiceSourceContract = defineApiContract({
+    method: 'post',
+    pathResolver: () => '/foundational-service-sources',
+    requestBodySchema: linkFoundationalServiceSourceSchema,
+    responsesByStatusCode: { 201: foundationalServiceSourceSchema, ...errorResponses },
+});
+export const unlinkFoundationalServiceSourceContract = defineApiContract({
+    method: 'delete',
+    requestPathParamsSchema: sourceIdParams,
+    pathResolver: ({ id }) => `/foundational-service-sources/${id}`,
+    responsesByStatusCode: { 204: ContractNoBody, ...errorResponses },
+});
+export const foundationalServiceSourceStatusContract = defineApiContract({
+    method: 'get',
+    requestPathParamsSchema: sourceIdParams,
+    pathResolver: ({ id }) => `/foundational-service-sources/${id}/status`,
+    responsesByStatusCode: { 200: foundationalServiceSourceStatusSchema, ...errorResponses },
+});
+export const syncFoundationalServiceSourceContract = defineApiContract({
+    method: 'post',
+    requestPathParamsSchema: sourceIdParams,
+    pathResolver: ({ id }) => `/foundational-service-sources/${id}/sync`,
+    requestBodySchema: ContractNoBody,
+    responsesByStatusCode: { 200: foundationalServiceSyncResultSchema, ...errorResponses },
+});
+//# sourceMappingURL=foundational-services.js.map