@company-semantics/contracts 0.115.0 → 0.116.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "0.115.0",
+  "version": "0.116.0",
   "private": false,
   "repository": {
     "type": "git",
@@ -48,6 +48,10 @@
       "types": "./src/chat/index.ts",
       "default": "./src/chat/index.ts"
     },
+    "./api": {
+      "types": "./src/api/index.ts",
+      "default": "./src/api/index.ts"
+    },
     "./schemas/guard-result.schema.json": "./schemas/guard-result.schema.json"
   },
   "types": "./src/index.ts",

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

@@ -1,3 +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;
+export const SPEC_HASH = 'd4f412a26098' as const;
+export const SPEC_HASH_FULL = 'd4f412a26098e42f4578da215bc71e3960ed6850e2482e8de7c1a38f785c2cf6' 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"];
@@ -2175,18 +2244,26 @@ export interface components {
         MeResponse: {
             /** Format: uuid */
             userId: string;
-            firstName: string;
-            lastName?: string | null;
+            /** Format: email */
+            email: string;
             fullName: string;
             preferredName?: string | null;
-            /** @description Computed at read time (preferredName ?? firstName) */
+            /** @description Computed at read time (preferredName ?? fullName) */
             displayName: string;
+            /** @enum {string} */
+            nameSource: "self" | "sso";
+            nameEditable: boolean;
+            primaryDepartmentId: string | null;
+            slackUserId: string | null;
+            avatar: components["schemas"]["ResolvedAvatar"];
             /** Format: uuid */
             orgId: string;
-            orgName?: string | null;
+            orgName: string | null;
             orgSlug: string;
             /** @enum {string} */
             plan: "free" | "pro" | "enterprise";
+            hasMultipleOrgs: boolean;
+            isInternalAdmin: boolean;
         };
         /** @description At least one field must be provided */
         ProfileUpdateRequest: {
@@ -2393,12 +2470,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";
@@ -2841,6 +2913,7 @@ export interface components {
             id: string;
             name: string;
             type: components["schemas"]["OrgType"];
+            logoUrl: string | null;
             owner: {
                 /** Format: uuid */
                 id: string;
@@ -2900,6 +2973,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;
@@ -3154,6 +3233,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;
@@ -5422,6 +5550,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;
@@ -6423,6 +6583,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;
@@ -6875,6 +7079,8 @@ export interface operations {
                 content: {
                     "application/json": {
                         share: components["schemas"]["ChatShareInfo"];
+                        /** @description Full URL for accessing the shared chat */
+                        shareUrl: string;
                     };
                 };
             };
@@ -7040,20 +7246,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 */
@@ -7181,11 +7392,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: {
@@ -7216,6 +7432,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;
@@ -7499,13 +7756,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 */
@@ -7526,15 +7783,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: {
@@ -7743,7 +7991,10 @@ export interface operations {
                 };
                 content: {
                     "application/json": {
-                        ok?: boolean;
+                        /** @constant */
+                        success: true;
+                        /** @constant */
+                        ok: true;
                     };
                 };
             };
@@ -8116,6 +8367,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

@@ -9,4 +9,8 @@
 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.js'
+export { SPEC_HASH, SPEC_HASH_FULL } from './generated-spec-hash'
+
+// Reusable API primitive schemas (CursorPage, ErrorResponse)
+export { CursorPageSchema, ErrorResponseSchema } from './primitives'
+export type { CursorPage, ErrorResponse } from './primitives'

package/src/api/primitives.ts

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+
+/** Generic factory for cursor-paginated responses. */
+export function CursorPageSchema<T extends z.ZodTypeAny>(itemSchema: T) {
+  return z.object({
+    items: z.array(itemSchema),
+    nextCursor: z.string().nullable(),
+    hasMore: z.boolean(),
+  });
+}
+
+/** Standard error envelope — matches backend StandardErrorResponse. */
+export const ErrorResponseSchema = z.object({
+  error: z.object({
+    code: z.string(),
+    message: z.string(),
+    retryable: z.boolean(),
+  }),
+});
+
+// Inferred types
+export type CursorPage<T> = { items: T[]; nextCursor: string | null; hasMore: boolean };
+export type ErrorResponse = z.infer<typeof ErrorResponseSchema>;

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'],