API Surface

Draft interface

The examples below express integration intent. They are not final SDK or HTTP contracts.

Identity APIs

Identity APIs bind user identity, Agent Profiles, and tool permissions into auditable authorization context.

const { data } = await qoni.delegateToken({
  mode: 'interactive',
  agent: 'agent_researcher',
  scopes: ['webagent.web_search:manage', 'webagent.web_search:read'],
  redirectUri: 'http://localhost:3000/qoni/callback',
  state: 'req-001',
  user: { id: 'user_123' },
  expiresIn: 1800, // seconds
})

Authoritative contract

For the full identity endpoints, fields and error codes, see GenAuth's API Reference and SDK Reference — both are verified against the code line by line.

Memory APIs

Memory APIs write, retrieve, explain, and erase user context.

const { data: context } = await qoni.gumem.recall({
  token,
  sessionId: 'daily-assistant',
  query: 'Find laptops for local LLM work'
})

Web Data APIs

Web Data APIs turn the open web into structured input and execute browser actions in sandboxes.

const page = await qoni.web.textify({
  url: 'https://example.com/report',
  format: 'markdown'
})

const result = await qoni.web.search({
  query: 'agent memory benchmark',
  mode: 'research'
})

Recommended integration order

1. Add GenAuth for user and agent authorization boundaries.
2. Add GUMem for explainable user context.
3. Add Web Agent for live web data and browser action.