@xenosystem/agent-sdk 0.8.12

package/dist/control-room/index.d.cts

@@ -0,0 +1,216 @@
+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<XenoControlRoomUsage>;
+    taskIds?: string[];
+    artifactIds?: string[];
+    allowedActions?: XenoControlRoomActionKind[];
+    transcriptRef?: string;
+    executionBoundary?: {
+        level: string;
+        certified: boolean;
+        adapter?: string;
+    };
+    metadata?: Record<string, string | number | boolean>;
+}
+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: "active" | "complete" | "blocked" | "cancelled" | "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<string, string>;
+}
+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 };

package/dist/control-room/index.d.ts

@@ -0,0 +1,216 @@
+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<XenoControlRoomUsage>;
+    taskIds?: string[];
+    artifactIds?: string[];
+    allowedActions?: XenoControlRoomActionKind[];
+    transcriptRef?: string;
+    executionBoundary?: {
+        level: string;
+        certified: boolean;
+        adapter?: string;
+    };
+    metadata?: Record<string, string | number | boolean>;
+}
+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: "active" | "complete" | "blocked" | "cancelled" | "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<string, string>;
+}
+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 };

package/dist/control-room/index.js

@@ -0,0 +1 @@
+var y="xeno.control-room.v1";import{createHash as H,randomUUID as K}from"node:crypto";var E=6e4,s=class extends Error{constructor(n){super(n),this.name="XenoControlRoomValidationError"}};function at(t,n={}){let r=k(n.generatedAt??new Date().toISOString(),"generatedAt"),a=Date.parse(r),l=tt(n.staleAfterMs??E,1e3,864e5,"staleAfterMs");A(t.agents.map(o=>o.agentId),"agent"),A((t.tasks??[]).map(o=>o.taskId),"task"),A((t.approvals??[]).map(o=>o.approvalId),"approval"),A((t.artifacts??[]).map(o=>`${o.artifactId}:${o.revision}`),"artifact revision");let i=new Map(t.agents.map(o=>[o.agentId,F(o)]));P(i);let g=new Map;for(let o of i.values())!o.parentAgentId||!i.has(o.parentAgentId)||g.set(o.parentAgentId,[...g.get(o.parentAgentId)??[],o.agentId]);let p=V(i),e=[...i.values()].map(o=>{let d=L(o.status),u=Date.parse(o.heartbeatAt??o.lastActivityAt??o.updatedAt),b=(d==="active"||d==="waiting"||d==="queued")&&Number.isFinite(u)&&a-u>l,N=Date.parse(o.createdAt);return{...o,statusCategory:d,depth:p(o.agentId),childAgentIds:(g.get(o.agentId)??[]).sort(),orphaned:!!(o.parentAgentId&&!i.has(o.parentAgentId)),stale:b,elapsedMs:Number.isFinite(N)?Math.max(0,a-N):0,allowedActions:J(o,d),usage:W(o.usage)}}).sort(Q),c=new Set(e.map(o=>o.agentId)),m=(t.tasks??[]).map(o=>({...o,dependencyIds:[...new Set(o.dependencyIds??[])].sort(),artifactIds:[...new Set(o.artifactIds??[])].sort(),evidenceCount:nt(o.evidenceCount??0,"task evidenceCount"),orphanedOwner:!!(o.ownerAgentId&&!c.has(o.ownerAgentId)),blockedByTaskIds:(o.dependencyIds??[]).filter(d=>{let u=t.tasks?.find(b=>b.taskId===d);return!u||u.status!=="completed"}).sort()})).sort((o,d)=>o.taskId.localeCompare(d.taskId));z(m);let R=[...t.approvals??[]].sort((o,d)=>Date.parse(o.requestedAt)-Date.parse(d.requestedAt)),O=[...t.artifacts??[]].sort((o,d)=>o.artifactId.localeCompare(d.artifactId)||o.revision-d.revision),x=[...t.monitors??[]].sort((o,d)=>o.monitorId.localeCompare(d.monitorId)),w=[...t.goals??[]].sort((o,d)=>o.goalId.localeCompare(d.goalId)),X=[...t.notifications??[]].sort((o,d)=>Date.parse(o.createdAt)-Date.parse(d.createdAt)),U=Z(e,m,R,w,X),M=e.reduce((o,d)=>q(o,d.usage),Y()),j={agents:e.length,activeAgents:e.filter(o=>o.statusCategory==="active").length,waitingAgents:e.filter(o=>o.statusCategory==="waiting").length,blockedAgents:e.filter(o=>o.statusCategory==="blocked").length,terminalAgents:e.filter(o=>o.statusCategory==="terminal").length,staleAgents:e.filter(o=>o.stale).length,orphanedAgents:e.filter(o=>o.orphaned).length,tasks:m.length,completedTasks:m.filter(o=>o.status==="completed").length,blockedTasks:m.filter(o=>o.status==="blocked"||o.blockedByTaskIds.length>0).length,pendingApprovals:R.filter(o=>o.state==="pending").length,activeMonitors:x.filter(o=>o.status==="running").length,activeGoals:w.filter(o=>o.status==="active"||o.status==="blocked").length,unacknowledgedNotifications:X.filter(o=>!o.acknowledgedAt).length,usage:M},S={agents:e,rootAgentIds:e.filter(o=>!o.parentAgentId||!c.has(o.parentAgentId)).map(o=>o.agentId),tasks:m,approvals:R,artifacts:O,monitors:x,goals:w,notifications:X,attention:U,summary:j},D=C(_(S)),$={schemaVersion:y,snapshotId:n.snapshotId?.trim()||`control_room_${K()}`,generatedAt:r,staleAfterMs:l,sourceFingerprint:D,...S};return{...$,snapshotHash:C(_($))}}function it(t,n){if(B(t),n.snapshotHash!==t.snapshotHash)throw new s("Control-room action targets a stale snapshot");h(n.actionId,"actionId"),h(n.actorId,"actorId"),k(n.requestedAt,"requestedAt");let r=t.agents.find(c=>c.agentId===n.targetId||c.runId===n.targetId||c.sessionId===n.targetId),a=t.approvals.find(c=>c.approvalId===n.targetId),l=t.notifications.find(c=>c.notificationId===n.targetId),i,g=!1,p=n.scope?.trim()||"target",e={};if(n.kind==="jump"){if(!r&&!a&&!l)throw new s("Jump target is not present in the snapshot");i="read"}else if(n.kind==="steer"||n.kind==="follow_up"){if(!r||!r.allowedActions.includes(n.kind))throw new s(`${n.kind} is not available for this agent`);e.message=v(n.message,"message"),i="agent_message"}else if(n.kind==="stop"||n.kind==="retry"){if(!r||!r.allowedActions.includes(n.kind))throw new s(`${n.kind} is not available for this agent`);n.reason?.trim()&&(e.reason=n.reason.trim()),i="process_control",g=n.kind==="stop"}else if(n.kind==="approve"||n.kind==="reject"){if(!a||a.state!=="pending")throw new s("Approval target is not pending in this snapshot");if(n.reason?.trim()&&(e.reason=n.reason.trim()),n.kind==="reject"&&!e.reason)throw new s("A rejection reason is required");i="approval_decision",g=!0,p=n.scope?.trim()||a.scope}else if(n.kind==="acknowledge"){if(!l||l.acknowledgedAt)throw new s("Notification target is not awaiting acknowledgement");i="notification_ack"}else throw new s(`Unsupported control-room action: ${String(n.kind)}`);return{schemaVersion:"xeno.control-room-action.v1",actionId:n.actionId,kind:n.kind,targetId:n.targetId,actorId:n.actorId,requestedAt:n.requestedAt,expectedSnapshotHash:t.snapshotHash,idempotencyKey:C(`${t.snapshotHash}:${n.actionId}:${n.kind}:${n.targetId}`),authority:i,confirmationRequired:g,scope:p,payload:e}}function B(t){if(t.schemaVersion!==y)throw new s("Unsupported control-room schema");let{snapshotHash:n,...r}=t;if(C(_(r))!==t.snapshotHash)throw new s("Control-room snapshot hash mismatch");return t}function F(t){if(h(t.agentId,"agentId"),v(t.workspaceId,"workspaceId"),v(t.name,"agent name"),k(t.createdAt,"agent createdAt"),k(t.updatedAt,"agent updatedAt"),t.parentAgentId===t.agentId)throw new s(`Agent ${t.agentId} cannot parent itself`);return{...t,taskIds:[...new Set(t.taskIds??[])].sort(),artifactIds:[...new Set(t.artifactIds??[])].sort()}}function P(t){for(let n of t.values()){let r=new Set,a=n;for(;a?.parentAgentId&&t.has(a.parentAgentId);){if(r.has(a.agentId))throw new s(`Agent hierarchy contains a cycle at ${a.agentId}`);r.add(a.agentId),a=t.get(a.parentAgentId)}}}function V(t){let n=new Map;return function r(a){let l=n.get(a);if(l!==void 0)return l;let i=t.get(a)?.parentAgentId,g=i&&t.has(i)?r(i)+1:0;return n.set(a,g),g}}function z(t){let n=new Set(t.map(r=>r.taskId));for(let r of t){if(r.dependencyIds.includes(r.taskId))throw new s(`Task ${r.taskId} depends on itself`);for(let a of r.dependencyIds)if(!n.has(a))throw new s(`Task ${r.taskId} has unknown dependency ${a}`)}}function L(t){return t==="queued"||t==="starting"?"queued":t==="running"||t==="working"||t==="idle"||t==="detached"?"active":t==="waiting_for_user"||t==="waiting_for_tool"||t==="waiting_for_hook"||t==="waiting_for_permission"||t==="paused"?"waiting":t==="blocked"?"blocked":"terminal"}function G(t){return t==="active"||t==="waiting"||t==="blocked"||t==="queued"?["jump","steer","follow_up","stop"]:["jump","retry"]}function J(t,n){let r=G(n);if(t.allowedActions===void 0)return r;let a=[...new Set(t.allowedActions)];for(let l of a)if(!r.includes(l))throw new s(`Agent ${t.agentId} cannot advertise ${l} while ${n}`);return r.filter(l=>a.includes(l))}function Z(t,n,r,a,l){let i=[],g=new Set(t.map(e=>e.agentId));for(let e of r.filter(c=>c.state==="pending"))i.push({attentionId:`attention:approval:${e.approvalId}`,kind:"approval",priority:"critical",targetId:e.approvalId,title:e.title,summary:e.summary??`${e.kind} approval requested for ${e.scope}`,createdAt:e.requestedAt,actions:["jump","approve","reject"]});for(let e of t)e.statusCategory==="blocked"?i.push(I(e,"blocked_agent","high",e.statusReason??"Agent is blocked")):e.statusCategory==="waiting"?i.push(I(e,"waiting_agent","high",e.statusReason??"Agent is waiting")):e.status==="failed"&&i.push(I(e,"failed_agent","high",e.statusReason??"Agent failed")),e.stale&&i.push(I(e,"stale_agent","high","Agent heartbeat is stale")),e.orphaned&&i.push(I(e,"orphaned_agent","normal",`Parent agent ${e.parentAgentId} is missing`));for(let e of n)(e.status==="blocked"||e.blockedByTaskIds.length)&&i.push({attentionId:`attention:task:${e.taskId}`,kind:"blocked_task",priority:"high",targetId:e.taskId,title:e.title,summary:e.blockedByTaskIds.length?`Blocked by ${e.blockedByTaskIds.join(", ")}`:"Task is blocked",createdAt:e.updatedAt,actions:["jump"]}),e.orphanedOwner&&i.push({attentionId:`attention:task-owner:${e.taskId}`,kind:"orphaned_task",priority:"normal",targetId:e.taskId,title:e.title,summary:`Assigned agent ${e.ownerAgentId} is missing`,createdAt:e.updatedAt,actions:["jump"]});for(let e of a.filter(c=>c.status==="blocked"))i.push({attentionId:`attention:goal:${e.goalId}`,kind:"blocked_goal",priority:"high",targetId:e.goalId,title:"Blocked goal",summary:e.nextAction??e.condition,createdAt:e.updatedAt,actions:["jump"]});for(let e of l.filter(c=>!c.acknowledgedAt&&c.targetAgentId&&!g.has(c.targetAgentId)))i.push({attentionId:`attention:notification:${e.notificationId}`,kind:"orphaned_notification",priority:"normal",targetId:e.notificationId,title:"Orphaned notification",summary:e.summary,createdAt:e.createdAt,actions:["jump","acknowledge"]});let p={critical:0,high:1,normal:2};return i.sort((e,c)=>p[e.priority]-p[c.priority]||Date.parse(e.createdAt)-Date.parse(c.createdAt))}function I(t,n,r,a){return{attentionId:`attention:${n}:${t.agentId}`,kind:n,priority:r,targetId:t.agentId,title:t.title??t.name,summary:a,createdAt:t.lastActivityAt??t.updatedAt,actions:t.allowedActions}}function Q(t,n){return t.depth-n.depth||t.agentId.localeCompare(n.agentId)}function W(t){let n=f(t?.inputTokens),r=f(t?.outputTokens);return{inputTokens:n,outputTokens:r,totalTokens:f(t?.totalTokens??n+r),...t?.cachedInputTokens!==void 0?{cachedInputTokens:f(t.cachedInputTokens)}:{},...t?.estimatedCostUsd!==void 0?{estimatedCostUsd:f(t.estimatedCostUsd)}:{}}}function Y(){return{inputTokens:0,outputTokens:0,totalTokens:0,cachedInputTokens:0,estimatedCostUsd:0}}function q(t,n){return{inputTokens:t.inputTokens+n.inputTokens,outputTokens:t.outputTokens+n.outputTokens,totalTokens:t.totalTokens+n.totalTokens,cachedInputTokens:(t.cachedInputTokens??0)+(n.cachedInputTokens??0),estimatedCostUsd:(t.estimatedCostUsd??0)+(n.estimatedCostUsd??0)}}function A(t,n){let r=new Set;for(let a of t){if(h(a,`${n} ID`),r.has(a))throw new s(`Duplicate ${n} ID: ${a}`);r.add(a)}}function h(t,n){let r=t?.trim()??"";if(!/^[A-Za-z0-9][A-Za-z0-9._:-]{0,255}$/u.test(r))throw new s(`${n} is invalid`);return r}function v(t,n){let r=t?.trim()??"";if(!r||r.length>64*1024)throw new s(`${n} is required`);return r}function k(t,n){if(!Number.isFinite(Date.parse(t)))throw new s(`${n} must be a valid timestamp`);return t}function tt(t,n,r,a){if(!Number.isInteger(t)||t<n||t>r)throw new s(`${a} must be between ${n} and ${r}`);return t}function nt(t,n){if(!Number.isInteger(t)||t<0)throw new s(`${n} must be a non-negative integer`);return t}function f(t){return Number.isFinite(t)?Math.max(0,t??0):0}function C(t){return H("sha256").update(t,"utf8").digest("hex")}function _(t){return JSON.stringify(T(t))}function T(t){return Array.isArray(t)?t.map(T):!t||typeof t!="object"?t:Object.fromEntries(Object.entries(t).filter(([,n])=>n!==void 0).sort(([n],[r])=>n.localeCompare(r)).map(([n,r])=>[n,T(r)]))}export{y as XENO_CONTROL_ROOM_SCHEMA_VERSION,s as XenoControlRoomValidationError,it as planXenoControlRoomAction,at as projectXenoControlRoom,B as validateXenoControlRoomSnapshot};

package/dist/control-room/metafile-cjs.json

@@ -0,0 +1 @@
+{"inputs":{"src/control-room/types.ts":{"bytes":7136,"imports":[],"format":"esm"},"src/control-room/projector.ts":{"bytes":21797,"imports":[{"path":"node:crypto","kind":"import-statement","external":true},{"path":"src/control-room/types.ts","kind":"import-statement","original":"./types.js"}],"format":"esm"},"src/control-room/index.ts":{"bytes":62,"imports":[{"path":"src/control-room/types.ts","kind":"import-statement","original":"./types.js"},{"path":"src/control-room/projector.ts","kind":"import-statement","original":"./projector.js"}],"format":"esm"}},"outputs":{"dist/control-room/index.cjs":{"imports":[{"path":"node:crypto","kind":"require-call","external":true}],"exports":[],"entryPoint":"src/control-room/index.ts","inputs":{"src/control-room/index.ts":{"bytesInOutput":214},"src/control-room/types.ts":{"bytesInOutput":29},"src/control-room/projector.ts":{"bytesInOutput":11006}},"bytes":11842}}}

package/dist/control-room/metafile-esm.json

@@ -0,0 +1 @@
+{"inputs":{"src/control-room/types.ts":{"bytes":7136,"imports":[],"format":"esm"},"src/control-room/projector.ts":{"bytes":21797,"imports":[{"path":"node:crypto","kind":"import-statement","external":true},{"path":"src/control-room/types.ts","kind":"import-statement","original":"./types.js"}],"format":"esm"},"src/control-room/index.ts":{"bytes":62,"imports":[{"path":"src/control-room/types.ts","kind":"import-statement","original":"./types.js"},{"path":"src/control-room/projector.ts","kind":"import-statement","original":"./projector.js"}],"format":"esm"}},"outputs":{"dist/control-room/index.js":{"imports":[{"path":"node:crypto","kind":"import-statement","external":true}],"exports":["XENO_CONTROL_ROOM_SCHEMA_VERSION","XenoControlRoomValidationError","planXenoControlRoomAction","projectXenoControlRoom","validateXenoControlRoomSnapshot"],"entryPoint":"src/control-room/index.ts","inputs":{"src/control-room/types.ts":{"bytesInOutput":29},"src/control-room/index.ts":{"bytesInOutput":0},"src/control-room/projector.ts":{"bytesInOutput":10991}},"bytes":11201}}}