tinyhumans 0.1.0

Rust SDK for the TinyHumans backend
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

# API Surface

The SDK surface is grounded in the deployed Swagger/OpenAPI contract at
<https://api.tinyhumans.ai/swagger.json>. The spec reports TinyHumans API
`1.0.0` with 205 paths and 235 operations. The Rust SDK exposes one typed
method per public operation — **187 operations across the 20 namespaces
below**.
The remaining 35 administrative and 18 webhook operations are intentionally
excluded, including legacy routes whose summaries explicitly say they are
admin-only.

| Namespace | Base path | Auth | Examples |
| --- | --- | --- | --- |
| `health` | `/` | none | `check()` liveness |
| `auth` | `/auth` | bearer | email login, OAuth, `me()`, integration tokens |
| `inference` | `/openai` | bearer | `GET /v1/models`, chat completions, responses, transcription |
| `agentIntegrations` | `/agent-integrations` | bearer | Composio, Parallel, media generation, maps, Apify, Twilio, crypto |
| `apiKeys` | `/api-keys` | bearer | create, list, and revoke user API keys |
| `budgets` | `/budgets` | bearer | team budgets and seat allocations |
| `medulla` | `/medulla` | bearer | roster, routing, sessions, messages, tasks, and sources |
| `openCompany` | `/opencompany` | bearer | company instances, lifecycle, and custom domains |
| `orchestration` | `/orchestration` | bearer | runs, events, sessions, state, and world diffs |
| `payments` | `/payments` | bearer | Stripe, Coinbase, credits, transactions, plans |
| `feedback` | `/feedback` | bearer | create, ingest, list, detail, vote, and comments |
| `teams` | `/teams` | bearer | team list/detail, usage, invites, join, leave, and billing |
| `channels` | `/channels` | bearer | messages, reactions, typing, threads |
| `mascots` | `/mascots` | mixed | catalog, render streams, meetings, Rive assets |
| `announcements` | `/announcements` | bearer | latest active announcement |
| `coupons` | `/coupons` | bearer | redemption and coupon history |
| `invite` | `/invite` | mixed | invite status, redemption, and owned codes |
| `referral` | `/referral` | bearer | referral stats and claim |
| `rewards` | `/rewards` | bearer | reward snapshot and Discord unlink |
| `redirect` | `/r` | none | resolve short redirect codes |

The checked-in namespace manifest and Rust `PUBLIC_ROUTES` registry are
generated deterministically:

```bash
node scripts/sync-openapi.mjs
node scripts/sync-openapi.mjs --check
```

Most JSON responses use the hosted-backend envelope:

```json
{
  "success": true,
  "data": {}
}
```

SDK request helpers unwrap this envelope by default. The raw helper can return the
full response body when callers need status metadata or non-standard payloads.