@cloro-dev/response-parser

A powerful TypeScript library for parsing AI model responses from ChatGPT, Gemini, Perplexity, Copilot, Grok, and Google AI Overview/Mode.

Framework-Agnostic: This library returns HTML strings that can be rendered in any framework (React, Vue, Svelte, vanilla JS, etc.).

Features

• 🤖 Multi-Provider Support: ChatGPT, Gemini, Perplexity, Copilot, AI Overview, AI Mode, Grok
• 🔍 Auto-Detection: Automatically detects the AI provider from response structure
• 🎨 Built-in Styling: Provider-specific styling
• 🔧 Framework-Agnostic: Pure HTML output for any framework
• 🔒 Secure: Automatic script sanitization
• 📦 TypeScript: Full TypeScript support with comprehensive types
• 🎯 Lightweight: No runtime dependencies for core parsing

Installation

npm install @cloro-dev/response-parser
# or
yarn add @cloro-dev/response-parser
# or
pnpm add @cloro-dev/response-parser

Quick Start

This library parses AI responses and returns sanitized HTML strings. You can render the HTML in any framework:

import { parseAiResponse, detectProvider } from "@cloro-dev/response-parser";

// Auto-detect provider and parse
const response = await fetchAIResponse();
const parsed = parseAiResponse(response);

console.log(parsed.provider); // 'CHATGPT' | 'GEMINI' | etc.
console.log(parsed.html); // Sanitized HTML ready for rendering
console.log(parsed.text); // Plain text version

Usage Examples

React

import { parseAiResponse } from "@cloro-dev/response-parser";

function MyComponent() {
  const parsed = parseAiResponse(aiResponse, {
    removeLinks: true
  });

  return (
    <div dangerouslySetInnerHTML={{ __html: parsed.html }} />
  );
}

Vue

<script setup>
import { parseAiResponse } from "@cloro-dev/response-parser";

const parsed = parseAiResponse(aiResponse, {
  removeLinks: true
});
</script>

<template>
  <div v-html="parsed.html"></div>
</template>

Svelte

<script>
import { parseAiResponse } from "@cloro-dev/response-parser";

const parsed = parseAiResponse(aiResponse, {
  removeLinks: true
});
</script>

<div>{@html parsed.html}</div>

Vanilla JavaScript

import { parseAiResponse } from "@cloro-dev/response-parser";

const parsed = parseAiResponse(aiResponse, {
  removeLinks: true
});

document.getElementById('output').innerHTML = parsed.html;

API Reference

parseAiResponse(response, options?)

Parse an AI response with auto-detected provider.

Options:

• removeLinks: boolean - Remove all hyperlinks from HTML (default: false)
• removeHeader: boolean - Remove navigation bar/header (default: false; true for AI Overview & AI Mode. ChatGPT, Perplexity, Gemini, Copilot, Grok, AI Overview & AI Mode)
• removeFooter: boolean - Remove follow-up input box/footer (default: false; true for AI Overview & AI Mode. ChatGPT, Perplexity, Gemini, Copilot, Grok, AI Overview & AI Mode)
• removeSidebar: boolean - Remove sidebar (default: false, ChatGPT, Gemini, Perplexity, Copilot & AI Mode)
• removeSources: boolean - Remove sources/references panel (default: false, ChatGPT, Gemini, Perplexity, Copilot & Grok)

Note: Cookie/privacy banners are automatically removed for ChatGPT, AI Mode, Copilot, Grok, and Perplexity — no option needed. Sign-in prompts are automatically removed for Gemini and Perplexity.

Returns: ParsedResponse | null

interface ParsedResponse {
  provider: AIProvider;
  html: string;
  text: string;
  sources?: Array<{
    title: string;
    url: string;
    snippet?: string;
  }>;
}

detectProvider(response)

Detect the AI provider from a response.

Returns: AIProvider | null

type AIProvider =
  | 'CHATGPT'
  | 'GEMINI'
  | 'PERPLEXITY'
  | 'COPILOT'
  | 'AIOVERVIEW'
  | 'AIMODE'
  | 'GROK';

Supported Providers

| Provider | Status | Features | | ----------- | ------ | ----------------------------------------------------------- | | ChatGPT | ✅ | Sidebar, header, footer removal, auto cookie banner hiding | | Gemini | ✅ | Sidebar, header, footer, sources removal | | Perplexity | ✅ | Sidebar, header, footer, sources removal, auto cookie banner hiding | | Copilot | ✅ | Sidebar, header, footer, sources removal, auto cookie banner hiding | | AI Overview | ✅ | Header, footer removal, WIZ data extraction | | AI Mode | ✅ | Sidebar, header, footer removal, auto cookie banner hiding | | Grok | ✅ | Sources removal, auto cookie banner hiding |

Common Use Cases

Remove Hyperlinks

import { parseAiResponse } from "@cloro-dev/response-parser";

const parsed = parseAiResponse(response, {
  removeLinks: true, // Removes all <a> tags, keeps text
});

Clean View (Remove UI Elements)

const parsed = parseAiResponse(response, {
  removeHeader: true,  // Remove top navigation bar
  removeFooter: true,  // Remove follow-up input box
  removeLinks: true,   // Remove all hyperlinks
  removeSources: true, // Remove sources/references panel
});

Manual Provider Specification

import { parseAiResponse, AIProvider } from "@cloro-dev/response-parser";

const parsed = parseAiResponse(response, {
  provider: "CHATGPT",
});

Provider Detection Only

import { detectProvider } from "@cloro-dev/response-parser";

const provider = detectProvider(response);
console.log(`Detected: ${provider}`); // 'CHATGPT' | 'GEMINI' | etc.

Migration from v0.1.x

If you were using React components from v0.1.x, here's how to migrate:

Before (v0.1.x with React)

import { ResponseRenderer } from "@cloro-dev/response-parser/react";

<ResponseRenderer
  response={response}
  removeLinks={true}
  onProviderDetected={(provider) => console.log("Detected:", provider)}
/>

After (v0.2.0 framework-agnostic)

import { parseAiResponse } from "@cloro-dev/response-parser";

const parsed = parseAiResponse(response, {
  removeLinks: true
});

console.log("Detected:", parsed.provider);

<div dangerouslySetInnerHTML={{ __html: parsed.html }} />

The core parsing logic is identical - you just need to handle the HTML rendering yourself in your framework of choice.

What's Changed

Unreleased

• ✅ Fixed require("@cloro-dev/response-parser") failed with exports is not defined. The CommonJS build is now dist/index.cjs
• ✅ Fixed Perplexity removeSources now hides the open "Sources" popover
• ✅ Fixed Perplexity cookie banner (new markup) and sign-in prompts are now always hidden
• ✅ Fixed Copilot removeHeader and removeSidebar no longer break the page layout. removeSidebar no longer hides the references panel
• ✅ Fixed Copilot removeHeader now hides the date divider
• ✅ Fixed ChatGPT removeSources now hides the sources flyout and the sources sheet on all pages
• ✅ Fixed ChatGPT removeFooter and removeSidebar no longer change the page structure
• ✅ Fixed Gemini sign-in prompt is now always hidden
• ✅ Fixed AI Overview removeFooter now hides the Google footer
• ✅ Fixed Provider detection no longer depends on pattern order for Gemini pages, and no longer reports a Google result page that links to Gemini as Gemini

v0.4.3

• ✅ Added Perplexity removeSidebar support (left navigation removal)
• ✅ Fixed Perplexity layout rendering in iframes (CSS overrides for single-column flow)
• ✅ Fixed Perplexity removeFooter now hides the "Ask a follow-up" bar via CSS
• ✅ Fixed ChatGPT removeFooter now hides the composer input form and collapses blank space
• ✅ Fixed ChatGPT removeSidebar now hides leftover sidebar items via CSS
• ✅ Fixed AI Mode removeHeader now hides the "New thread" compose button
• ✅ Fixed Copilot removeHeader now hides the sticky header (share button)
• ✅ Improved CSS overrides are now conditional — only injected when the corresponding remove* option is true (Perplexity, ChatGPT, Copilot)

v0.4.2

• ✅ Added ChatGPT automatic cookie banner removal
• ✅ Fixed Copilot sources removal regex to handle variable panel widths

v0.4.1

• ✅ Added Copilot removeSources and removeSidebar support
• ✅ Added Copilot automatic cookie banner removal
• ✅ Added AI Mode removeSidebar support (history panel removal)
• ✅ Fixed AI Mode sidebar/footer removal and detection
• ✅ Added AI Mode automatic cookie consent banner hiding

v0.4.0

• ✅ Added removeSources option for Gemini, Perplexity, and Grok
• ✅ Added automatic cookie/privacy banner removal for Perplexity and Grok
• ✅ Fixed Perplexity collapsed answer container (JS animation height workaround)

v0.3.0

• ✅ Added Grok provider support
• ✅ Simplified codebase and removed colour inversion

v0.2.0

• ✅ Removed React components and hooks (now framework-agnostic)
• ✅ Removed React peer dependency
• ✅ Simplified API to return pure HTML strings
• ✅ Keep core parsing logic (unchanged)

v0.1.4

• ✅ Renamed removeNavbar → removeHeader (removes navigation bar/header)
• ✅ Renamed removeFollowup → removeFooter (removes follow-up input box/footer)
• ✅ Extended removeHeader support to AI Overview and AI Mode
• ✅ Extended removeFooter support to all providers (ChatGPT, Perplexity, Gemini, Copilot, AI Overview, AI Mode)
• ✅ Improved ChatGPT styling
• ✅ Updated AI Mode and AI Overview parsers

v0.1.3

• ✅ Always sanitizes HTML by default (removes scripts for security)
• ✅ Always includes provider-specific styles
• ✅ Always uses provider's base URL for relative links
• ❌ Removed theme option (styles are provider-specific)
• ❌ Removed sanitize option (always enabled)
• ❌ Removed includeStyles option (always enabled)
• ❌ Removed baseUrl option (uses provider default)

Development

# Install dependencies
pnpm install

# Build
pnpm build

# Development mode
pnpm dev

# Type check
pnpm type-check

# Lint
pnpm lint

Release

1. Log in to npm with an account that can publish to @cloro-dev:

   npm login

2. Run the checks and the build:

   pnpm type-check && pnpm lint && pnpm build

3. Increase the version. This changes package.json and creates a git commit and tag:

   npm version patch   # 0.4.5 → 0.4.6
   npm version minor   # 0.4.5 → 0.5.0
   npm version major   # 0.4.5 → 1.0.0

4. Publish. prepublishOnly builds the package again before the upload:

   npm publish

5. Push the commit and the tag, and add an entry under "What's Changed":

   git push --follow-tags

License

MIT © cloro