Capabilities

v0.1.0

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

Typescript

bash

npm install @human/client-sdk

Register

Match

Match capabilities to requirements (POST /v1/capabilities/match, snake_case body).

Get

Get capability by ID

List

List capabilities

Types

typescript

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 {
  /** Organization id */
  org_id: string;
  /** Required capability ids */
  required_capabilities: string[];
  /** Minimum confidence threshold (0–1), default 0.5 */
  min_confidence?: number;
  /** Include humans in results (default true) */
  include_humans?: boolean;
  /** Include agents in results (default true) */
  include_agents?: boolean;
  /** Max results per pool (default 20, max 100) */
  limit?: number;
}

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