@company-semantics/contracts 0.113.3 → 0.115.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "0.113.3",
+  "version": "0.115.1",
   "private": false,
   "repository": {
     "type": "git",
@@ -83,7 +83,8 @@
     "release": "npx tsx scripts/release.ts",
     "prepublishOnly": "echo 'ERROR: Publishing is CI-only via tag push. Use pnpm release instead.' && exit 1",
     "test": "vitest run",
-    "generate:api": "pnpm generate:api-types",
+    "generate:spec-hash": "tsx scripts/generate-spec-hash.ts",
+    "generate:api": "pnpm generate:api-types && pnpm generate:spec-hash",
     "generate:api-types": "openapi-typescript openapi/backend.yaml -o src/api/generated.ts",
     "generate:openapi-routes": "tsx scripts/generate-openapi-routes.ts",
     "generate:api-types:check": "openapi-typescript openapi/backend.yaml -o /tmp/cs-api-types-check.ts && diff -q src/api/generated.ts /tmp/cs-api-types-check.ts"

package/src/api/generated-spec-hash.ts

@@ -0,0 +1,3 @@
+// AUTO-GENERATED — do not edit. Run pnpm generate:spec-hash to regenerate.
+export const SPEC_HASH = '44201100a1da' as const;
+export const SPEC_HASH_FULL = '44201100a1da5085404efb94d34655031cb30cfd468853e9d8b9ac1de722976c' as const;

package/src/api/generated.ts

@@ -1111,6 +1111,28 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/workspace/invites/validate": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Validate an invite token
+         * @description Validate an invite token without accepting it.
+         *     Used by the frontend to preflight-check tokens on page load.
+         *     No authentication required.
+         */
+        get: operations["validateInviteToken"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/workspace/invites": {
         parameters: {
             query?: never;
@@ -1526,6 +1548,27 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/chats/by-interaction/{interactionId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Look up chat ID by client interaction ID
+         * @description Returns the chat ID associated with a client-generated interaction ID.
+         *     Used to resolve optimistically-created chats.
+         */
+        get: operations["getChatByInteraction"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/chats/{id}": {
         parameters: {
             query?: never;
@@ -1752,7 +1795,7 @@ export interface paths {
         };
         /**
          * Get the goal tree for the current org
-         * @description Returns the goal tree for the current org.
+         * @description Returns the goal tree for the current org with cursor pagination.
          *     Auto-materializes docs on first access.
          *     Requires org.view_goals capability.
          */
@@ -1829,6 +1872,27 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/company-md/docs/{slug}/context-bank": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get context bank items for a goal doc
+         * @description Returns context bank items associated with the given parent doc.
+         *     Requires org.view_company_md capability.
+         */
+        get: operations["getCompanyMdDocContextBank"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/company-md/docs/{slug}/sharing": {
         parameters: {
             query?: never;
@@ -2095,7 +2159,12 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        get?: never;
+        /**
+         * List members of a department
+         * @description Returns paginated list of department members.
+         *     Requires org.view_departments capability.
+         */
+        get: operations["listDepartmentMembers"];
         put?: never;
         /** Add a member to a department */
         post: operations["addDepartmentMember"];
@@ -2393,12 +2462,7 @@ export interface components {
             /** @description The chat title (generated or existing) */
             title: string;
             /** @description Whether title was newly generated (false if guards blocked) */
-            generated: boolean;
-            /**
-             * @description Reason why generation was skipped (present when generated=false)
-             * @enum {string}
-             */
-            skipReason?: "manual_title" | "already_generated";
+            isAutoGenerated: boolean;
         };
         /** @enum {string} */
         ChatVisibility: "public" | "private";
@@ -2605,6 +2669,10 @@ export interface components {
         };
         ExecutionListResponse: {
             executions: components["schemas"]["ExecutionSummary"][];
+            /** @description Cursor for next page, null if no more results */
+            nextCursor?: string | null;
+            /** @description Whether more results are available */
+            hasMore: boolean;
         };
         ExecutionStartRequest: {
             kind: string;
@@ -2859,6 +2927,13 @@ export interface components {
             /** Format: date-time */
             joinedAt: string;
         };
+        WorkspaceMembersResponse: {
+            items: components["schemas"]["WorkspaceMember"][];
+            /** @description Cursor for next page, null if no more results */
+            nextCursor?: string | null;
+            /** @description Whether more results are available */
+            hasMore: boolean;
+        };
         AuthMethodConfig: {
             enabled: boolean;
             provider?: string;
@@ -2889,6 +2964,12 @@ export interface components {
             requireSSO?: boolean;
             /** @description List of allowed auth providers */
             allowedProviders?: string[];
+            /** @description OIDC discovery URL for SSO configuration */
+            oidcDiscoveryUrl?: string | null;
+            /** @description OIDC client ID credential */
+            oidcClientId?: string | null;
+            /** @description OIDC client secret credential */
+            oidcClientSecret?: string | null;
         };
         OrgAuthPolicy: {
             requireSSO: boolean;
@@ -3143,6 +3224,55 @@ export interface components {
             /** @enum {string} */
             role: "owner" | "manager" | "member";
         };
+        ExtractionEnqueuedResponse: {
+            /**
+             * @description Job has been enqueued for async processing
+             * @constant
+             */
+            extractionStatus: "pending";
+            /** @description Idempotency key for deduplication and status polling */
+            idempotencyKey: string;
+        };
+        GoalTreeResponse: {
+            items: components["schemas"]["GoalTreeNode"][];
+            /** @description Cursor for next page, null if no more results */
+            nextCursor?: string | null;
+            hasMore: boolean;
+        };
+        DepartmentMember: {
+            /** Format: uuid */
+            userId: string;
+            name: string;
+            /** Format: email */
+            email: string;
+            /** @enum {string} */
+            role: "member" | "manager" | "owner";
+            /** Format: date-time */
+            joinedAt: string;
+        };
+        DepartmentMembersResponse: {
+            items: components["schemas"]["DepartmentMember"][];
+            /** @description Cursor for next page, null if no more results */
+            nextCursor?: string | null;
+            hasMore: boolean;
+        };
+        ContextBankItem: {
+            /** Format: uuid */
+            id: string;
+            slug: string;
+            title: string;
+            /** @enum {string} */
+            visibility: "public" | "private";
+            /** Format: date-time */
+            updatedAt: string;
+        };
+        InviteValidationResult: {
+            valid: boolean;
+            /** @description Invite status (e.g. pending, accepted, expired, revoked) */
+            status: string;
+            /** @description Organization name (present when invite is valid) */
+            orgName?: string;
+        };
     };
     responses: never;
     parameters: never;
@@ -3961,8 +4091,12 @@ export interface operations {
                 targetType?: string;
                 /** @description Max results (default 100) */
                 limit?: number;
-                /** @description Pagination offset (default 0) */
-                offset?: number;
+                /** @description Cursor for pagination */
+                cursor?: string;
+                /** @description Start of date range filter */
+                periodStart?: string;
+                /** @description End of date range filter */
+                periodEnd?: string;
             };
             header?: never;
             path?: never;
@@ -5112,20 +5246,25 @@ export interface operations {
     };
     getWorkspaceMembers: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Cursor for pagination */
+                cursor?: string;
+                /** @description Max results per page (default 100, max 200) */
+                limit?: number;
+            };
             header?: never;
             path?: never;
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description List of workspace members */
+            /** @description Paginated list of workspace members */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["WorkspaceMember"][];
+                    "application/json": components["schemas"]["WorkspaceMembersResponse"];
                 };
             };
             /** @description No org.view_workspace capability */
@@ -5402,6 +5541,38 @@ export interface operations {
             };
         };
     };
+    validateInviteToken: {
+        parameters: {
+            query: {
+                /** @description Invite acceptance token */
+                token: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Token validation result */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InviteValidationResult"];
+                };
+            };
+            /** @description Missing token parameter */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
     listPendingInvites: {
         parameters: {
             query?: never;
@@ -6403,6 +6574,50 @@ export interface operations {
             };
         };
     };
+    getChatByInteraction: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Client-generated interaction ID */
+                interactionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Chat ID found */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** Format: uuid */
+                        chatId: string;
+                    };
+                };
+            };
+            /** @description Not authenticated */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Chat not found for this interaction ID */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
     getChat: {
         parameters: {
             query?: never;
@@ -6855,6 +7070,8 @@ export interface operations {
                 content: {
                     "application/json": {
                         share: components["schemas"]["ChatShareInfo"];
+                        /** @description Full URL for accessing the shared chat */
+                        shareUrl: string;
                     };
                 };
             };
@@ -7020,20 +7237,25 @@ export interface operations {
     };
     getCompanyMdTree: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Cursor for pagination */
+                cursor?: string;
+                /** @description Max results per page (default 100, max 200) */
+                limit?: number;
+            };
             header?: never;
             path?: never;
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Goal tree nodes */
+            /** @description Paginated goal tree nodes */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["GoalTreeNode"][];
+                    "application/json": components["schemas"]["GoalTreeResponse"];
                 };
             };
             /** @description No org.view_goals capability */
@@ -7161,11 +7383,16 @@ export interface operations {
         };
         responses: {
             /** @description Title updated successfully */
-            204: {
+            200: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": {
+                        /** @description The new slug (may change if title changed) */
+                        slug: string;
+                    };
+                };
             };
             /** @description Missing or empty title field */
             400: {
@@ -7196,6 +7423,47 @@ export interface operations {
             };
         };
     };
+    getCompanyMdDocContextBank: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Goal doc slug */
+                slug: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Context bank items */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ContextBankItem"][];
+                };
+            };
+            /** @description No org.view_company_md capability */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Doc not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
     getCompanyMdDocSharing: {
         parameters: {
             query?: never;
@@ -7479,13 +7747,13 @@ export interface operations {
             };
         };
         responses: {
-            /** @description Extraction result with markdown and structured signals */
-            200: {
+            /** @description Extraction job enqueued (async). Poll for results or use SSE. */
+            202: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ExtractGoalsResponse"];
+                    "application/json": components["schemas"]["ExtractionEnqueuedResponse"];
                 };
             };
             /** @description No file/text provided, unsupported MIME type, empty text, or text too large */
@@ -7506,15 +7774,6 @@ export interface operations {
                     "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
-            /** @description Extraction service busy (concurrency limit reached) */
-            503: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
         };
     };
     listTeams: {
@@ -7723,7 +7982,10 @@ export interface operations {
                 };
                 content: {
                     "application/json": {
-                        ok?: boolean;
+                        /** @constant */
+                        success: true;
+                        /** @constant */
+                        ok: true;
                     };
                 };
             };
@@ -8096,6 +8358,52 @@ export interface operations {
             };
         };
     };
+    listDepartmentMembers: {
+        parameters: {
+            query?: {
+                /** @description Cursor for pagination */
+                cursor?: string;
+                /** @description Max results per page (default 100, max 200) */
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                /** @description Department ID (UUID) */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Paginated list of department members */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DepartmentMembersResponse"];
+                };
+            };
+            /** @description No org.view_departments capability */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Department not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
     addDepartmentMember: {
         parameters: {
             query?: never;

package/src/api/index.ts

@@ -7,3 +7,6 @@
 
 // OpenAPI generated types (from openapi/backend.yaml)
 export type { paths, components, operations } from './generated'
+
+// Spec hash (from openapi/backend.yaml SHA-256)
+export { SPEC_HASH, SPEC_HASH_FULL } from './generated-spec-hash'

package/src/generated/openapi-routes.ts

@@ -9,14 +9,17 @@ export const openApiRoutes = {
   '/api/account/sessions/{sessionId}': ['DELETE'],
   '/api/capabilities/tools': ['GET'],
   '/api/chats': ['GET', 'POST'],
+  '/api/chats/by-interaction/{interactionId}': ['GET'],
   '/api/chats/events': ['GET'],
   '/api/chats/{chatId}/shares': ['GET', 'POST'],
   '/api/chats/{id}': ['DELETE', 'GET', 'PATCH'],
   '/api/chats/{id}/generate-title': ['POST'],
   '/api/chats/{id}/messages': ['POST'],
+  '/api/chats/{id}/messages/{messageId}': ['DELETE'],
   '/api/chats/{id}/pin': ['DELETE', 'POST'],
   '/api/company-md/docs/{slug}': ['GET'],
   '/api/company-md/docs/{slug}/content': ['PUT'],
+  '/api/company-md/docs/{slug}/context-bank': ['GET'],
   '/api/company-md/docs/{slug}/sharing': ['GET'],
   '/api/company-md/docs/{slug}/sharing/acl': ['POST'],
   '/api/company-md/docs/{slug}/sharing/acl/{aclId}': ['DELETE', 'PUT'],
@@ -26,7 +29,7 @@ export const openApiRoutes = {
   '/api/company-md/tree': ['GET'],
   '/api/departments': ['GET', 'POST'],
   '/api/departments/{id}': ['DELETE', 'GET', 'PATCH'],
-  '/api/departments/{id}/members': ['POST'],
+  '/api/departments/{id}/members': ['GET', 'POST'],
   '/api/departments/{id}/members/{userId}': ['DELETE'],
   '/api/drive/files': ['GET'],
   '/api/drive/files/recent': ['GET'],
@@ -82,6 +85,7 @@ export const openApiRoutes = {
   '/api/workspace/domains/{id}/verify': ['POST'],
   '/api/workspace/invites': ['GET', 'POST'],
   '/api/workspace/invites/accept': ['POST'],
+  '/api/workspace/invites/validate': ['GET'],
   '/api/workspace/invites/{id}': ['DELETE'],
   '/api/workspace/members': ['GET'],
   '/api/workspace/members/{id}': ['DELETE'],

package/src/index.ts

@@ -549,6 +549,9 @@ export type { ValidationDetail, ErrorResponse } from './errors/index'
 // @see src/api/README.md for codegen details
 export type { paths, components, operations } from './api/index'
 
+// Spec hash (SHA-256 of openapi/backend.yaml, generated at build time)
+export { SPEC_HASH, SPEC_HASH_FULL } from './api/index'
+
 // OpenAPI route registry (generated from openapi/backend.yaml)
 export { openApiRoutes, type OpenApiRoute, type OpenApiMethod } from './generated/openapi-routes'