@company-semantics/contracts 0.63.0 → 0.65.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "0.63.0",
+  "version": "0.65.0",
   "private": false,
   "repository": {
     "type": "git",

package/src/index.ts

@@ -223,9 +223,14 @@ export type {
   WorkspaceSettingsOverview,
   IntegrationRequestStatus,
   IntegrationRequest,
+  // Ownership transfer DTOs (PRD-00153)
+  TransferInitiateRequest,
+  TransferStatusResponse,
+  TransferAcceptanceView,
+  TransferResponsibility,
 } from './org/index'
 
-export { ROLE_DISPLAY_MAP, WORKSPACE_CAPABILITIES, ROLE_CAPABILITY_MAP, VIEW_SCOPE_MAP, getViewScope } from './org/index'
+export { ROLE_DISPLAY_MAP, WORKSPACE_CAPABILITIES, ROLE_CAPABILITY_MAP, VIEW_SCOPE_MAP, getViewScope, TRANSFER_RESPONSIBILITIES } from './org/index'
 
 // View authorization types (Phase 5 - ADR-APP-013)
 export type { AuthorizableView } from './org/index'
@@ -414,3 +419,15 @@ export type {
 } from './impersonation'
 
 export { RESTRICTED_IMPERSONATION_ACTIONS } from './impersonation'
+
+// Usage tracking types (internal admin)
+// @see PRD-00166 for design rationale
+export type {
+  AiFeature,
+  UsageSummary,
+  DailyUsage,
+  UsageByModel,
+  UsageByFeature,
+  UsageByUser,
+  OrgUsageResponse,
+} from './usage/types'

package/src/org/index.ts

@@ -38,9 +38,14 @@ export type {
   WorkspaceSettingsOverview,
   IntegrationRequestStatus,
   IntegrationRequest,
+  // Ownership transfer DTOs (PRD-00153)
+  TransferInitiateRequest,
+  TransferStatusResponse,
+  TransferAcceptanceView,
+  TransferResponsibility,
 } from './types';
 
-export { ROLE_DISPLAY_MAP } from './types';
+export { ROLE_DISPLAY_MAP, TRANSFER_RESPONSIBILITIES } from './types';
 
 // Workspace capability types (Phase 3)
 export type { WorkspaceCapability } from './capabilities';

package/src/org/types.ts

@@ -386,6 +386,48 @@ export interface WorkspaceSettingsOverview extends WorkspaceInfoOverview {
   };
 }
 
+// =============================================================================
+// Ownership Transfer DTOs (PRD-00153)
+// Rich types for the transfer UI flows, supplementing OwnershipTransferRequest
+// and OwnershipTransferStatus above.
+// =============================================================================
+
+/** Request body for initiating ownership transfer (extends existing to include optional note). */
+export interface TransferInitiateRequest {
+  readonly newOwnerEmail: string;
+  readonly note?: string;
+}
+
+/** Response for transfer status queries — extends existing OwnershipTransferStatus. */
+export interface TransferStatusResponse {
+  readonly pending: boolean;
+  readonly newOwnerEmail?: string;
+  readonly note?: string;
+  readonly requestedAt?: string;
+  readonly expiresAt?: string;
+  readonly initiatorName?: string;
+}
+
+/** Read-only view for the transfer acceptance page. */
+export interface TransferAcceptanceView {
+  readonly workspaceName: string;
+  readonly initiatorName: string;
+  readonly initiatorEmail: string;
+  readonly note?: string;
+  readonly expiresAt: string;
+  readonly token: string;
+}
+
+/** Responsibility checklist items shown on the acceptance page. */
+export const TRANSFER_RESPONSIBILITIES = [
+  'You will become the sole owner of this workspace',
+  'You will be responsible for billing and compliance',
+  'The current owner will be downgraded to admin',
+  'This action cannot be undone without a new transfer',
+] as const;
+
+export type TransferResponsibility = (typeof TRANSFER_RESPONSIBILITIES)[number];
+
 /**
  * Status of an integration request from a member.
  */

package/src/usage/types.ts

@@ -0,0 +1,55 @@
+/**
+ * AI Usage Tracking Types (v1)
+ * Internal admin usage visibility. Not org-facing in v1.
+ * See PRD-00166 for design rationale and invariants.
+ */
+
+export type AiFeature = 'chat' | 'chat_title' | 'ingest_summarize' | 'ingest_embedding';
+
+export interface UsageSummary {
+  totalTokens: number;
+  totalInputTokens: number;
+  totalOutputTokens: number;
+  estimatedCostUsd: string;
+  requestCount: number;
+  periodStart: string; // UTC ISO8601
+  periodEnd: string;   // UTC ISO8601
+}
+
+export interface DailyUsage {
+  date: string; // YYYY-MM-DD
+  totalTokens: number;
+  estimatedCostUsd: string;
+  requestCount: number;
+}
+
+export interface UsageByModel {
+  model: string;
+  provider: string;
+  totalTokens: number;
+  estimatedCostUsd: string;
+  requestCount: number;
+}
+
+export interface UsageByFeature {
+  feature: AiFeature;
+  totalTokens: number;
+  estimatedCostUsd: string;
+  requestCount: number;
+}
+
+export interface UsageByUser {
+  userId: string;
+  email: string;
+  totalTokens: number;
+  estimatedCostUsd: string;
+  requestCount: number;
+}
+
+export interface OrgUsageResponse {
+  summary: UsageSummary;
+  daily: DailyUsage[];
+  byModel: UsageByModel[];
+  byFeature: UsageByFeature[];
+  topUsers: UsageByUser[];
+}