@company-semantics/contracts 0.123.0 → 0.125.0

package/src/chat/index.ts

@@ -46,6 +46,9 @@ export type {
   CreateShareResponse,
   ListSharesResponse,
   UpdateShareResponse,
+  ChatMessage,
+  ChatDetail,
+  GetChatResponse,
 } from './types'
 
 // =============================================================================
@@ -81,6 +84,9 @@ export {
   CreateShareResponseSchema,
   ListSharesResponseSchema,
   UpdateShareResponseSchema,
+  ChatMessageSchema,
+  ChatDetailSchema,
+  GetChatResponseSchema,
 } from './schemas'
 
 // Runtime profile types and constants

package/src/chat/schemas.ts

@@ -153,6 +153,20 @@ export const ChatSseEventSchema = z.discriminatedUnion('type', [
   InvalidateChatListEventSchema,
 ])
 
+// =============================================================================
+// Message Types
+// =============================================================================
+
+/** Individual message in a chat, as returned by GET /api/chats/:id. */
+export const ChatMessageSchema = z.object({
+  id: z.string(),
+  role: z.enum(['user', 'assistant']),
+  content: z.string(),
+  parts: z.array(z.unknown()).optional(),
+  sequenceNumber: z.number().int(),
+  createdAt: IsoDateString,
+})
+
 // =============================================================================
 // HTTP Response Schemas
 // =============================================================================
@@ -192,3 +206,24 @@ export const ListSharesResponseSchema = z.object({
 export const UpdateShareResponseSchema = z.object({
   share: ChatShareInfoSchema,
 })
+
+/**
+ * Chat detail object in GET /api/chats/:id response.
+ * Extends the base summary with interactionId (needed for append-on-edit flows).
+ */
+export const ChatDetailSchema = z.object({
+  id: z.string(),
+  title: z.string(),
+  interactionId: z.string(),
+  pinnedAt: IsoDateString.nullable().optional(),
+  titleSource: TitleSourceSchema.nullable().optional(),
+  titleGeneratedAt: IsoDateString.nullable().optional(),
+  createdAt: IsoDateString,
+  updatedAt: IsoDateString,
+})
+
+/** Response for GET /api/chats/:id */
+export const GetChatResponseSchema = z.object({
+  chat: ChatDetailSchema,
+  messages: z.array(ChatMessageSchema),
+})

package/src/chat/types.ts

@@ -34,6 +34,9 @@ import {
   CreateShareResponseSchema,
   ListSharesResponseSchema,
   UpdateShareResponseSchema,
+  ChatMessageSchema,
+  ChatDetailSchema,
+  GetChatResponseSchema,
 } from './schemas'
 
 // =============================================================================
@@ -259,3 +262,12 @@ export type ListSharesResponse = z.infer<typeof ListSharesResponseSchema>
 
 /** Response for PATCH /api/shares/:shareId */
 export type UpdateShareResponse = z.infer<typeof UpdateShareResponseSchema>
+
+/** Individual message in a chat response (GET /api/chats/:id). */
+export type ChatMessage = z.infer<typeof ChatMessageSchema>
+
+/** Chat detail object in GET /api/chats/:id — includes interactionId for append-on-edit flows. */
+export type ChatDetail = z.infer<typeof ChatDetailSchema>
+
+/** Response for GET /api/chats/:id */
+export type GetChatResponse = z.infer<typeof GetChatResponseSchema>

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>;