AgentCompany/src/shared/domain.ts

import type { ProviderDataPolicy } from "./provider-policy-domain";
export { BOARD_INTERVENTION_ACTION, BOARD_INTERVENTION_MODE, CHAT_THREAD_BOARD_STATE, type BoardInterventionAction, type BoardInterventionMode, type ChatThreadBoardState } from "./board-domain";
export type { ChatReplyStatus, ChatSpaceAnchor, ChatSpaceRecord, ChatMessageRecord, ChatMembershipRecord, ChatThreadRecord, ChatAttachmentRecord, ChatMentionRecord, ChatSlashInvocationRecord, ChatPresenceRecord, ChatReadStateRecord } from "./chat-domain";
export { COMPLIANCE_EXPORT_STATE, COMPLIANCE_EXPORT_TYPE, type ComplianceExportRecord, type ComplianceExportState, type ComplianceExportType, type ComplianceSubjectType, type LegalHoldEntityType, type RetentionFreezeScopeType } from "./compliance-domain";
export { ACCESS_DECISION, IDENTITY_SOURCE, ROLE_KEY, type AccessDecision, type IdentitySource, type PrincipalType, type RoleKey } from "./identity-domain";
export { ROUTE_TO_TYPE, type HiringPolicyRecord, type RouteToType } from "./org-governance-domain";
export { FEATURE_FLAG_KEY, SLO_SIGNAL_KEY, type FeatureFlagKey, type SloSignalKey } from "./operations-domain";
export type { ProviderAuthProfileRecord } from "./provider-auth-domain";
export { PROVIDER_DATA_POLICY, PROVIDER_EXECUTION_MODE, type ProviderDataPolicy, type ProviderExecutionMode } from "./provider-policy-domain";
export { PROVIDER_REQUEST_STATE, type ProviderRequestRecord, type ProviderRequestState, type ProviderStreamRendererEvent } from "./provider-request-domain";
export type { ProviderRateLimitStateRecord } from "./provider-runtime-domain";
export { SEARCH_ENTITY_TYPES, type SearchEntityType, type SearchPage, type SearchResultRecord } from "./search-domain";
export type { BrowserActionPolicyRecord, BrowserActionRecord, BrowserSessionContainerRecord, SocialAccountGrantRecord, SocialAccountRecord, SocialApprovalRouteRecord, SocialAuditRecord } from "./social-domain";
export type { AppSnapshot, UiLanguage, UiPreferences, UiTheme } from "./snapshot-domain";
export const TASK_STATUS = { BACKLOG: "backlog", IN_PROGRESS: "in_progress", REVIEW: "review", DONE: "done" } as const;
/** Superseded: a pending review replaced by one for newer content. */
export const APPROVAL_STATE = { PENDING: "pending", APPROVED: "approved", DECLINED: "declined", SUPERSEDED: "superseded" } as const;
export const RISK_LEVEL = { LOW: "low", MEDIUM: "medium", HIGH: "high" } as const;
export const TASK_PRIORITY = { LOW: "low", NORMAL: "normal", HIGH: "high" } as const;
/** How a task's output should read: conversational prose carries house style; technical and structured do not. */
export const WRITING_MODE = { CONVERSATIONAL: "conversational", TECHNICAL: "technical", STRUCTURED: "structured" } as const;
export const PROVIDER_AUTH_TYPE = { API_KEY: "api_key", OAUTH_PKCE: "oauth_pkce", ACCOUNT_SUBSCRIPTION: "account_subscription", CLOUD: "cloud" } as const;
export const SOCIAL_PLATFORM = { X: "x", LINKEDIN: "linkedin", YOUTUBE: "youtube", INSTAGRAM: "instagram" } as const;
export const FILE_SCAN_STATE = { APPROVED: "approved", BLOCKED: "blocked" } as const;

export type ValueOf<T> = T[keyof T];
export type WritingMode = ValueOf<typeof WRITING_MODE>;
export type TaskStatus = ValueOf<typeof TASK_STATUS>;
export type ApprovalState = ValueOf<typeof APPROVAL_STATE>;
export type RiskLevel = ValueOf<typeof RISK_LEVEL>;
export type TaskPriority = ValueOf<typeof TASK_PRIORITY>;
export type ProviderAuthType = ValueOf<typeof PROVIDER_AUTH_TYPE>;
export type SocialPlatform = ValueOf<typeof SOCIAL_PLATFORM>;
export type FileScanState = ValueOf<typeof FILE_SCAN_STATE>;

/** The language agents write in; separate from the app's display language. */
export type WorkLanguage = "en" | "zh";

export interface OrganizationRecord {
  id: string;
  name: string;
  mission: string;
  goal: string;
  description: string;
  executionMode: string;
  autoApproveHires: boolean;
  reviewDeliverables: boolean;
  /** The provider and model that audit goal completion, never the executor's own; null until the board sets them. */
  auditProviderId: string | null;
  auditModelId: string | null;
  /** The language its agents work in unless a task sets its own. */
  workLanguage: WorkLanguage;
  /** When the steps after creation (connectors) were finished; null reopens the setup wizard. */
  setupCompletedAt: string | null;
  createdAt: string;
}

export interface EmployeeRecord {
  id: string;
  orgId: string;
  displayName: string;
  role: string;
  avatarEmoji: string | null;
  avatarColor: string | null;
  /** Small data-URL portrait; wins over emoji/initials when set. */
  avatarImage: string | null;
  createdAt: string;
}

export interface AgentRecord {
  id: string;
  orgId: string;
  name: string;
  role: string;
  department: string;
  modelProviderId: string | null;
  modelId: string | null;
  budgetCents: number;
  managerAgentId: string | null;
  title: string;
  roleLevel: string;
  modelStrategy: string;
  workspaceId: string | null;
  heartbeatEnabled: boolean;
  heartbeatIntervalSec: number;
  lifecycle: string;
  avatarEmoji: string | null;
  avatarColor: string | null;
  /** Small data-URL portrait; wins over emoji/initials when set. */
  avatarImage: string | null;
  createdAt: string;
}

/** What stops an open task: the reason, when it resumes on its own (null: only when someone acts), and who that is. */
export type TaskHold =
  | { reason: string; waitingOn: "provider"; resumesAt: string }
  | { reason: string; waitingOn: "operator"; resumesAt: string | null };

/** What deleting a task removes, keeps and closes, and whether a running session stops it. */
export interface TaskDeleteImpact {
  /** Sessions removed with the task, with their action journals. */
  runs: number;
  /** Sessions still running; the delete is refused while any is. */
  running: number;
  /** Subtasks kept, moved to the top level. */
  subtasks: number;
  /** Documents kept, no longer linked to the task. */
  documents: number;
  /** Open reviews of the task, closed by the delete. */
  openReviews: number;
  /** Approvals requested for the task that stay pending. */
  pendingApprovals: number;
}

/** A position in run history (time, then insertion), which stays valid after its run is deleted. */
export interface RunCursor {
  createdAt: string;
  seq: number;
}

/** A page of older runs, oldest first: whether older ones exist, the position of its oldest run, and of the run it was read before. */
export interface RunHistoryPage {
  runs: TaskRunRecord[];
  hasMore: boolean;
  oldest: RunCursor | null;
  boundary: RunCursor | null;
}

export interface TaskRecord {
  id: string;
  orgId: string;
  title: string;
  description: string;
  status: TaskStatus;
  assigneeAgentId: string | null;
  risk: RiskLevel;
  projectId: string | null;
  goalId: string | null;
  workspaceId: string | null;
  priority: TaskPriority;
  parentTaskId: string | null;
  requiresFilesystem: boolean;
  writingMode: WritingMode;
  /** Overrides the company's working language for this task; null follows the company. */
  workLanguage: WorkLanguage | null;
  /** Set when the task spent its run budget without reaching done. */
  stalledReason: string | null;
  /** Why the heartbeat last failed to queue the task; cleared once it queues. */
  enqueueError: string | null;
  /** Why the operator blocked the task; no session starts while it is set. */
  blockedReason: string | null;
  /** Provenance: a chat reply vehicle, a goal checkpoint, a manager's review of work, or null for plain work. */
  origin: "chat_wake" | "goal_review" | "task_review" | null;
  /** Why the open task is not moving now, or null when nothing holds it. */
  hold: TaskHold | null;
  /** Runs at or below this task_runs rowid no longer count toward the run budget. */
  runBudgetFloor: number;
  createdAt: string;
  updatedAt: string;
}

export interface WorkspaceRecord {
  id: string;
  orgId: string;
  name: string;
  localPath: string;
  repoUrl: string;
  repoRef: string;
  projectId: string | null;
  isPrimary: boolean;
  createdAt: string;
  updatedAt: string;
}

export interface GoalRecord {
  id: string;
  orgId: string;
  title: string;
  description: string;
  status: string;
  ownerAgentId: string | null;
  /** Set when the goal's review loop stopped without a decision. */
  stalledReason: string | null;
  /** When the goal is planned to be reached; null when no target date was set. */
  dueAt: string | null;
  createdAt: string;
  updatedAt: string;
}

export interface ProjectRecord {
  id: string;
  orgId: string;
  goalId: string | null;
  name: string;
  description: string;
  leadAgentId: string | null;
  status: string;
  createdAt: string;
  updatedAt: string;
}

export interface TaskRunRecord {
  id: string;
  orgId: string;
  taskId: string;
  agentId: string | null;
  providerId: string | null;
  providerRequestId: string | null;
  executionContextId: string | null;
  serviceIdentityId: string | null;
  workspaceMountJson: string;
  secretScopeJson: string;
  trigger: string;
  state: string;
  createdAt: string;
  startedAt: string | null;
  completedAt: string | null;
  errorMessage: string | null;
  /** JSON RunContextManifest: which messages the run read. */
  contextJson: string | null;
  /** Capabilities the run could not load, one per line, so the user sees what it worked without. */
  capabilityWarnings: string | null;
  /** The model the session pinned when it started; null until then. */
  runModel: string | null;
}

export interface ApprovalRecord {
  id: string;
  orgId: string;
  kind: string;
  title: string;
  details: string;
  risk: RiskLevel;
  requestedByType: "employee" | "agent" | "system";
  requestedById: string | null;
  sourceEntityType: string | null;
  sourceEntityId: string | null;
  /** JSON of what the approval covers: a task snapshot, or the pin of an approved deliverable. */
  subjectSnapshot: string | null;
  state: ApprovalState;
  decisionNotes: string | null;
  decidedByEmployeeId: string | null;
  createdAt: string;
  decidedAt: string | null;
}

export interface FileObjectRecord {
  id: string;
  orgId: string;
  name: string;
  kind: string;
  sizeBytes: number;
  sha256: string;
  storagePath: string;
  /** The path the content came from; several ids share it when the file was rewritten. */
  sourcePath: string | null;
  /** Set once a newer content of the same path was recorded; the id still opens its own bytes. */
  supersededAt: string | null;
  ownerType: "employee" | "agent" | "system";
  ownerId: string | null;
  spaceId: string | null;
  pinned: boolean;
  scanState: FileScanState;
  scanLabelsJson: string;
  scannedAt: string | null;
  createdAt: string;
  updatedAt: string | null;
}

export interface FileAccessGrantRecord {
  id: string;
  orgId: string;
  fileId: string;
  grantedToType: "employee" | "agent" | "board" | "org_group";
  grantedToId: string;
  grantedByType: "employee" | "agent" | "board" | "system";
  grantedById: string | null;
  sourceMessageId: string | null;
  sourceThreadId: string | null;
  accessLevel: "read" | "manage";
  createdAt: string;
}

export interface FileHandoffRecord {
  id: string;
  orgId: string;
  messageId: string;
  fileId: string;
  sourcePrincipalType: "employee" | "agent" | "board" | "system";
  sourcePrincipalId: string | null;
  targetPrincipalType: "employee" | "agent" | "board" | "org_group";
  targetPrincipalId: string;
  transferType: string;
  checksum: string;
  scanState: FileScanState;
  scanLabelsJson: string;
  policyDecision: "approved_for_handoff" | "blocked_by_scan";
  objectRef: string;
  createdAt: string;
}

export interface ScheduledPostRecord {
  id: string;
  orgId: string;
  socialAccountId: string;
  bodyMd: string;
  scheduledFor: string;
  state: "draft" | "scheduled" | "published" | "cancelled";
  approvalId: string | null;
  createdByEmployeeId: string | null;
  createdAt: string;
  updatedAt: string;
}

export interface ProviderRecord {
  id: string;
  orgId: string;
  providerKey: string;
  label: string;
  authType: ProviderAuthType;
  model: string | null;
  credentialId: string | null;
  enabled: boolean;
  authState: string;
  healthState: string;
  lastCheckedAt: string | null;
  lastError: string | null;
  dataPolicy: ProviderDataPolicy;
  backgroundEnabled: boolean;
  monthlyRequestLimit: number;
  workspaceScope: string;
  /** Model context window the run budget is computed against. */
  contextWindowTokens: number;
  /** Prices in cents per million tokens; null until the operator sets them. */
  inputCentsPerMtok: number | null;
  cachedInputCentsPerMtok: number | null;
  outputCentsPerMtok: number | null;
  createdAt: string;
}

export interface ProviderCatalogModel {
  id: string;
  name: string;
}

export interface ProviderCatalogEntry {
  key: string;
  label: string;
  authType: ProviderAuthType;
  defaultModel: string | null;
  capabilityTags: string[];
  signInUrl: string | null;
  credentialHelp: string;
  models: ProviderCatalogModel[];
  /** True when the provider exposes a real models endpoint we can fetch from.
   * When false (e.g. the Codex subscription, which has no enumerable list), the
   * UI offers a free-text model id instead of a fixed dropdown. */
  supportsLiveModels: boolean;
  /** Set for user-configured OpenAI/Anthropic-compatible endpoints: the UI
   * collects a base URL + API key + model instead of a fixed provider form. */
  customEndpoint?: "openai" | "anthropic";
}

export interface SkillDefinitionRecord {
  id: string;
  orgId: string;
  slug: string;
  name: string;
  ownerType: string;
  status: string;
  createdAt: string;
}

export interface SkillRevisionRecord {
  id: string;
  skillId: string;
  versionSemver: string;
  manifestJson: string;
  sourceType: string;
  sourceRef: string;
  publishedAt: string;
  immutableChecksum: string;
}

export interface SkillBindingRecord {
  id: string;
  orgId: string;
  agentId: string;
  skillId: string;
  pinnedRevisionId: string;
  bindingMode: string;
  priority: number;
  enabled: boolean;
}

export interface SkillRuntimeSnapshotRecord {
  id: string;
  agentId: string;
  runId: string;
  compiledPrompt: string;
  toolsManifest: string;
  sourceRevisionIds: string;
  createdAt: string;
}

export interface SkillTestRecord {
  id: string;
  revisionId: string;
  testType: string;
  expectedOutputRef: string;
  lastResult: string | null;
  lastRunAt: string | null;
}

export interface AuditEventRecord {
  id: string;
  orgId: string;
  entityType: string;
  entityId: string;
  actorType: string;
  actorId: string | null;
  action: string;
  payloadJson: string;
  createdAt: string;
}

export interface PolicyRuleRecord {
  id: string;
  orgId: string;
  subjectType: string;
  subjectId: string | null;
  action: string;
  effect: string;
  riskCeiling: RiskLevel;
  createdAt: string;
}

export interface MigrationReportRecord {
  id: string;
  orgId: string;
  sourceRef: string;
  reportJson: string;
  createdAt: string;
}

export interface DocumentRecord {
  id: string;
  orgId: string;
  title: string;
  docType: string;
  content: string;
  status: string;
  authorAgentId: string | null;
  reviewerAgentId: string | null;
  projectId: string | null;
  goalId: string | null;
  taskId: string | null;
  version: number;
  createdAt: string;
  updatedAt: string;
}

export interface KnowledgeEntryRecord {
  id: string;
  orgId: string;
  topic: string;
  category: string;
  content: string;
  importance: string;
  sourceType: string;
  sourceId: string | null;
  scopeType: string;
  scopeId: string | null;
  validUntil: string | null;
  supersededBy: string | null;
  createdAt: string;
  updatedAt: string;
}

export interface ConnectorAccountRecord {
  id: string;
  orgId: string;
  toolkitSlug: string;
  toolkitName: string;
  /** Names the account among the toolkit's company accounts, e.g. "main" or "sales". */
  label: string;
  authConfigId: string;
  status: string;
  /** A reconnect waiting for authorization; the current account keeps working until it is active. */
  pendingAccountId: string | null;
  createdAt: string;
  updatedAt: string;
}

export interface ConnectorGrantRecord {
  id: string;
  orgId: string;
  agentId: string;
  toolkitSlug: string;
  accountLabel: string;
  /** JSON array of the only action names this grant allows; null allows every action. */
  allowedActions: string | null;
  /** JSON object of argument values every action under this grant must take; null fixes none. */
  fixedArguments: string | null;
  grantedByType: string;
  grantedById: string | null;
  createdAt: string;
}