@company-semantics/contracts 0.122.0 → 0.124.0

package/src/content/index.ts

@@ -0,0 +1,34 @@
+/**
+ * Content Domain Barrel
+ *
+ * Re-exports content response schemas for company-md, teams, departments, and drive.
+ * Import from '@company-semantics/contracts/content'.
+ */
+
+// Company.md response schemas (PRD-00448)
+export {
+  CompanyMdListResponseSchema,
+  CompanyMdDocResponseSchema,
+  CompanyMdShareResponseSchema,
+  CompanyMdContextBankResponseSchema,
+  CompanyMdSettingsResponseSchema,
+} from './schemas';
+export type {
+  CompanyMdListResponse,
+  CompanyMdDocResponse,
+  CompanyMdShareResponse,
+  CompanyMdContextBankResponse,
+  CompanyMdSettingsResponse,
+} from './schemas';
+
+// Team response schemas (PRD-00448)
+export { TeamListResponseSchema, TeamResponseSchema } from './schemas';
+export type { TeamListResponse, TeamResponse } from './schemas';
+
+// Department response schemas (PRD-00448)
+export { DepartmentListResponseSchema, DepartmentResponseSchema } from './schemas';
+export type { DepartmentListResponse, DepartmentResponse } from './schemas';
+
+// Drive response schemas (PRD-00448)
+export { DriveFileListResponseSchema, DriveFileContentResponseSchema } from './schemas';
+export type { DriveFileListResponse, DriveFileContentResponse } from './schemas';

package/src/content/schemas.ts

@@ -0,0 +1,286 @@
+/**
+ * Content Domain Response Schemas
+ *
+ * Zod response schemas for content and org structure endpoints.
+ * Canonical location for runtime validation of company-md, team,
+ * department, and drive API responses.
+ *
+ * Covers:
+ *  - company-md.ts        (GET /api/company-md/tree, GET /api/company-md/docs/:slug, etc.)
+ *  - company-md-sharing.ts (GET /api/company-md/docs/:slug/sharing)
+ *  - teams.ts             (GET /api/teams, GET /api/teams/:teamId, etc.)
+ *  - departments.ts       (GET /api/departments, GET /api/departments/:id, etc.)
+ *  - drive.ts             (GET /api/drive/files, GET /api/drive/files/recent, etc.)
+ */
+import { z } from 'zod';
+import { CursorPageSchema } from '../api/primitives';
+
+// ---------------------------------------------------------------------------
+// Company.md Sub-schemas
+// ---------------------------------------------------------------------------
+
+const CompanyMdOwningTeamSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+});
+
+const CompanyMdPersonSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+});
+
+const CompanyMdSourceSchema = z.object({
+  label: z.string(),
+  sourceType: z.enum(['meeting', 'document', 'conversation', 'manual']),
+  referencedAt: z.string(),
+});
+
+const CompanyMdDependencySchema = z.object({
+  targetSlug: z.string(),
+  description: z.string(),
+});
+
+const CompanyMdTreeNodeSchema = z.object({
+  id: z.string(),
+  slug: z.string(),
+  title: z.string(),
+  level: z.enum(['root', 'department', 'team', 'context']),
+  parentId: z.string().nullable(),
+  department: z.string().nullable(),
+  departmentId: z.string().nullable(),
+  visibility: z.enum(['public', 'private']),
+  owningTeam: CompanyMdOwningTeamSchema.nullable(),
+  type: z.enum(['company', 'department', 'team', 'cross_team', 'doc', 'goal', 'source', 'map', 'context_bank']),
+  canEdit: z.boolean(),
+  memberCount: z.number().int(),
+  description: z.string().optional(),
+  departmentIds: z.array(z.string()).optional(),
+});
+
+// ---------------------------------------------------------------------------
+// Company.md HTTP Response Schemas
+// ---------------------------------------------------------------------------
+
+/** Response for GET /api/company-md/tree */
+export const CompanyMdListResponseSchema = CursorPageSchema(CompanyMdTreeNodeSchema);
+
+/** Response for GET /api/company-md/docs/:slug */
+export const CompanyMdDocResponseSchema = z.object({
+  id: z.string(),
+  slug: z.string(),
+  title: z.string(),
+  level: z.enum(['root', 'department', 'team', 'context']),
+  department: z.string().nullable(),
+  departmentId: z.string().nullable(),
+  content: z.string(),
+  visibility: z.enum(['public', 'private']),
+  parentId: z.string().nullable(),
+  owningTeam: CompanyMdOwningTeamSchema.nullable(),
+  owner: CompanyMdPersonSchema.nullable(),
+  coOwners: z.array(CompanyMdPersonSchema),
+  canEdit: z.boolean(),
+  inheritsFrom: z.string().nullable(),
+  sources: z.array(CompanyMdSourceSchema),
+  dependencies: z.array(CompanyMdDependencySchema),
+  members: z.array(CompanyMdPersonSchema),
+  extractionStatus: z.enum(['pending', 'extracting', 'complete', 'failed']),
+  createdAt: z.string(),
+  updatedAt: z.string(),
+});
+
+// ---------------------------------------------------------------------------
+// Company.md Sharing Sub-schemas
+// ---------------------------------------------------------------------------
+
+const AclEntrySchema = z.object({
+  principalType: z.enum(['user', 'team']),
+  principalId: z.string(),
+  principalName: z.string(),
+  accessLevel: z.enum(['viewer', 'commenter', 'editor']),
+  grantedBy: z.object({ id: z.string(), name: z.string() }).nullable(),
+  grantedAt: z.string(),
+});
+
+const AccessReasonSchema = z.object({
+  source: z.enum(['org_rbac', 'sharing_policy', 'team_baseline', 'acl_grant', 'doc_ownership']),
+  detail: z.string(),
+});
+
+const EffectiveAccessSchema = z.object({
+  level: z.enum(['none', 'viewer', 'commenter', 'editor']),
+  reasons: z.array(AccessReasonSchema),
+  canShare: z.boolean(),
+});
+
+/** Response for GET /api/company-md/docs/:slug/sharing */
+export const CompanyMdShareResponseSchema = z.object({
+  sharingPolicy: z.enum(['restricted', 'org_read', 'org_comment', 'org_edit']),
+  acl: z.array(AclEntrySchema),
+  effectiveAccess: EffectiveAccessSchema,
+});
+
+// ---------------------------------------------------------------------------
+// Company.md Context Bank + Settings Response Schemas
+// ---------------------------------------------------------------------------
+
+const CompanyMdContextBankItemSchema = z.object({
+  id: z.string(),
+  slug: z.string(),
+  title: z.string(),
+  visibility: z.enum(['public', 'private']),
+  updatedAt: z.string(),
+});
+
+/** Response for GET /api/company-md/docs/:slug/context-bank */
+export const CompanyMdContextBankResponseSchema = z.object({
+  items: z.array(CompanyMdContextBankItemSchema),
+});
+
+const CompanyMdLevelLabelsSchema = z.object({
+  root: z.string(),
+  department: z.string(),
+  team: z.string(),
+});
+
+/** Response for GET /api/company-md/settings */
+export const CompanyMdSettingsResponseSchema = z.object({
+  levelLabels: CompanyMdLevelLabelsSchema,
+});
+
+// ---------------------------------------------------------------------------
+// Team Sub-schemas
+// ---------------------------------------------------------------------------
+
+const TeamMemberSchema = z.object({
+  userId: z.string(),
+  name: z.string(),
+  email: z.string(),
+  role: z.enum(['member', 'manager', 'owner']),
+  joinedAt: z.string(),
+});
+
+const TeamSummarySchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  slug: z.string(),
+  description: z.string().nullable(),
+  memberCount: z.number().int(),
+  scope: z.enum(['department', 'cross_department', 'org']),
+  department: z.object({ id: z.string(), name: z.string(), slug: z.string() }).nullable(),
+  homeDepartment: z.object({ id: z.string(), name: z.string(), slug: z.string() }).nullable(),
+});
+
+// ---------------------------------------------------------------------------
+// Team HTTP Response Schemas
+// ---------------------------------------------------------------------------
+
+/** Response for GET /api/teams */
+export const TeamListResponseSchema = z.object({
+  teams: z.array(TeamSummarySchema),
+});
+
+/** Response for GET /api/teams/:teamId */
+export const TeamResponseSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  slug: z.string(),
+  description: z.string().nullable(),
+  syncMode: z.enum(['manual_only', 'synced_readonly', 'synced_with_overrides']),
+  members: z.array(TeamMemberSchema),
+});
+
+// ---------------------------------------------------------------------------
+// Department Sub-schemas
+// ---------------------------------------------------------------------------
+
+const DepartmentMemberSchema = z.object({
+  userId: z.string(),
+  name: z.string(),
+  email: z.string(),
+  role: z.enum(['member', 'manager', 'owner']),
+  joinedAt: z.string(),
+});
+
+const DepartmentSummarySchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  slug: z.string(),
+  description: z.string().nullable(),
+  memberCount: z.number().int(),
+  position: z.number().int(),
+});
+
+// ---------------------------------------------------------------------------
+// Department HTTP Response Schemas
+// ---------------------------------------------------------------------------
+
+/** Response for GET /api/departments */
+export const DepartmentListResponseSchema = z.object({
+  departments: z.array(DepartmentSummarySchema),
+});
+
+/** Response for GET /api/departments/:id */
+export const DepartmentResponseSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  slug: z.string(),
+  description: z.string().nullable(),
+  position: z.number().int(),
+  syncMode: z.enum(['manual_only', 'scim', 'hris']),
+  memberCount: z.number().int(),
+  members: z.array(DepartmentMemberSchema),
+});
+
+// ---------------------------------------------------------------------------
+// Drive Sub-schemas
+// ---------------------------------------------------------------------------
+
+const DriveFileOwnerSchema = z.object({
+  displayName: z.string().optional(),
+  emailAddress: z.string().optional(),
+});
+
+const DriveFileSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  mimeType: z.string(),
+  createdTime: z.string().optional(),
+  modifiedTime: z.string().optional(),
+  owners: z.array(DriveFileOwnerSchema).optional(),
+  webViewLink: z.string().optional(),
+  iconLink: z.string().optional(),
+  size: z.string().optional(),
+});
+
+// ---------------------------------------------------------------------------
+// Drive HTTP Response Schemas
+// ---------------------------------------------------------------------------
+
+/** Response for GET /api/drive/files and GET /api/drive/files/recent */
+export const DriveFileListResponseSchema = z.object({
+  files: z.array(DriveFileSchema),
+  nextPageToken: z.string().optional(),
+});
+
+/** Response for GET /api/drive/files/:fileId/content */
+export const DriveFileContentResponseSchema = z.object({
+  content: z.string(),
+  exportedAs: z.string(),
+  truncated: z.boolean(),
+});
+
+// ---------------------------------------------------------------------------
+// Inferred Types
+// ---------------------------------------------------------------------------
+
+export type CompanyMdListResponse = z.infer<typeof CompanyMdListResponseSchema>;
+export type CompanyMdDocResponse = z.infer<typeof CompanyMdDocResponseSchema>;
+export type CompanyMdShareResponse = z.infer<typeof CompanyMdShareResponseSchema>;
+export type CompanyMdContextBankResponse = z.infer<typeof CompanyMdContextBankResponseSchema>;
+export type CompanyMdSettingsResponse = z.infer<typeof CompanyMdSettingsResponseSchema>;
+export type TeamListResponse = z.infer<typeof TeamListResponseSchema>;
+export type TeamResponse = z.infer<typeof TeamResponseSchema>;
+export type DepartmentListResponse = z.infer<typeof DepartmentListResponseSchema>;
+export type DepartmentResponse = z.infer<typeof DepartmentResponseSchema>;
+export type DriveFileListResponse = z.infer<typeof DriveFileListResponseSchema>;
+export type DriveFileContentResponse = z.infer<typeof DriveFileContentResponseSchema>;

package/src/identity/index.ts

@@ -30,5 +30,29 @@ export type { AvatarSource, ResolvedAvatar } from './avatar';
 export { generateInitials, resolveAvatar } from './avatar';
 
 // Response Schemas (Zod) - canonical location per ADR-CONT-044
-export { MeResponseSchema, AuthStartResponseSchema, AuthVerifyResponseSchema, SsoConfigResponseSchema, ProfileResponseSchema } from './schemas';
-export type { MeResponse, AuthStartResponse, AuthVerifyResponse, SsoConfigResponse, ProfileResponse } from './schemas';
+export {
+  MeResponseSchema,
+  AuthStartResponseSchema,
+  AuthVerifyResponseSchema,
+  SsoConfigResponseSchema,
+  ProfileResponseSchema,
+  AccountSessionListSchema,
+  AccountSessionRevokeResponseSchema,
+  AccountDeletionEligibilityResponseSchema,
+  AccountDeleteResponseSchema,
+  AccountConfirmDeletionResponseSchema,
+  AccountCancelDeletionResponseSchema,
+} from './schemas';
+export type {
+  MeResponse,
+  AuthStartResponse,
+  AuthVerifyResponse,
+  SsoConfigResponse,
+  ProfileResponse,
+  AccountSessionList,
+  AccountSessionRevokeResponse,
+  AccountDeletionEligibilityResponse,
+  AccountDeleteResponse,
+  AccountConfirmDeletionResponse,
+  AccountCancelDeletionResponse,
+} from './schemas';

package/src/identity/schemas.ts

@@ -137,3 +137,88 @@ export const ProfileResponseSchema = z.object({
 });
 
 export type ProfileResponse = z.infer<typeof ProfileResponseSchema>;
+
+// ---------------------------------------------------------------------------
+// GET /api/account/sessions
+// ---------------------------------------------------------------------------
+
+const AccountSessionSchema = z.object({
+  id: z.string(),
+  deviceLabel: z.string(),
+  ipAddress: z.string().nullable(),
+  createdAt: z.string(),
+  lastActiveAt: z.string().nullable(),
+  isCurrent: z.boolean(),
+});
+
+export const AccountSessionListSchema = z.object({
+  sessions: z.array(AccountSessionSchema),
+});
+
+export type AccountSessionList = z.infer<typeof AccountSessionListSchema>;
+
+// ---------------------------------------------------------------------------
+// DELETE /api/account/sessions/:sessionId
+// ---------------------------------------------------------------------------
+
+export const AccountSessionRevokeResponseSchema = z.object({
+  success: z.literal(true),
+  ok: z.literal(true),
+});
+
+export type AccountSessionRevokeResponse = z.infer<typeof AccountSessionRevokeResponseSchema>;
+
+// ---------------------------------------------------------------------------
+// GET /api/account/deletion-eligibility
+// ---------------------------------------------------------------------------
+
+const DeletionBlockerSchema = z.discriminatedUnion('type', [
+  z.object({
+    type: z.literal('sole_workspace_owner'),
+    workspaceId: z.string(),
+    workspaceName: z.string(),
+  }),
+  z.object({
+    type: z.literal('active_legal_hold'),
+    holdId: z.string(),
+  }),
+]);
+
+export const AccountDeletionEligibilityResponseSchema = z.object({
+  eligible: z.boolean(),
+  blockers: z.array(DeletionBlockerSchema),
+});
+
+export type AccountDeletionEligibilityResponse = z.infer<typeof AccountDeletionEligibilityResponseSchema>;
+
+// ---------------------------------------------------------------------------
+// POST /api/account/delete
+// ---------------------------------------------------------------------------
+
+export const AccountDeleteResponseSchema = z.object({
+  status: z.literal('confirmation_pending'),
+  message: z.string(),
+});
+
+export type AccountDeleteResponse = z.infer<typeof AccountDeleteResponseSchema>;
+
+// ---------------------------------------------------------------------------
+// POST /api/account/confirm-deletion
+// ---------------------------------------------------------------------------
+
+export const AccountConfirmDeletionResponseSchema = z.object({
+  status: z.literal('pending_deletion'),
+});
+
+export type AccountConfirmDeletionResponse = z.infer<typeof AccountConfirmDeletionResponseSchema>;
+
+// ---------------------------------------------------------------------------
+// POST /api/account/cancel-deletion
+// ---------------------------------------------------------------------------
+
+export const AccountCancelDeletionResponseSchema = z.object({
+  success: z.literal(true),
+  ok: z.literal(true),
+});
+
+export type AccountCancelDeletionResponse = z.infer<typeof AccountCancelDeletionResponseSchema>;

package/src/org/index.ts

@@ -201,3 +201,17 @@ export type {
   OwnershipTransferResponse,
   OwnershipTransferPreview,
 } from './schemas';
+
+// Org-ops response schemas (PRD-00449)
+export {
+  OrgSystemEventsListSchema,
+  AcknowledgeSystemEventResponseSchema,
+  OrgBudgetConfigSchema,
+  OrgUsageResponseSchema,
+} from './schemas';
+export type {
+  OrgSystemEventsList,
+  AcknowledgeSystemEventResponse,
+  OrgBudgetConfig,
+  OrgUsageResponse,
+} from './schemas';

package/src/org/schemas.ts

@@ -502,3 +502,109 @@ export const OwnershipTransferPreviewSchema = z.object({
 });
 
 export type OwnershipTransferPreview = z.infer<typeof OwnershipTransferPreviewSchema>;
+
+// ---------------------------------------------------------------------------
+// GET /api/org/system-events
+// ---------------------------------------------------------------------------
+
+const OrgSystemEventSchema = z.object({
+  id: z.string(),
+  type: z.string(),
+  payload: z.unknown(),
+  createdAt: z.string(),
+});
+
+export const OrgSystemEventsListSchema = z.object({
+  events: z.array(OrgSystemEventSchema),
+});
+
+export type OrgSystemEventsList = z.infer<typeof OrgSystemEventsListSchema>;
+
+// ---------------------------------------------------------------------------
+// POST /api/org/system-events/:id/acknowledge
+// ---------------------------------------------------------------------------
+
+export const AcknowledgeSystemEventResponseSchema = z.object({
+  success: z.literal(true),
+});
+
+export type AcknowledgeSystemEventResponse = z.infer<typeof AcknowledgeSystemEventResponseSchema>;
+
+// ---------------------------------------------------------------------------
+// GET /api/orgs/:orgId/budget-config
+// PUT /api/orgs/:orgId/budget-config
+// ---------------------------------------------------------------------------
+
+export const OrgBudgetConfigSchema = z.object({
+  monthlyBudgetUsd: z.number().nullable(),
+  maxCostPerExecution: z.number().nullable(),
+  agenticMaxSteps: z.number().int().nullable(),
+  alertThresholdPct: z.number().int(),
+  enabled: z.boolean(),
+});
+
+export type OrgBudgetConfig = z.infer<typeof OrgBudgetConfigSchema>;
+
+// ---------------------------------------------------------------------------
+// GET /api/orgs/:orgId/ai-usage
+// Matches UnifiedUsageResponse from usage/types.ts
+// ---------------------------------------------------------------------------
+
+const UnifiedUsageSummarySchema = z.object({
+  executions: z.number(),
+  totalCostUsd: z.string(),
+  totalTokens: z.number(),
+  avgDurationMs: z.number(),
+  failureRate: z.number(),
+});
+
+const UnifiedDailyUsageSchema = z.object({
+  date: z.string(),
+  executions: z.number(),
+  totalCostUsd: z.string(),
+});
+
+const UnifiedProfileUsageSchema = z.object({
+  profile: z.string(),
+  executions: z.number(),
+  percentOfTotal: z.number(),
+  totalCostUsd: z.string(),
+  avgDurationMs: z.number(),
+  failureRate: z.number(),
+});
+
+const UnifiedUserUsageSchema = z.object({
+  userId: z.string(),
+  email: z.string(),
+  executions: z.number(),
+  totalCostUsd: z.string(),
+  totalTokens: z.number(),
+  favoriteProfile: z.string(),
+});
+
+const UnifiedModelUsageSchema = z.object({
+  model: z.string(),
+  provider: z.string(),
+  totalTokens: z.number(),
+  estimatedCostUsd: z.string(),
+  requestCount: z.number(),
+});
+
+const UnifiedFeatureUsageSchema = z.object({
+  feature: z.string(),
+  totalTokens: z.number(),
+  estimatedCostUsd: z.string(),
+  requestCount: z.number(),
+});
+
+export const OrgUsageResponseSchema = z.object({
+  period: z.object({ start: z.string(), end: z.string() }),
+  summary: UnifiedUsageSummarySchema,
+  daily: z.array(UnifiedDailyUsageSchema),
+  byProfile: z.array(UnifiedProfileUsageSchema),
+  byUser: z.array(UnifiedUserUsageSchema),
+  byModel: z.array(UnifiedModelUsageSchema),
+  byFeature: z.array(UnifiedFeatureUsageSchema),
+});
+
+export type OrgUsageResponse = z.infer<typeof OrgUsageResponseSchema>;