HumanOS

v0.1.0

The orchestration layer that routes work between humans and AI with built-in safety controls

Python

bash

pip install human-sdk

Orchestrate

Orchestrate a task

Get Status

Get orchestration status

Cancel

Cancel an orchestration

Approve

Approve a pending orchestration

Reject

Reject a pending orchestration

Types

python

interface Orchestration {
  /** Unique orchestration ID */
  orchestration_id: string;
  /** Current status */
  status: AsyncStatus;
  /** Task description */
  task: OrchestrationTask;
  /** Required capabilities */
  required_capabilities: string[];
  /** Assigned resource (passport ID) */
  assigned_to?: string;
  /** Result (when completed) */
  result?: unknown;
  /** Error (when failed) */
  error?: string;
  /** When task was started */
  started_at?: Timestamp;
  /** When task was completed/failed */
  completed_at?: Timestamp;
}

interface OrchestrationTask {
  /** Task type/domain */
  type: string;
  /** Task input data */
  input: unknown;
  /** Task priority (1-10, default: 5) */
  priority?: number;
  /** Task deadline */
  deadline?: Timestamp;
}

interface OrchestrationRequest {
  /** Task details */
  task: OrchestrationTask;
  /** Required capabilities */
  required_capabilities?: string[];
  /** Preferred assignee passport ID */
  preferred_assignee?: string;
  /** Whether task requires human approval */
  requires_approval?: boolean;
  /** Optional metadata */
  metadata?: Record<string, string | number | boolean>;
}

interface OrchestrationStatus {
  /** Progress percentage (0-100) */
  progress?: number;
  /** Current step description */
  current_step?: string;
}

interface ApprovalDecision {
  /** Decision */
  decision: 'approved' | 'rejected';
  /** Optional feedback */
  feedback?: string;
  /** Modified task input (if approved with changes) */
  modified_input?: unknown;
}