API Surface

The current source material defines product capabilities and module boundaries, but not stable request/response protocols. This page describes conceptual API surfaces so developers can understand what each module should expose.

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 authorization = await sak.genauth.delegate({
  userId: 'user_123',
  agentId: 'agent_researcher',
  scopes: ['web.search', 'mcp.gmail.read'],
  expiresIn: '30m'
})

Memory APIs

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

const context = await sak.gum.recall({
  userId: 'user_123',
  query: 'Find laptops for local LLM work',
  include: ['profile', 'chat', 'search', 'action']
})

Web Data APIs

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

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

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

Recommended integration order

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