type XenoGoalStatus = "active" | "paused" | "waiting" | "blocked" | "completed" | "failed" | "cancelled"; declare const XENO_CONTROL_ROOM_SCHEMA_VERSION: "xeno.control-room.v1"; type XenoControlRoomAgentStatus = "queued" | "starting" | "running" | "working" | "idle" | "waiting_for_user" | "waiting_for_tool" | "waiting_for_hook" | "waiting_for_permission" | "blocked" | "paused" | "completed" | "failed" | "cancelled" | "interrupted" | "detached" | "unknown"; type XenoControlRoomStatusCategory = "queued" | "active" | "waiting" | "blocked" | "terminal"; interface XenoControlRoomUsage { inputTokens: number; outputTokens: number; totalTokens: number; cachedInputTokens?: number; estimatedCostUsd?: number; } interface XenoControlRoomAgentInput { agentId: string; runId?: string; sessionId?: string; parentAgentId?: string; rootAgentId?: string; workspaceId: string; teamId?: string; name: string; title?: string; profile?: string; model?: string; status: XenoControlRoomAgentStatus; statusReason?: string; currentStep?: string; currentTool?: string; createdAt: string; updatedAt: string; lastActivityAt?: string; heartbeatAt?: string; usage?: Partial; taskIds?: string[]; artifactIds?: string[]; allowedActions?: XenoControlRoomActionKind[]; transcriptRef?: string; executionBoundary?: { level: string; certified: boolean; adapter?: string; }; metadata?: Record; } interface XenoControlRoomAgent extends XenoControlRoomAgentInput { statusCategory: XenoControlRoomStatusCategory; depth: number; childAgentIds: string[]; orphaned: boolean; stale: boolean; elapsedMs: number; allowedActions: XenoControlRoomActionKind[]; usage: XenoControlRoomUsage; } interface XenoControlRoomTaskInput { taskId: string; title: string; status: "pending" | "in_progress" | "completed" | "blocked" | "skipped" | "failed"; ownerAgentId?: string; dependencyIds?: string[]; requirementIds?: string[]; artifactIds?: string[]; evidenceCount?: number; specId?: string; updatedAt: string; } interface XenoControlRoomTask extends XenoControlRoomTaskInput { dependencyIds: string[]; artifactIds: string[]; evidenceCount: number; orphanedOwner: boolean; blockedByTaskIds: string[]; } type XenoControlRoomApprovalKind = "artifact" | "plan" | "permission" | "external_action" | "capability_lease"; interface XenoControlRoomApprovalInput { approvalId: string; kind: XenoControlRoomApprovalKind; state: "pending" | "approved" | "rejected" | "expired" | "cancelled"; title: string; requestedByAgentId?: string; targetId: string; runId?: string; requestedAt: string; expiresAt?: string; scope: string; summary?: string; artifactRevision?: number; capabilityLeaseId?: string; } interface XenoControlRoomArtifactInput { artifactId: string; revision: number; kind: string; state: string; title: string; producerAgentId?: string; runId?: string; updatedAt: string; unresolvedComments?: number; } interface XenoControlRoomMonitorInput { monitorId: string; status: "running" | "completed" | "stopped" | "failed"; label: string; runId?: string; updatedAt: string; summary?: string; } interface XenoControlRoomGoalInput { goalId: string; status: Exclude | "complete" | "expired"; condition: string; runId?: string; updatedAt: string; nextAction?: string; } interface XenoControlRoomNotificationInput { notificationId: string; type: string; targetAgentId?: string; targetRunId?: string; createdAt: string; acknowledgedAt?: string; summary: string; } interface XenoControlRoomInput { agents: XenoControlRoomAgentInput[]; tasks?: XenoControlRoomTaskInput[]; approvals?: XenoControlRoomApprovalInput[]; artifacts?: XenoControlRoomArtifactInput[]; monitors?: XenoControlRoomMonitorInput[]; goals?: XenoControlRoomGoalInput[]; notifications?: XenoControlRoomNotificationInput[]; } type XenoControlRoomAttentionKind = "approval" | "blocked_agent" | "waiting_agent" | "failed_agent" | "stale_agent" | "orphaned_agent" | "blocked_task" | "orphaned_task" | "blocked_goal" | "orphaned_notification"; interface XenoControlRoomAttentionItem { attentionId: string; kind: XenoControlRoomAttentionKind; priority: "critical" | "high" | "normal"; targetId: string; title: string; summary: string; createdAt: string; actions: XenoControlRoomActionKind[]; } interface XenoControlRoomSummary { agents: number; activeAgents: number; waitingAgents: number; blockedAgents: number; terminalAgents: number; staleAgents: number; orphanedAgents: number; tasks: number; completedTasks: number; blockedTasks: number; pendingApprovals: number; activeMonitors: number; activeGoals: number; unacknowledgedNotifications: number; usage: XenoControlRoomUsage; } interface XenoControlRoomSnapshot { schemaVersion: typeof XENO_CONTROL_ROOM_SCHEMA_VERSION; snapshotId: string; generatedAt: string; staleAfterMs: number; sourceFingerprint: string; snapshotHash: string; agents: XenoControlRoomAgent[]; rootAgentIds: string[]; tasks: XenoControlRoomTask[]; approvals: XenoControlRoomApprovalInput[]; artifacts: XenoControlRoomArtifactInput[]; monitors: XenoControlRoomMonitorInput[]; goals: XenoControlRoomGoalInput[]; notifications: XenoControlRoomNotificationInput[]; attention: XenoControlRoomAttentionItem[]; summary: XenoControlRoomSummary; } interface XenoControlRoomProjectionOptions { snapshotId?: string; generatedAt?: string; staleAfterMs?: number; } type XenoControlRoomActionKind = "jump" | "steer" | "follow_up" | "stop" | "retry" | "approve" | "reject" | "acknowledge"; interface XenoControlRoomActionRequest { actionId: string; snapshotHash: string; kind: XenoControlRoomActionKind; targetId: string; actorId: string; requestedAt: string; message?: string; reason?: string; scope?: string; } interface XenoControlRoomActionPlan { schemaVersion: "xeno.control-room-action.v1"; actionId: string; kind: XenoControlRoomActionKind; targetId: string; actorId: string; requestedAt: string; expectedSnapshotHash: string; idempotencyKey: string; authority: "read" | "agent_message" | "process_control" | "approval_decision" | "notification_ack"; confirmationRequired: boolean; scope: string; payload: Record; } declare class XenoControlRoomValidationError extends Error { constructor(message: string); } declare function projectXenoControlRoom(input: XenoControlRoomInput, options?: XenoControlRoomProjectionOptions): XenoControlRoomSnapshot; declare function planXenoControlRoomAction(snapshot: XenoControlRoomSnapshot, request: XenoControlRoomActionRequest): XenoControlRoomActionPlan; declare function validateXenoControlRoomSnapshot(snapshot: XenoControlRoomSnapshot): XenoControlRoomSnapshot; export { XENO_CONTROL_ROOM_SCHEMA_VERSION, type XenoControlRoomActionKind, type XenoControlRoomActionPlan, type XenoControlRoomActionRequest, type XenoControlRoomAgent, type XenoControlRoomAgentInput, type XenoControlRoomAgentStatus, type XenoControlRoomApprovalInput, type XenoControlRoomApprovalKind, type XenoControlRoomArtifactInput, type XenoControlRoomAttentionItem, type XenoControlRoomAttentionKind, type XenoControlRoomGoalInput, type XenoControlRoomInput, type XenoControlRoomMonitorInput, type XenoControlRoomNotificationInput, type XenoControlRoomProjectionOptions, type XenoControlRoomSnapshot, type XenoControlRoomStatusCategory, type XenoControlRoomSummary, type XenoControlRoomTask, type XenoControlRoomTaskInput, type XenoControlRoomUsage, XenoControlRoomValidationError, planXenoControlRoomAction, projectXenoControlRoom, validateXenoControlRoomSnapshot };