Feat/agents sdk

[manapard]

Description

Introduces @rozenite/agent-sdk, a new SDK for programmatic use of Rozenite agent sessions and tools.

The existing rozenite agent CLI is refactored to use the SDK internally and extracted reusable agent logic from the CLI into the SDK:

• HTTP transport
• static/runtime domain discovery
• domain and tool resolution
• optional tool auto-pagination

Also added website docs for the new Agent SDK.

Related Issue

Context

Testing

[V3RON]

We can make it generic <TArgs, TResult>, so it's easier to provide types later on.

[V3RON]

I wonder if there's a way to safely expose tools from plugins without bringing in any JavaScript or third-party packages. We'd probably need a separate entry point, like @rozenite/storage-plugin/sdk

[V3RON]

I'm not an author 😛 Feel free to put yourself here!

[V3RON]

1. High: packages/agent-sdk/src/pagination.ts:88-100,128-129
   maxItems is not enforced on the first page.
   The helper seeds merged.items with all of initial.items before any truncation logic runs, and only trims subsequent pages. If the first response already exceeds maxItems, the SDK returns too many items.
   Validation:
   packages/middleware/src/agent/runtime/pagination/paginate.ts:81-89 and packages/network-activity-plugin/src/react-native/agent/state.ts:199-205 show paged tools may legitimately return up to the requested page limit on page 1, so the SDK must enforce its own client-side cap consistently.
   Test gap:
   packages/agent-sdk/src/__tests__/pagination.test.ts:50-77 only covers truncation after fetching page 2, not an oversized first page.
   
2. Medium: packages/agent-sdk/src/pagination.ts:117-124
   hasMore can become incorrect when maxItems truncates the merged result.
   After truncating, the code unconditionally sets merged.page.hasMore = true. If the last fetched page actually had hasMore: false and no nextCursor, the SDK returns pagination metadata that implies another page exists when it does not.
   Validation:
   The shared pagination contract in packages/middleware/src/agent/runtime/pagination/types.ts:9-20 and implementation in packages/middleware/src/agent/runtime/pagination/paginate.ts:69-89 show hasMore and nextCursor are coupled server facts. Fabricating hasMore: true client-side can produce an impossible state.
   Test gap:
   No test covers truncation on a terminal page.