RAD Security

Instructions

Implementation Reference

• src/operations/inbox.ts:53-79 (handler)

  The main handler function that fetches inbox item details from the API, removes unnecessary fields, fetches and attaches comments, and returns the enriched details.

  export async function getInboxItemDetails(
    client: RadSecurityClient,
    inboxItemId: string
  ): Promise<any> {
    var details = await client.makeRequest(
      `/accounts/${client.getAccountId()}/data/inbox_items/${inboxItemId}`
    );
  
    // Remove fields to reduce context window size when used with LLMs data.fields
    delete details.fields;
  
    // fetch all comments for the inbox item
    const comments_params: Record<string, any> = {
      "filters_query": `inbox_item_id:"${inboxItemId}"`
    };
  
    var comments = await client.makeRequest(
      `/accounts/${client.getAccountId()}/data/inbox_item_comments`,
      comments_params
    );
    delete comments.fields;
  
    // add comments to the details
    details.comments = comments;
  
    return details;
  }

• src/operations/inbox.ts:16-18 (schema)

  Zod schema defining the input parameters for the tool: inbox_item_id (string).

  export const GetInboxItemDetailsSchema = z.object({
    inbox_item_id: z.string().describe("ID of the inbox item to get details for"),
  });

• src/index.ts:496-501 (registration)

  Tool registration in the ListTools handler: defines name, description, and input schema using the imported schema.

  {
    name: "get_inbox_item_details",
    description:
      "Get detailed information about a specific inbox item",
    inputSchema: zodToJsonSchema(inbox.GetInboxItemDetailsSchema),
  },

• src/index.ts:1371-1384 (registration)

  Tool execution handler in the CallToolRequest switch case: parses args with schema, calls the handler function, and returns JSON response.

  case "get_inbox_item_details": {
    const args = inbox.GetInboxItemDetailsSchema.parse(
      request.params.arguments
    );
    const response = await inbox.getInboxItemDetails(
      client,
      args.inbox_item_id
    );
    return {
      content: [
        { type: "text", text: JSON.stringify(response, null, 2) },
      ],
    };
  }