@pellux/goodvibes-tui 0.18.4

package/src/control-plane/operator-contract-schemas-channels.ts

@@ -0,0 +1,375 @@
+import {
+  BOOLEAN_SCHEMA,
+  NUMBER_SCHEMA,
+  STRING_SCHEMA,
+  arraySchema,
+  entityOutputSchema,
+  objectSchema,
+} from './method-catalog-shared.ts';
+import {
+  GENERIC_LIST_SCHEMA,
+  JSON_RECORD_SCHEMA,
+  JSON_SCHEMA_DOCUMENT_SCHEMA,
+  JSON_VALUE_SCHEMA,
+  METADATA_SCHEMA,
+  STRING_LIST_SCHEMA,
+  nullableSchema,
+} from './operator-contract-schemas-shared.ts';
+
+const CHANNEL_SECRET_STATUS_SCHEMA = objectSchema({
+  field: STRING_SCHEMA,
+  label: STRING_SCHEMA,
+  configured: BOOLEAN_SCHEMA,
+  source: STRING_SCHEMA,
+}, ['field', 'label', 'configured', 'source']);
+
+const CHANNEL_ACCOUNT_ACTION_SCHEMA = objectSchema({
+  id: STRING_SCHEMA,
+  label: STRING_SCHEMA,
+  kind: STRING_SCHEMA,
+  available: BOOLEAN_SCHEMA,
+}, ['id', 'label', 'kind', 'available']);
+
+const CHANNEL_SETUP_FIELD_OPTION_SCHEMA = objectSchema({
+  value: STRING_SCHEMA,
+  label: STRING_SCHEMA,
+}, ['value', 'label']);
+
+const CHANNEL_LOGIN_SCHEMA = objectSchema({
+  kind: STRING_SCHEMA,
+  url: STRING_SCHEMA,
+  qr: STRING_SCHEMA,
+  expiresAt: NUMBER_SCHEMA,
+  instructions: STRING_SCHEMA,
+}, ['kind']);
+
+export const TOOL_DEFINITION_SCHEMA = objectSchema({
+  name: STRING_SCHEMA,
+  description: STRING_SCHEMA,
+  parameters: JSON_SCHEMA_DOCUMENT_SCHEMA,
+  sideEffects: STRING_LIST_SCHEMA,
+  concurrency: STRING_SCHEMA,
+  supportsProgress: BOOLEAN_SCHEMA,
+  supportsStreamingOutput: BOOLEAN_SCHEMA,
+}, ['name', 'description', 'parameters']);
+
+export const CHANNEL_REPAIR_ACTION_SCHEMA = objectSchema({
+  id: STRING_SCHEMA,
+  label: STRING_SCHEMA,
+  description: STRING_SCHEMA,
+  dangerous: BOOLEAN_SCHEMA,
+  inputSchema: JSON_SCHEMA_DOCUMENT_SCHEMA,
+  metadata: METADATA_SCHEMA,
+}, ['id', 'label', 'description', 'dangerous', 'metadata']);
+
+export const CHANNEL_ACCOUNT_RECORD_SCHEMA = objectSchema({
+  id: STRING_SCHEMA,
+  surface: STRING_SCHEMA,
+  label: STRING_SCHEMA,
+  enabled: BOOLEAN_SCHEMA,
+  configured: BOOLEAN_SCHEMA,
+  linked: BOOLEAN_SCHEMA,
+  state: STRING_SCHEMA,
+  authState: STRING_SCHEMA,
+  accountId: STRING_SCHEMA,
+  workspaceId: STRING_SCHEMA,
+  secrets: arraySchema(CHANNEL_SECRET_STATUS_SCHEMA),
+  actions: arraySchema(CHANNEL_ACCOUNT_ACTION_SCHEMA),
+  metadata: METADATA_SCHEMA,
+}, ['id', 'surface', 'label', 'enabled', 'configured', 'linked', 'state', 'authState', 'secrets', 'actions', 'metadata']);
+
+const CHANNEL_SETUP_FIELD_SCHEMA = objectSchema({
+  id: STRING_SCHEMA,
+  label: STRING_SCHEMA,
+  kind: STRING_SCHEMA,
+  required: BOOLEAN_SCHEMA,
+  detail: STRING_SCHEMA,
+  placeholder: STRING_SCHEMA,
+  configKey: STRING_SCHEMA,
+  secretTargetId: STRING_SCHEMA,
+  defaultValue: JSON_VALUE_SCHEMA,
+  options: arraySchema(CHANNEL_SETUP_FIELD_OPTION_SCHEMA),
+  metadata: METADATA_SCHEMA,
+}, ['id', 'label', 'kind', 'required', 'metadata']);
+
+const CHANNEL_SECRET_TARGET_SCHEMA = objectSchema({
+  id: STRING_SCHEMA,
+  surface: STRING_SCHEMA,
+  label: STRING_SCHEMA,
+  required: BOOLEAN_SCHEMA,
+  supports: STRING_LIST_SCHEMA,
+  serviceName: STRING_SCHEMA,
+  serviceField: STRING_SCHEMA,
+  envKeys: STRING_LIST_SCHEMA,
+  configKeys: STRING_LIST_SCHEMA,
+  detail: STRING_SCHEMA,
+  metadata: METADATA_SCHEMA,
+}, ['id', 'surface', 'label', 'required', 'supports', 'metadata']);
+
+export const CHANNEL_SETUP_SCHEMA_SCHEMA = objectSchema({
+  surface: STRING_SCHEMA,
+  version: NUMBER_SCHEMA,
+  label: STRING_SCHEMA,
+  setupMode: STRING_SCHEMA,
+  description: STRING_SCHEMA,
+  fields: arraySchema(CHANNEL_SETUP_FIELD_SCHEMA),
+  secretTargets: arraySchema(CHANNEL_SECRET_TARGET_SCHEMA),
+  externalSteps: STRING_LIST_SCHEMA,
+  metadata: METADATA_SCHEMA,
+}, ['surface', 'version', 'label', 'setupMode', 'description', 'fields', 'secretTargets', 'externalSteps', 'metadata']);
+
+const CHANNEL_DOCTOR_CHECK_SCHEMA = objectSchema({
+  id: STRING_SCHEMA,
+  label: STRING_SCHEMA,
+  status: STRING_SCHEMA,
+  detail: STRING_SCHEMA,
+  repairActionId: STRING_SCHEMA,
+  metadata: METADATA_SCHEMA,
+}, ['id', 'label', 'status', 'detail']);
+
+export const CHANNEL_DOCTOR_REPORT_SCHEMA = objectSchema({
+  surface: STRING_SCHEMA,
+  accountId: STRING_SCHEMA,
+  state: STRING_SCHEMA,
+  summary: STRING_SCHEMA,
+  checkedAt: NUMBER_SCHEMA,
+  checks: arraySchema(CHANNEL_DOCTOR_CHECK_SCHEMA),
+  repairActions: arraySchema(CHANNEL_REPAIR_ACTION_SCHEMA),
+  metadata: METADATA_SCHEMA,
+}, ['surface', 'state', 'summary', 'checkedAt', 'checks', 'repairActions', 'metadata']);
+
+const CHANNEL_LIFECYCLE_MIGRATION_SCHEMA = objectSchema({
+  id: STRING_SCHEMA,
+  fromVersion: NUMBER_SCHEMA,
+  toVersion: NUMBER_SCHEMA,
+  action: STRING_SCHEMA,
+  applied: BOOLEAN_SCHEMA,
+  detail: STRING_SCHEMA,
+  metadata: METADATA_SCHEMA,
+}, ['id', 'fromVersion', 'toVersion', 'action', 'applied', 'detail']);
+
+export const CHANNEL_LIFECYCLE_STATE_SCHEMA = objectSchema({
+  surface: STRING_SCHEMA,
+  accountId: STRING_SCHEMA,
+  currentVersion: NUMBER_SCHEMA,
+  targetVersion: NUMBER_SCHEMA,
+  migrations: arraySchema(CHANNEL_LIFECYCLE_MIGRATION_SCHEMA),
+  metadata: METADATA_SCHEMA,
+}, ['surface', 'currentVersion', 'targetVersion', 'migrations', 'metadata']);
+
+const CHANNEL_LIFECYCLE_RESULT_SCHEMA = objectSchema({
+  surface: STRING_SCHEMA,
+  accountId: STRING_SCHEMA,
+  action: STRING_SCHEMA,
+  ok: BOOLEAN_SCHEMA,
+  state: STRING_SCHEMA,
+  authState: STRING_SCHEMA,
+  account: nullableSchema(CHANNEL_ACCOUNT_RECORD_SCHEMA),
+  message: STRING_SCHEMA,
+  login: CHANNEL_LOGIN_SCHEMA,
+  metadata: METADATA_SCHEMA,
+}, ['surface', 'action', 'ok', 'metadata']);
+
+export const CHANNEL_ACCOUNT_ACTION_OUTPUT_SCHEMA = objectSchema({
+  surface: STRING_SCHEMA,
+  accountId: STRING_SCHEMA,
+  action: STRING_SCHEMA,
+  result: CHANNEL_LIFECYCLE_RESULT_SCHEMA,
+}, ['surface', 'action', 'result']);
+
+const CHANNEL_RESOLVED_TARGET_SCHEMA = objectSchema({
+  surface: STRING_SCHEMA,
+  input: STRING_SCHEMA,
+  normalized: STRING_SCHEMA,
+  kind: STRING_SCHEMA,
+  to: STRING_SCHEMA,
+  display: STRING_SCHEMA,
+  accountId: STRING_SCHEMA,
+  workspaceId: STRING_SCHEMA,
+  channelId: STRING_SCHEMA,
+  groupId: STRING_SCHEMA,
+  threadId: STRING_SCHEMA,
+  parentId: STRING_SCHEMA,
+  sessionId: STRING_SCHEMA,
+  sessionTarget: STRING_SCHEMA,
+  bindingId: STRING_SCHEMA,
+  directoryEntryId: STRING_SCHEMA,
+  source: STRING_SCHEMA,
+  metadata: METADATA_SCHEMA,
+}, ['surface', 'input', 'normalized', 'kind', 'to', 'source', 'metadata']);
+
+export const CHANNEL_TARGET_RESOLVE_OUTPUT_SCHEMA = objectSchema({
+  surface: STRING_SCHEMA,
+  target: CHANNEL_RESOLVED_TARGET_SCHEMA,
+}, ['surface', 'target']);
+
+const CHANNEL_AUTHORIZATION_RESULT_SCHEMA = objectSchema({
+  allowed: BOOLEAN_SCHEMA,
+  reason: STRING_SCHEMA,
+  account: nullableSchema(CHANNEL_ACCOUNT_RECORD_SCHEMA),
+  actionAvailable: BOOLEAN_SCHEMA,
+  metadata: METADATA_SCHEMA,
+}, ['allowed', 'reason', 'metadata']);
+
+export const CHANNEL_AUTHORIZE_OUTPUT_SCHEMA = objectSchema({
+  surface: STRING_SCHEMA,
+  result: CHANNEL_AUTHORIZATION_RESULT_SCHEMA,
+}, ['surface', 'result']);
+
+const CHANNEL_ALLOWLIST_TARGET_SCHEMA = objectSchema({
+  kind: STRING_SCHEMA,
+  input: STRING_SCHEMA,
+  id: STRING_SCHEMA,
+  label: STRING_SCHEMA,
+  metadata: METADATA_SCHEMA,
+}, ['kind', 'input', 'id', 'label', 'metadata']);
+
+export const CHANNEL_ALLOWLIST_RESOLUTION_SCHEMA = objectSchema({
+  surface: STRING_SCHEMA,
+  resolved: arraySchema(CHANNEL_ALLOWLIST_TARGET_SCHEMA),
+  unresolved: STRING_LIST_SCHEMA,
+  metadata: METADATA_SCHEMA,
+}, ['surface', 'resolved', 'unresolved', 'metadata']);
+
+export const CHANNEL_GROUP_POLICY_SCHEMA = objectSchema({
+  id: STRING_SCHEMA,
+  label: STRING_SCHEMA,
+  groupId: STRING_SCHEMA,
+  channelId: STRING_SCHEMA,
+  workspaceId: STRING_SCHEMA,
+  requireMention: BOOLEAN_SCHEMA,
+  allowGroupMessages: BOOLEAN_SCHEMA,
+  allowThreadMessages: BOOLEAN_SCHEMA,
+  allowTextCommandsWithoutMention: BOOLEAN_SCHEMA,
+  allowlistUserIds: STRING_LIST_SCHEMA,
+  allowlistChannelIds: STRING_LIST_SCHEMA,
+  allowlistGroupIds: STRING_LIST_SCHEMA,
+  allowedCommands: STRING_LIST_SCHEMA,
+  metadata: METADATA_SCHEMA,
+}, ['id']);
+
+export const CHANNEL_STATUS_SCHEMA = objectSchema({
+  id: STRING_SCHEMA,
+  surface: STRING_SCHEMA,
+  label: STRING_SCHEMA,
+  state: STRING_SCHEMA,
+  enabled: BOOLEAN_SCHEMA,
+  accountId: STRING_SCHEMA,
+  metadata: METADATA_SCHEMA,
+}, ['id', 'surface', 'label', 'state', 'enabled', 'metadata']);
+
+export const CHANNEL_CAPABILITY_SCHEMA = objectSchema({
+  id: STRING_SCHEMA,
+  surface: STRING_SCHEMA,
+  label: STRING_SCHEMA,
+  scope: STRING_SCHEMA,
+  supported: BOOLEAN_SCHEMA,
+  detail: STRING_SCHEMA,
+  metadata: METADATA_SCHEMA,
+}, ['id', 'surface', 'label', 'scope', 'supported', 'detail', 'metadata']);
+
+export const CHANNEL_TOOL_SCHEMA = objectSchema({
+  id: STRING_SCHEMA,
+  surface: STRING_SCHEMA,
+  name: STRING_SCHEMA,
+  description: STRING_SCHEMA,
+  actionIds: STRING_LIST_SCHEMA,
+  inputSchema: JSON_SCHEMA_DOCUMENT_SCHEMA,
+  metadata: METADATA_SCHEMA,
+}, ['id', 'surface', 'name', 'description', 'actionIds', 'metadata']);
+
+export const CHANNEL_OPERATOR_ACTION_SCHEMA = objectSchema({
+  id: STRING_SCHEMA,
+  surface: STRING_SCHEMA,
+  label: STRING_SCHEMA,
+  description: STRING_SCHEMA,
+  dangerous: BOOLEAN_SCHEMA,
+  inputSchema: JSON_SCHEMA_DOCUMENT_SCHEMA,
+  metadata: METADATA_SCHEMA,
+}, ['id', 'surface', 'label', 'description', 'dangerous', 'metadata']);
+
+export const CHANNEL_POLICY_AUDIT_SCHEMA = objectSchema({
+  id: STRING_SCHEMA,
+  surface: STRING_SCHEMA,
+  createdAt: NUMBER_SCHEMA,
+  allowed: BOOLEAN_SCHEMA,
+  reason: STRING_SCHEMA,
+  userId: STRING_SCHEMA,
+  channelId: STRING_SCHEMA,
+  groupId: STRING_SCHEMA,
+  threadId: STRING_SCHEMA,
+  conversationKind: STRING_SCHEMA,
+  matchedGroupPolicyId: STRING_SCHEMA,
+  text: STRING_SCHEMA,
+  metadata: METADATA_SCHEMA,
+}, ['id', 'surface', 'createdAt', 'allowed', 'reason', 'metadata']);
+
+export const CHANNEL_DIRECTORY_ENTRY_SCHEMA = objectSchema({
+  id: STRING_SCHEMA,
+  surface: STRING_SCHEMA,
+  kind: STRING_SCHEMA,
+  label: STRING_SCHEMA,
+  handle: STRING_SCHEMA,
+  accountId: STRING_SCHEMA,
+  workspaceId: STRING_SCHEMA,
+  groupId: STRING_SCHEMA,
+  threadId: STRING_SCHEMA,
+  parentId: STRING_SCHEMA,
+  memberCount: NUMBER_SCHEMA,
+  memberIds: STRING_LIST_SCHEMA,
+  aliases: STRING_LIST_SCHEMA,
+  isSelf: BOOLEAN_SCHEMA,
+  isDirect: BOOLEAN_SCHEMA,
+  isGroupConversation: BOOLEAN_SCHEMA,
+  searchText: STRING_SCHEMA,
+  metadata: METADATA_SCHEMA,
+}, ['id', 'surface', 'kind', 'label', 'metadata']);
+
+export const CHANNEL_POLICY_SCHEMA = objectSchema({
+  surface: STRING_SCHEMA,
+  enabled: BOOLEAN_SCHEMA,
+  requireMention: BOOLEAN_SCHEMA,
+  allowDirectMessages: BOOLEAN_SCHEMA,
+  allowGroupMessages: BOOLEAN_SCHEMA,
+  allowThreadMessages: BOOLEAN_SCHEMA,
+  dmPolicy: STRING_SCHEMA,
+  groupPolicy: STRING_SCHEMA,
+  allowTextCommandsWithoutMention: BOOLEAN_SCHEMA,
+  allowlistUserIds: STRING_LIST_SCHEMA,
+  allowlistChannelIds: STRING_LIST_SCHEMA,
+  allowlistGroupIds: STRING_LIST_SCHEMA,
+  allowedCommands: STRING_LIST_SCHEMA,
+  groupPolicies: arraySchema(CHANNEL_GROUP_POLICY_SCHEMA),
+  updatedAt: NUMBER_SCHEMA,
+  metadata: METADATA_SCHEMA,
+}, ['surface', 'enabled', 'requireMention', 'allowDirectMessages', 'allowGroupMessages', 'allowThreadMessages', 'dmPolicy', 'groupPolicy', 'allowTextCommandsWithoutMention', 'allowlistUserIds', 'allowlistChannelIds', 'allowlistGroupIds', 'allowedCommands', 'groupPolicies', 'updatedAt', 'metadata']);
+
+export const CHANNEL_ALLOWLIST_EDIT_RESULT_SCHEMA = objectSchema({
+  surface: STRING_SCHEMA,
+  updatedPolicy: CHANNEL_POLICY_SCHEMA,
+  resolution: CHANNEL_ALLOWLIST_RESOLUTION_SCHEMA,
+  metadata: METADATA_SCHEMA,
+}, ['surface', 'updatedPolicy', 'resolution', 'metadata']);
+
+export const CHANNEL_TOOL_ACTION_OUTPUT_SCHEMA = objectSchema({
+  toolId: STRING_SCHEMA,
+  surface: STRING_SCHEMA,
+  result: JSON_RECORD_SCHEMA,
+}, ['toolId', 'surface', 'result']);
+
+export const CHANNEL_OPERATOR_ACTION_OUTPUT_SCHEMA = objectSchema({
+  actionId: STRING_SCHEMA,
+  surface: STRING_SCHEMA,
+  result: JSON_RECORD_SCHEMA,
+}, ['actionId', 'surface', 'result']);
+
+export const CHANNEL_STATUS_LIST_OUTPUT_SCHEMA = objectSchema({
+  channels: arraySchema(CHANNEL_STATUS_SCHEMA),
+}, ['channels']);
+
+export const CHANNEL_ACCOUNT_ENTITY_OUTPUT_SCHEMA = CHANNEL_ACCOUNT_RECORD_SCHEMA;
+export const CHANNEL_ACCOUNTS_OUTPUT_SCHEMA = objectSchema({
+  accounts: arraySchema(CHANNEL_ACCOUNT_RECORD_SCHEMA),
+}, ['accounts']);
+
+export const CHANNEL_SETUP_ENTITY_OUTPUT_SCHEMA = entityOutputSchema('schema', CHANNEL_SETUP_SCHEMA_SCHEMA);

package/src/control-plane/operator-contract-schemas-control.ts

@@ -0,0 +1,226 @@
+import {
+  BOOLEAN_SCHEMA,
+  NUMBER_SCHEMA,
+  STRING_SCHEMA,
+  arraySchema,
+  objectSchema,
+} from './method-catalog-shared.ts';
+import {
+  ARTIFACT_ATTACHMENT_SCHEMA,
+  JSON_VALUE_SCHEMA,
+  METADATA_SCHEMA,
+  STRING_LIST_SCHEMA,
+  enumSchema,
+  nullableSchema,
+  recordSchema,
+} from './operator-contract-schemas-shared.ts';
+
+const CONTROL_PLANE_MESSAGE_LEVEL_SCHEMA = enumSchema(['info', 'success', 'warn', 'error']);
+
+const CONTROL_PLANE_SERVER_CONFIG_SCHEMA = objectSchema({
+  enabled: BOOLEAN_SCHEMA,
+  host: STRING_SCHEMA,
+  port: NUMBER_SCHEMA,
+  baseUrl: STRING_SCHEMA,
+  streamingMode: enumSchema(['sse', 'websocket', 'both']),
+  sessionTtlMs: NUMBER_SCHEMA,
+}, ['enabled', 'host', 'port', 'streamingMode', 'sessionTtlMs']);
+
+export const CONTROL_AUTH_LOGIN_REQUEST_SCHEMA = objectSchema({
+  username: STRING_SCHEMA,
+  password: STRING_SCHEMA,
+}, ['username', 'password']);
+
+export const CONTROL_AUTH_LOGIN_RESPONSE_SCHEMA = objectSchema({
+  authenticated: BOOLEAN_SCHEMA,
+  token: STRING_SCHEMA,
+  username: STRING_SCHEMA,
+  expiresAt: NUMBER_SCHEMA,
+}, ['authenticated', 'token', 'username', 'expiresAt']);
+
+export const CONTROL_PLANE_CLIENT_DESCRIPTOR_SCHEMA = objectSchema({
+  id: STRING_SCHEMA,
+  surface: STRING_SCHEMA,
+  label: STRING_SCHEMA,
+  connectedAt: NUMBER_SCHEMA,
+  lastSeenAt: NUMBER_SCHEMA,
+  userId: STRING_SCHEMA,
+}, ['id', 'surface', 'label', 'connectedAt', 'lastSeenAt']);
+
+export const CONTROL_PLANE_SURFACE_MESSAGE_SCHEMA = objectSchema({
+  id: STRING_SCHEMA,
+  surface: STRING_SCHEMA,
+  createdAt: NUMBER_SCHEMA,
+  title: STRING_SCHEMA,
+  body: STRING_SCHEMA,
+  level: CONTROL_PLANE_MESSAGE_LEVEL_SCHEMA,
+  routeId: STRING_SCHEMA,
+  surfaceId: STRING_SCHEMA,
+  clientId: STRING_SCHEMA,
+  attachments: arraySchema(ARTIFACT_ATTACHMENT_SCHEMA),
+  metadata: METADATA_SCHEMA,
+}, ['id', 'surface', 'createdAt', 'title', 'body']);
+
+const CONTROL_PLANE_RECENT_EVENT_SCHEMA = objectSchema({
+  id: STRING_SCHEMA,
+  event: STRING_SCHEMA,
+  createdAt: NUMBER_SCHEMA,
+  payload: JSON_VALUE_SCHEMA,
+}, ['id', 'event', 'createdAt', 'payload']);
+
+const SETTINGS_FAILURE_SCHEMA = objectSchema({
+  surface: STRING_SCHEMA,
+  message: STRING_SCHEMA,
+  timestamp: NUMBER_SCHEMA,
+}, ['surface', 'message', 'timestamp']);
+
+const SETTINGS_CONFLICT_SCHEMA = objectSchema({
+  key: STRING_SCHEMA,
+  localValue: JSON_VALUE_SCHEMA,
+  incomingValue: JSON_VALUE_SCHEMA,
+  source: enumSchema(['synced']),
+  path: STRING_SCHEMA,
+  updatedAt: NUMBER_SCHEMA,
+}, ['key', 'localValue', 'incomingValue', 'source', 'path', 'updatedAt']);
+
+const SETTINGS_ROLLBACK_RECORD_SCHEMA = objectSchema({
+  token: STRING_SCHEMA,
+  profileName: STRING_SCHEMA,
+  path: STRING_SCHEMA,
+  appliedAt: NUMBER_SCHEMA,
+  restoredKeys: STRING_LIST_SCHEMA,
+  previousValues: recordSchema(JSON_VALUE_SCHEMA),
+}, ['token', 'profileName', 'path', 'appliedAt', 'restoredKeys', 'previousValues']);
+
+const SETTINGS_BUNDLE_CHANGE_SCHEMA = objectSchema({
+  key: STRING_SCHEMA,
+  previousValue: JSON_VALUE_SCHEMA,
+  nextValue: JSON_VALUE_SCHEMA,
+  changed: BOOLEAN_SCHEMA,
+  locked: BOOLEAN_SCHEMA,
+  source: STRING_SCHEMA,
+  reason: STRING_SCHEMA,
+}, ['key', 'previousValue', 'nextValue', 'changed', 'locked', 'source', 'reason']);
+
+const STAGED_MANAGED_BUNDLE_SCHEMA = objectSchema({
+  id: STRING_SCHEMA,
+  profileName: STRING_SCHEMA,
+  path: STRING_SCHEMA,
+  importedAt: NUMBER_SCHEMA,
+  changeCount: NUMBER_SCHEMA,
+  risk: enumSchema(['low', 'medium', 'high']),
+  changes: arraySchema(SETTINGS_BUNDLE_CHANGE_SCHEMA),
+}, ['id', 'profileName', 'path', 'importedAt', 'changeCount', 'risk', 'changes']);
+
+const SETTINGS_SNAPSHOT_UNAVAILABLE_SCHEMA = objectSchema({
+  available: BOOLEAN_SCHEMA,
+  reason: STRING_SCHEMA,
+}, ['available', 'reason']);
+
+const SETTINGS_SNAPSHOT_AVAILABLE_SCHEMA = objectSchema({
+  available: BOOLEAN_SCHEMA,
+  liveKeyCount: NUMBER_SCHEMA,
+  profileCount: NUMBER_SCHEMA,
+  managedLockCount: NUMBER_SCHEMA,
+  resolvedCounts: recordSchema(NUMBER_SCHEMA),
+  conflicts: arraySchema(SETTINGS_CONFLICT_SCHEMA),
+  recentFailures: arraySchema(SETTINGS_FAILURE_SCHEMA),
+  stagedManagedBundle: STAGED_MANAGED_BUNDLE_SCHEMA,
+  rollbackHistory: arraySchema(SETTINGS_ROLLBACK_RECORD_SCHEMA),
+}, ['available', 'liveKeyCount', 'profileCount', 'managedLockCount', 'resolvedCounts', 'conflicts', 'recentFailures', 'rollbackHistory']);
+
+export const SETTINGS_SNAPSHOT_SCHEMA: Record<string, unknown> = {
+  anyOf: [SETTINGS_SNAPSHOT_UNAVAILABLE_SCHEMA, SETTINGS_SNAPSHOT_AVAILABLE_SCHEMA],
+};
+
+const SESSION_RETURN_CONTEXT_SCHEMA = objectSchema({
+  activityLabel: STRING_SCHEMA,
+  statusLabel: STRING_SCHEMA,
+  lastUserPrompt: STRING_SCHEMA,
+  lastAssistantReply: STRING_SCHEMA,
+  pendingApprovals: NUMBER_SCHEMA,
+  toolCallCount: NUMBER_SCHEMA,
+  toolResultCount: NUMBER_SCHEMA,
+  assistantTurnCount: NUMBER_SCHEMA,
+  userTurnCount: NUMBER_SCHEMA,
+  lastRole: STRING_SCHEMA,
+  activeTasks: NUMBER_SCHEMA,
+  blockedTasks: NUMBER_SCHEMA,
+  remoteContracts: NUMBER_SCHEMA,
+  remoteRunners: STRING_LIST_SCHEMA,
+  worktreeCount: NUMBER_SCHEMA,
+  worktreePaths: STRING_LIST_SCHEMA,
+  openPanels: STRING_LIST_SCHEMA,
+  lines: STRING_LIST_SCHEMA,
+  assistedNarrative: STRING_SCHEMA,
+}, ['activityLabel', 'statusLabel', 'pendingApprovals', 'toolCallCount', 'toolResultCount', 'assistantTurnCount', 'userTurnCount', 'lines']);
+
+const RECOVERY_FILE_SCHEMA = objectSchema({
+  title: STRING_SCHEMA,
+  timestamp: NUMBER_SCHEMA,
+  sessionId: STRING_SCHEMA,
+  returnContext: SESSION_RETURN_CONTEXT_SCHEMA,
+}, ['title', 'timestamp', 'sessionId']);
+
+export const CONTINUITY_SNAPSHOT_SCHEMA = objectSchema({
+  sessionId: STRING_SCHEMA,
+  status: STRING_SCHEMA,
+  recoveryState: STRING_SCHEMA,
+  lastSessionPointer: nullableSchema(STRING_SCHEMA),
+  recoveryFilePresent: BOOLEAN_SCHEMA,
+  recoveryFile: nullableSchema(RECOVERY_FILE_SCHEMA),
+}, ['sessionId', 'status', 'recoveryState', 'lastSessionPointer', 'recoveryFilePresent', 'recoveryFile']);
+
+const WORKTREE_META_SCHEMA = objectSchema({
+  path: STRING_SCHEMA,
+  kind: enumSchema(['agent', 'orchestrator', 'manual']),
+  state: enumSchema(['active', 'paused', 'kept', 'discard', 'cleanup-pending']),
+  ownerId: STRING_SCHEMA,
+  sessionId: STRING_SCHEMA,
+  taskId: STRING_SCHEMA,
+  updatedAt: NUMBER_SCHEMA,
+}, ['path', 'kind', 'state', 'updatedAt']);
+
+const WORKTREE_SUMMARY_SCHEMA = objectSchema({
+  total: NUMBER_SCHEMA,
+  active: NUMBER_SCHEMA,
+  paused: NUMBER_SCHEMA,
+  kept: NUMBER_SCHEMA,
+  discard: NUMBER_SCHEMA,
+  cleanupPending: NUMBER_SCHEMA,
+  sessionAttached: NUMBER_SCHEMA,
+  taskAttached: NUMBER_SCHEMA,
+  agentOwned: NUMBER_SCHEMA,
+  orchestratorOwned: NUMBER_SCHEMA,
+  manualOwned: NUMBER_SCHEMA,
+}, ['total', 'active', 'paused', 'kept', 'discard', 'cleanupPending', 'sessionAttached', 'taskAttached', 'agentOwned', 'orchestratorOwned', 'manualOwned']);
+
+export const WORKTREE_SNAPSHOT_SCHEMA = objectSchema({
+  summary: WORKTREE_SUMMARY_SCHEMA,
+  records: arraySchema(WORKTREE_META_SCHEMA),
+}, ['summary', 'records']);
+
+export const CONTROL_PLANE_SNAPSHOT_SCHEMA = objectSchema({
+  server: CONTROL_PLANE_SERVER_CONFIG_SCHEMA,
+  totals: objectSchema({
+    clients: NUMBER_SCHEMA,
+    activeClients: NUMBER_SCHEMA,
+    surfaceMessages: NUMBER_SCHEMA,
+    recentEvents: NUMBER_SCHEMA,
+    requests: NUMBER_SCHEMA,
+    errors: NUMBER_SCHEMA,
+  }, ['clients', 'activeClients', 'surfaceMessages', 'recentEvents', 'requests', 'errors']),
+  clients: arraySchema(CONTROL_PLANE_CLIENT_DESCRIPTOR_SCHEMA),
+  messages: arraySchema(CONTROL_PLANE_SURFACE_MESSAGE_SCHEMA),
+  recentEvents: arraySchema(CONTROL_PLANE_RECENT_EVENT_SCHEMA),
+}, ['server', 'totals', 'clients', 'messages', 'recentEvents']);
+
+export const REVIEW_SNAPSHOT_SCHEMA = objectSchema({
+  apiFamilies: STRING_LIST_SCHEMA,
+  routes: STRING_LIST_SCHEMA,
+  sessions: NUMBER_SCHEMA,
+  tasks: NUMBER_SCHEMA,
+  pendingApprovals: NUMBER_SCHEMA,
+  remoteContracts: NUMBER_SCHEMA,
+  panels: NUMBER_SCHEMA,
+}, ['apiFamilies', 'routes', 'sessions', 'tasks', 'pendingApprovals', 'remoteContracts', 'panels']);

package/src/control-plane/operator-contract-schemas-domains.ts

@@ -0,0 +1,4 @@
+export * from './operator-contract-schemas-admin.ts';
+export * from './operator-contract-schemas-channels.ts';
+export * from './operator-contract-schemas-knowledge.ts';
+export * from './operator-contract-schemas-media.ts';