Capabilities

v0.1.0

A semantic skill taxonomy that lets you match, route, and verify what any identity can do

Python

bash

pip install human-sdk

Register

Match

Match capabilities to requirements

Get

Get capability by ID

List

List capabilities

Types

python

interface Capability {
  /** Unique capability ID */
  capability_id: string;
  /** Passport ID that owns this capability */
  passport_id: string;
  /** Capability domain (e.g., 'invoice', 'data', 'email') */
  domain: string;
  /** Actions this capability enables */
  actions: string[];
  /** Confidence score (0-1) */
  confidence?: number;
  /** Evidence of capability */
  evidence?: CapabilityEvidence[];
}

interface CapabilityEvidence {
  /** Evidence type */
  type: 'certification' | 'demonstration' | 'attestation';
  /** Evidence description */
  description: string;
  /** Evidence URL or reference */
  reference?: string;
  /** When evidence was created */
  created_at: string;
}

interface RegisterCapabilityRequest {
  /** Passport ID registering capability */
  passport_id: string;
  /** Capability domain */
  domain: string;
  /** Actions */
  actions: string[];
  /** Optional confidence score */
  confidence?: number;
  /** Optional evidence */
  evidence?: Omit<CapabilityEvidence, 'created_at'>[];
  /** Optional metadata */
  metadata?: Record<string, string | number | boolean>;
}

interface CapabilityMatchRequest {
  /** Task description or domain */
  task: string;
  /** Required actions */
  required_actions?: string[];
  /** Minimum confidence threshold */
  min_confidence?: number;
  /** Maximum results to return */
  limit?: number;
}

interface CapabilityMatch {
  /** Matched capability */
  capability: Capability;
  /** Match score (0-1) */
  score: number;
  /** Match explanation */
  explanation?: string;
}

interface CapabilityListFilters {
  /** Filter by passport ID */
  passport_id?: string;
  /** Filter by domain */
  domain?: string;
  /** Minimum confidence threshold */
  min_confidence?: number;
}