@company-semantics/contracts 0.115.1 → 0.117.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "0.115.1",
+  "version": "0.117.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

@@ -2244,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: {
@@ -2905,6 +2913,7 @@ export interface components {
             id: string;
             name: string;
             type: components["schemas"]["OrgType"];
+            logoUrl: string | null;
             owner: {
                 /** Format: uuid */
                 id: string;

package/src/api/index.ts

@@ -10,3 +10,7 @@ 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'
+
+// 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/org/company-md.ts

@@ -76,6 +76,25 @@ export interface CompanyMdDocRelations {
 
 export type CompanyMdDoc = CompanyMdDocCore & CompanyMdDocCollaborators & CompanyMdDocRelations;
 
+export interface CompanyMdLevelLabels {
+  /** L1 label — defaults to org name */
+  readonly root: string;
+  /** L2 label — defaults to 'Department' */
+  readonly department: string;
+  /** L3 label — defaults to 'Team' */
+  readonly team: string;
+}
+
+export interface CompanyMdSettings {
+  readonly levelLabels: CompanyMdLevelLabels;
+}
+
+/** System defaults for level labels. L1 (root) is set per-org at read time. */
+export const DEFAULT_LEVEL_LABELS: Omit<CompanyMdLevelLabels, 'root'> = {
+  department: 'Department',
+  team: 'Team',
+} as const;
+
 /**
  * A context bank item — a company.md doc associated with one or more parent nodes.
  * Context bank files can belong to company, department, or team levels.

package/src/org/index.ts

@@ -96,8 +96,13 @@ export type {
   CompanyMdContextBankItem,
   TeamDepartmentRole,
   TeamDepartmentMembership,
+  // Level labels settings types (PRD-00453)
+  CompanyMdLevelLabels,
+  CompanyMdSettings,
 } from './company-md';
 
+export { DEFAULT_LEVEL_LABELS } from './company-md';
+
 // Team types (PRD-00306)
 export type {
   TeamMembershipRole,