Sessions
A session is a single cloud browser instance, addressable by session_id, that an
agent drives via per-tool calls (navigate, click, type, assert, snapshot,
screenshot).
Lifecycle
Section titled “Lifecycle”session.create → session.navigate → ...drive... → session.close ↑ (or idle/max-duration reaper)Sessions end when:
- You call
kifas.session.closeexplicitly. idle_timeout_seconds(default 90) elapses without activity.max_duration_seconds(default 1800 live; 300 test) is hit.- A tier limit (concurrent sessions, monthly browser-minutes) is exceeded.
Test mode vs live mode
Section titled “Test mode vs live mode”Sessions inherit the mode of the API key that created them. The docs sandbox uses a
test-mode key (kifas_test_*) capped at 5-minute max-duration; production agents
typically use live-mode keys (kifas_live_*) with the full 30-minute cap.
Tier-based concurrency
Section titled “Tier-based concurrency”| Plan | Concurrent sessions | Monthly browser-minutes |
|---|---|---|
| Free | 1 | 100 |
| Starter | 5 | 1,000 |
| Team | 25 | 10,000 |
| Business | custom | custom |
See tier limits for the full pricing matrix.
Pooling
Section titled “Pooling”Internally we hold one CDP connection per active session, kept warm so subsequent calls are sub-100ms after the first. The pool reaps idle sessions automatically; your client never has to think about it.