@rozenite/network-activity-plugin 1.7.0 → 1.8.1

package/dist/sdk/index.js

@@ -0,0 +1,127 @@
+import { defineAgentToolContract, defineAgentToolDescriptors } from "@rozenite/agent-shared";
+const NETWORK_ACTIVITY_AGENT_PLUGIN_ID = "@rozenite/network-activity-plugin";
+const networkActivityToolDefinitions = {
+  startRecording: defineAgentToolContract({
+    name: "startRecording",
+    description: "Start recording network activity in the fallback network activity plugin.",
+    inputSchema: {
+      type: "object",
+      properties: {}
+    }
+  }),
+  stopRecording: defineAgentToolContract({
+    name: "stopRecording",
+    description: "Stop recording network activity without clearing the captured plugin buffer.",
+    inputSchema: {
+      type: "object",
+      properties: {}
+    }
+  }),
+  getRecordingStatus: defineAgentToolContract({
+    name: "getRecordingStatus",
+    description: "Return network activity plugin recording state and buffer metadata.",
+    inputSchema: {
+      type: "object",
+      properties: {}
+    }
+  }),
+  listRequests: defineAgentToolContract({
+    name: "listRequests",
+    description: "List captured HTTP request summaries with cursor pagination from the fallback plugin.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        limit: {
+          type: "number",
+          description: "Maximum number of requests to return. Defaults to 20."
+        },
+        cursor: {
+          type: "string",
+          description: "Opaque pagination cursor from a previous listRequests call."
+        }
+      }
+    }
+  }),
+  getRequestDetails: defineAgentToolContract({
+    name: "getRequestDetails",
+    description: "Return detailed metadata for a captured HTTP request without fetching response body.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        requestId: {
+          type: "string",
+          description: "Captured plugin request ID to inspect."
+        }
+      },
+      required: ["requestId"]
+    }
+  }),
+  getRequestBody: defineAgentToolContract({
+    name: "getRequestBody",
+    description: "Return the captured request body for a plugin-recorded HTTP request when available.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        requestId: {
+          type: "string",
+          description: "Captured plugin request ID to inspect."
+        }
+      },
+      required: ["requestId"]
+    }
+  }),
+  getResponseBody: defineAgentToolContract({
+    name: "getResponseBody",
+    description: "Return the captured response body for a plugin-recorded HTTP request when available.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        requestId: {
+          type: "string",
+          description: "Captured plugin request ID to inspect."
+        }
+      },
+      required: ["requestId"]
+    }
+  }),
+  listRealtimeConnections: defineAgentToolContract({
+    name: "listRealtimeConnections",
+    description: "List captured WebSocket and SSE connections with cursor pagination.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        limit: {
+          type: "number",
+          description: "Maximum number of realtime connections to return. Defaults to 20."
+        },
+        cursor: {
+          type: "string",
+          description: "Opaque pagination cursor from a previous listRealtimeConnections call."
+        }
+      }
+    }
+  }),
+  getRealtimeConnectionDetails: defineAgentToolContract({
+    name: "getRealtimeConnectionDetails",
+    description: "Return details for a captured WebSocket or SSE connection, including recent messages.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        requestId: {
+          type: "string",
+          description: "Captured realtime request ID to inspect."
+        }
+      },
+      required: ["requestId"]
+    }
+  })
+};
+const networkActivityTools = defineAgentToolDescriptors(
+  NETWORK_ACTIVITY_AGENT_PLUGIN_ID,
+  networkActivityToolDefinitions
+);
+export {
+  NETWORK_ACTIVITY_AGENT_PLUGIN_ID,
+  networkActivityToolDefinitions,
+  networkActivityTools
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rozenite/network-activity-plugin",
-  "version": "1.7.0",
+  "version": "1.8.1",
   "description": "Network Activity for Rozenite.",
   "type": "module",
   "main": "./dist/react-native/index.cjs",
@@ -16,8 +16,9 @@
   },
   "dependencies": {
     "nanoevents": "^9.1.0",
-    "@rozenite/agent-bridge": "1.7.0",
-    "@rozenite/plugin-bridge": "1.7.0"
+    "@rozenite/agent-shared": "1.8.1",
+    "@rozenite/agent-bridge": "1.8.1",
+    "@rozenite/plugin-bridge": "1.8.1"
   },
   "devDependencies": {
     "@floating-ui/react": "^0.26.0",
@@ -48,13 +49,17 @@
     "typescript": "~5.9.3",
     "vite": "^7.3.1",
     "zustand": "^5.0.6",
-    "@rozenite/vite-plugin": "1.7.0",
-    "rozenite": "1.7.0"
+    "@rozenite/vite-plugin": "1.8.1",
+    "rozenite": "1.8.1"
   },
   "peerDependencies": {
+    "react-native-nitro-fetch": "*",
     "react-native-sse": "*"
   },
   "peerDependenciesMeta": {
+    "react-native-nitro-fetch": {
+      "optional": true
+    },
     "react-native-sse": {
       "optional": true
     }
@@ -66,7 +71,13 @@
       "import": "./dist/react-native/index.js",
       "require": "./dist/react-native/index.cjs"
     },
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./sdk": {
+      "development": "./sdk.ts",
+      "types": "./dist/sdk/index.d.ts",
+      "import": "./dist/sdk/index.js",
+      "require": "./dist/sdk/index.cjs"
+    }
   },
   "publishConfig": {
     "access": "public"

package/sdk.ts

@@ -0,0 +1,59 @@
+import { defineAgentToolDescriptors } from '@rozenite/agent-shared';
+import {
+  NETWORK_ACTIVITY_AGENT_PLUGIN_ID,
+  networkActivityToolDefinitions,
+} from './src/shared/agent-tools.js';
+
+export {
+  NETWORK_ACTIVITY_AGENT_PLUGIN_ID,
+  networkActivityToolDefinitions,
+};
+
+export const networkActivityTools = defineAgentToolDescriptors(
+  NETWORK_ACTIVITY_AGENT_PLUGIN_ID,
+  networkActivityToolDefinitions,
+);
+
+export type {
+  NetworkActivityGetRealtimeConnectionDetailsArgs,
+  NetworkActivityGetRealtimeConnectionDetailsResult,
+  NetworkActivityGetRecordingStatusArgs,
+  NetworkActivityGetRecordingStatusResult,
+  NetworkActivityGetRequestBodyArgs,
+  NetworkActivityGetRequestBodyResult,
+  NetworkActivityGetRequestDetailsArgs,
+  NetworkActivityGetRequestDetailsResult,
+  NetworkActivityGetResponseBodyArgs,
+  NetworkActivityGetResponseBodyResult,
+  NetworkActivityListRealtimeConnectionsArgs,
+  NetworkActivityListRealtimeConnectionsResult,
+  NetworkActivityListRequestsArgs,
+  NetworkActivityListRequestsResult,
+  NetworkActivityPaginationArgs,
+  NetworkActivityRequestIdArgs,
+  NetworkActivityStartRecordingArgs,
+  NetworkActivityStartRecordingResult,
+  NetworkActivityStopRecordingArgs,
+  NetworkActivityStopRecordingResult,
+} from './src/shared/agent-tools.js';
+
+export type {
+  NetworkActivityAgentBodyResult,
+  NetworkActivityAgentState,
+} from './src/react-native/agent/state.js';
+
+export type {
+  Cookie,
+  HttpHeaders,
+  HttpMethod,
+  Initiator,
+  Request,
+  RequestBinaryPostData,
+  RequestFormDataPostData,
+  RequestId,
+  RequestOverride,
+  RequestPostData,
+  RequestTextPostData,
+  ResourceType,
+  Response,
+} from './src/shared/http-events.js';

package/src/react-native/__tests__/events-listener.test.ts

@@ -0,0 +1,35 @@
+import { describe, expect, it, vi } from 'vitest';
+import { createEventsListener } from '../events-listener';
+
+type EventMap = {
+  'request-sent': { id: string };
+  'websocket-open': { id: string };
+};
+
+describe('events listener', () => {
+  it('filters queued messages when connecting', () => {
+    const listener = createEventsListener<EventMap>();
+    const send = vi.fn();
+
+    listener.enableQueuing();
+    listener.send('request-sent', { id: 'http-1' });
+    listener.send('websocket-open', { id: 'ws-1' });
+
+    listener.connect(send, (message) => message.type === 'websocket-open');
+
+    expect(send).toHaveBeenCalledTimes(1);
+    expect(send).toHaveBeenCalledWith('websocket-open', { id: 'ws-1' });
+  });
+
+  it('keeps applying the filter to live messages after connecting', () => {
+    const listener = createEventsListener<EventMap>();
+    const send = vi.fn();
+
+    listener.connect(send, (message) => message.type === 'websocket-open');
+    listener.send('request-sent', { id: 'http-1' });
+    listener.send('websocket-open', { id: 'ws-1' });
+
+    expect(send).toHaveBeenCalledTimes(1);
+    expect(send).toHaveBeenCalledWith('websocket-open', { id: 'ws-1' });
+  });
+});

package/src/react-native/agent/__tests__/network-activity-agent-state.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, it } from 'vitest';
 import { createNetworkActivityAgentState } from '../state';
-import { NETWORK_ACTIVITY_AGENT_TOOLS } from '../tools';
+import { networkActivityToolDefinitions } from '../../../shared/agent-tools';
 import type { Request } from '../../../shared/client';
 
 const createRequest = (overrides?: Partial<Request>): Request => ({
@@ -18,7 +18,9 @@ const createRequest = (overrides?: Partial<Request>): Request => ({
 
 describe('network activity agent state', () => {
   it('exposes the expected fallback and realtime tool names', () => {
-    expect(NETWORK_ACTIVITY_AGENT_TOOLS.map((tool) => tool.name)).toEqual([
+    expect(
+      Object.values(networkActivityToolDefinitions).map((tool) => tool.name),
+    ).toEqual([
       'startRecording',
       'stopRecording',
       'getRecordingStatus',
@@ -29,6 +31,9 @@ describe('network activity agent state', () => {
       'listRealtimeConnections',
       'getRealtimeConnectionDetails',
     ]);
+    expect(
+      networkActivityToolDefinitions.getRequestDetails.inputSchema.required,
+    ).toEqual(['requestId']);
   });
 
   it('tracks HTTP requests with parity-oriented list/detail/body results', () => {
@@ -40,7 +45,12 @@ describe('network activity agent state', () => {
       timestamp: 100,
       request: createRequest(),
       type: 'XHR',
-      initiator: { type: 'script', url: 'App.tsx', lineNumber: 12, columnNumber: 4 },
+      initiator: {
+        type: 'script',
+        url: 'App.tsx',
+        lineNumber: 12,
+        columnNumber: 4,
+      },
     });
     state.onResponseReceived({
       requestId: 'req-1',
@@ -126,7 +136,7 @@ describe('network activity agent state', () => {
     state.onWebSocketConnect({
       type: 'websocket-connect',
       url: 'wss://example.com/socket',
-      socketId: 7,
+      socketId: '7',
       timestamp: 100,
       protocols: ['chat'],
       options: [],
@@ -134,13 +144,13 @@ describe('network activity agent state', () => {
     state.onWebSocketOpen({
       type: 'websocket-open',
       url: 'wss://example.com/socket',
-      socketId: 7,
+      socketId: '7',
       timestamp: 110,
     });
     state.onWebSocketMessageSent({
       type: 'websocket-message-sent',
       url: 'wss://example.com/socket',
-      socketId: 7,
+      socketId: '7',
       timestamp: 120,
       data: 'ping',
       messageType: 'text',
@@ -148,7 +158,7 @@ describe('network activity agent state', () => {
     state.onWebSocketMessageReceived({
       type: 'websocket-message-received',
       url: 'wss://example.com/socket',
-      socketId: 7,
+      socketId: '7',
       timestamp: 121,
       data: 'pong',
       messageType: 'text',
@@ -244,7 +254,9 @@ describe('network activity agent state', () => {
     state.startRecording();
 
     expect(() =>
-      state.listRequests({ limit: 1, cursor: firstPage.page.nextCursor })
-    ).toThrow('Cursor does not match the requested listing. Run the command again.');
+      state.listRequests({ limit: 1, cursor: firstPage.page.nextCursor }),
+    ).toThrow(
+      'Cursor does not match the requested listing. Run the command again.',
+    );
   });
 });

package/src/react-native/agent/state.ts

@@ -47,7 +47,7 @@ type WebSocketAgentRecord = {
   requestId: string;
   kind: 'websocket';
   url: string;
-  socketId: number;
+  socketId: string;
   status: 'connecting' | 'open' | 'closing' | 'closed' | 'error';
   startedAt: number;
   endedAt?: number;
@@ -174,7 +174,7 @@ const decodeCursor = (cursor: string, scope: string): number => {
   const [cursorScope, rawIndex] = cursor.split(':', 2);
   if (cursorScope !== scope || !rawIndex) {
     throw new Error(
-      'Cursor does not match the requested listing. Run the command again.'
+      'Cursor does not match the requested listing. Run the command again.',
     );
   }
 
@@ -190,7 +190,7 @@ const paginate = <T>(
   rows: T[],
   scope: string,
   limit: number,
-  cursor?: string
+  cursor?: string,
 ): Page<T> => {
   const startIndex = cursor ? decodeCursor(cursor, scope) : 0;
   const endIndex = Math.min(startIndex + limit, rows.length);
@@ -208,7 +208,7 @@ const paginate = <T>(
 
 const serializeRequestBody = (
   requestId: string,
-  postData?: RequestPostData
+  postData?: RequestPostData,
 ): NetworkActivityAgentBodyResult => {
   if (!postData) {
     return {
@@ -287,7 +287,7 @@ const getRealtimeSummary = (record: RealtimeAgentRecord) => {
 const trimMap = <T>(
   order: string[],
   records: Map<string, T>,
-  capacity: number
+  capacity: number,
 ): number => {
   let evicted = 0;
   while (order.length > capacity) {
@@ -330,7 +330,7 @@ export const createNetworkActivityAgentState = () => {
 
   const ensureHttpRecord = (
     requestId: string,
-    fallback?: Partial<HttpAgentRecord>
+    fallback?: Partial<HttpAgentRecord>,
   ): HttpAgentRecord => {
     const existing = state.httpRecords.get(requestId);
     if (existing) {
@@ -357,7 +357,7 @@ export const createNetworkActivityAgentState = () => {
     const evicted = trimMap(
       state.httpOrder,
       state.httpRecords,
-      HTTP_BUFFER_CAPACITY
+      HTTP_BUFFER_CAPACITY,
     );
     if (evicted > 0) {
       state.httpEvictedCount += evicted;
@@ -368,7 +368,7 @@ export const createNetworkActivityAgentState = () => {
 
   const ensureRealtimeRecord = (
     requestId: string,
-    createRecord: () => RealtimeAgentRecord
+    createRecord: () => RealtimeAgentRecord,
   ): RealtimeAgentRecord => {
     const existing = state.realtimeRecords.get(requestId);
     if (existing) {
@@ -382,7 +382,7 @@ export const createNetworkActivityAgentState = () => {
     const evicted = trimMap(
       state.realtimeOrder,
       state.realtimeRecords,
-      REALTIME_BUFFER_CAPACITY
+      REALTIME_BUFFER_CAPACITY,
     );
     if (evicted > 0) {
       state.realtimeEvictedCount += evicted;
@@ -706,12 +706,12 @@ export const createNetworkActivityAgentState = () => {
         timestamp: event.timestamp,
       };
       record.messages = [...record.messages, message].slice(
-        -MAX_WEBSOCKET_MESSAGES_PER_CONNECTION
+        -MAX_WEBSOCKET_MESSAGES_PER_CONNECTION,
       );
     },
 
     onWebSocketMessageReceived(
-      event: WebSocketEventMap['websocket-message-received']
+      event: WebSocketEventMap['websocket-message-received'],
     ) {
       if (!state.isRecording) {
         return;
@@ -734,7 +734,7 @@ export const createNetworkActivityAgentState = () => {
         timestamp: event.timestamp,
       };
       record.messages = [...record.messages, message].slice(
-        -MAX_WEBSOCKET_MESSAGES_PER_CONNECTION
+        -MAX_WEBSOCKET_MESSAGES_PER_CONNECTION,
       );
     },
 
@@ -757,7 +757,7 @@ export const createNetworkActivityAgentState = () => {
     },
 
     onWebSocketConnectionStatusChanged(
-      event: WebSocketEventMap['websocket-connection-status-changed']
+      event: WebSocketEventMap['websocket-connection-status-changed'],
     ) {
       if (!state.isRecording) {
         return;

package/src/react-native/agent/tools.ts

@@ -1,146 +1,20 @@
-import type { AgentTool } from '@rozenite/agent-bridge';
-
-export const startRecordingTool: AgentTool = {
-  name: 'startRecording',
-  description:
-    'Start recording network activity in the fallback network activity plugin.',
-  inputSchema: {
-    type: 'object',
-    properties: {},
-  },
-};
-
-export const stopRecordingTool: AgentTool = {
-  name: 'stopRecording',
-  description:
-    'Stop recording network activity without clearing the captured plugin buffer.',
-  inputSchema: {
-    type: 'object',
-    properties: {},
-  },
-};
-
-export const getRecordingStatusTool: AgentTool = {
-  name: 'getRecordingStatus',
-  description:
-    'Return network activity plugin recording state and buffer metadata.',
-  inputSchema: {
-    type: 'object',
-    properties: {},
-  },
-};
-
-export const listRequestsTool: AgentTool = {
-  name: 'listRequests',
-  description:
-    'List captured HTTP request summaries with cursor pagination from the fallback plugin.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      limit: {
-        type: 'number',
-        description: 'Maximum number of requests to return. Defaults to 20.',
-      },
-      cursor: {
-        type: 'string',
-        description: 'Opaque pagination cursor from a previous listRequests call.',
-      },
-    },
-  },
-};
-
-export const getRequestDetailsTool: AgentTool = {
-  name: 'getRequestDetails',
-  description:
-    'Return detailed metadata for a captured HTTP request without fetching response body.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      requestId: {
-        type: 'string',
-        description: 'Captured plugin request ID to inspect.',
-      },
-    },
-    required: ['requestId'],
-  },
-};
-
-export const getRequestBodyTool: AgentTool = {
-  name: 'getRequestBody',
-  description:
-    'Return the captured request body for a plugin-recorded HTTP request when available.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      requestId: {
-        type: 'string',
-        description: 'Captured plugin request ID to inspect.',
-      },
-    },
-    required: ['requestId'],
-  },
-};
-
-export const getResponseBodyTool: AgentTool = {
-  name: 'getResponseBody',
-  description:
-    'Return the captured response body for a plugin-recorded HTTP request when available.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      requestId: {
-        type: 'string',
-        description: 'Captured plugin request ID to inspect.',
-      },
-    },
-    required: ['requestId'],
-  },
-};
-
-export const listRealtimeConnectionsTool: AgentTool = {
-  name: 'listRealtimeConnections',
-  description:
-    'List captured WebSocket and SSE connections with cursor pagination.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      limit: {
-        type: 'number',
-        description: 'Maximum number of realtime connections to return. Defaults to 20.',
-      },
-      cursor: {
-        type: 'string',
-        description:
-          'Opaque pagination cursor from a previous listRealtimeConnections call.',
-      },
-    },
-  },
-};
-
-export const getRealtimeConnectionDetailsTool: AgentTool = {
-  name: 'getRealtimeConnectionDetails',
-  description:
-    'Return details for a captured WebSocket or SSE connection, including recent messages.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      requestId: {
-        type: 'string',
-        description: 'Captured realtime request ID to inspect.',
-      },
-    },
-    required: ['requestId'],
-  },
-};
-
-export const NETWORK_ACTIVITY_AGENT_TOOLS: AgentTool[] = [
-  startRecordingTool,
-  stopRecordingTool,
-  getRecordingStatusTool,
-  listRequestsTool,
-  getRequestDetailsTool,
-  getRequestBodyTool,
-  getResponseBodyTool,
-  listRealtimeConnectionsTool,
-  getRealtimeConnectionDetailsTool,
-];
+import { networkActivityToolDefinitions } from '../../shared/agent-tools';
+
+export const startRecordingTool = networkActivityToolDefinitions.startRecording;
+export const stopRecordingTool = networkActivityToolDefinitions.stopRecording;
+export const getRecordingStatusTool =
+  networkActivityToolDefinitions.getRecordingStatus;
+export const listRequestsTool = networkActivityToolDefinitions.listRequests;
+export const getRequestDetailsTool =
+  networkActivityToolDefinitions.getRequestDetails;
+export const getRequestBodyTool = networkActivityToolDefinitions.getRequestBody;
+export const getResponseBodyTool =
+  networkActivityToolDefinitions.getResponseBody;
+export const listRealtimeConnectionsTool =
+  networkActivityToolDefinitions.listRealtimeConnections;
+export const getRealtimeConnectionDetailsTool =
+  networkActivityToolDefinitions.getRealtimeConnectionDetails;
+
+export const NETWORK_ACTIVITY_AGENT_TOOLS = Object.values(
+  networkActivityToolDefinitions,
+);