A TypeScript SDK for driving Rozenite Agent sessions and tools programmatically.

@rozenite/agent-sdk provides a programmatic interface for the same agent workflow exposed by the rozenite agent CLI. The default API is automation-first: open or scope a session, inspect domains from the session handle, and call tools from the session handle.

Features

• Automation-First Client: Use withSession(...) for the default lifecycle
• Explicit Session Handles: Use openSession() / attachSession() when you need manual control
• Domain Resolution: Discover static and runtime plugin domains from session tools
• Tool Resolution: Call tools by name or via typed descriptors
• Auto Pagination: Merge paged tool responses when requested

Installation

Install the SDK as a dependency:

npm install @rozenite/agent-sdk

Usage

import { createAgentClient } from '@rozenite/agent-sdk';

const client = createAgentClient();
const result = await client.withSession(async (session) => {
  const domains = await session.domains.list();
  const tools = await session.tools.list({
    domain: 'network',
  });

  const requests = await session.tools.call({
    domain: 'network',
    tool: 'listRequests',
    args: { limit: 20 },
    autoPaginate: { pagesLimit: 2 },
  });

  return { domains, tools, requests };
});

console.log(result);

Made with ❤️ at Callstack

rozenite is an open source project and will always remain free to use. If you think it's cool, please star it 🌟.

Callstack is a group of React and React Native geeks, contact us at [email protected] if you need any help with these or just want to say hi!

Like the project? ⚛️ Join the team who does amazing stuff for clients and drives React Native Open Source! 🔥