12345const result = buildPrompt('Review this', longFile, 'claude');

result.truncated;    // true
result.droppedChars; // 36114
result.autoSubmit;   // false — Claude fills the composer, user presses Enter

12345<AskAI
  goal="Explain this function"
  content={code}
  services={['chatgpt', 'claude', 'perplexity']}
/>

123<AskAILink service="claude" goal="Review this" content={code}>
  Ask Claude
</AskAILink>

12345678import { createRegistry } from '@raptrx/askai';

const registry = createRegistry();
registry.add('acme', {
  name: 'Acme AI',
  url: 'https://ai.acme.internal/chat',
  param: 'prompt',
});

123import { logos } from '@raptrx/askai/logos';

<AskAI icons={logos} goal="Explain this" content={code} />

1npx @raptrx/askai init

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122npx @raptrx/askai list` rather than guessed, which is
 * the same rule the package gives agents.
 */
export const ASKAI_AGENT_PROMPT = `# askai — integration instructions for a coding agent

Add an "Ask AI" control to this project using @raptrx/askai. Follow these rules
exactly. Several are counter-intuitive, and getting them wrong produces a button
that opens an empty chat — which looks like the product is broken.

## 1. Install

    npm i @raptrx/askai

Prefer the package: one dependency, and updates arrive when vendors change their
parameters. Only run `npx @raptrx/askai init` (shadcn-style codegen) if this
project vendors its UI or cannot take a dependency — it is interactive and needs
a TTY. If you cannot drive a TTY, install the package rather than hand-writing
the files.

## 2. Minimum correct integration

    import { AskAI } from '@raptrx/askai/react';
    import '@raptrx/askai/styles.css';   // once, anywhere — do not skip this

    <AskAI goal="Explain this code" content={code} />

`content` is the entire point: pass the actual code, error, article or record
the user is looking at, never a static string. Objects are serialised to fenced
JSON automatically; `{ text, language }` forces a code fence.

## 3. Pick the right surface

    <AskAI>        user picks the destination — split button, copy + menu
    <AskAILink>    one fixed destination; a real <a>, so it works in a server
                   component and supports middle-click and Cmd-click
    useAskAI()     the same behaviour with your own markup
    buildPrompt()  no React at all; returns { url, truncated, droppedChars,
                   autoSubmit }

## 4. Rules that make or break the integration

- NEVER promise one-click. Label it "Ask AI" or "Open in ChatGPT" — never "Run
  in ChatGPT" or "Get an answer". Most destinations only fill the composer and
  wait for the user to press Enter. `result.autoSubmit` tells you which ones
  actually run; the built-in menu already labels this correctly.

- NEVER add `gemini` or Microsoft `copilot`. Gemini has never supported URL
  prefill — it takes the prompt from an HTTP header the browser sets from its
  own address bar, and a hyperlink cannot set headers. Microsoft Copilot's
  prefill was removed in 2025. Both are kept in the registry only so they throw
  a clear error instead of opening an empty tab. For a Google model use
  `aistudio`. Note GitHub Copilot is a different product and IS supported.

- NEVER hand-write the URLs. `chatgpt.com/?q=` looks correct and is the
  fragile path; `?prompt=` is the stable one. The registry exists precisely so
  nobody has to remember this.

- Destinations cap between roughly 5,000 and 16,000 characters. Do not pass huge
  content and assume it arrives. For anything long, let the user copy instead —
  that is what the primary button is for. Check `buildPrompt(...).truncated`
  if you need to know programmatically.

- Logos are opt-in, not default:
      import { logos } from '@raptrx/askai/logos';
      <AskAI icons={logos} ... />
  Never hand-draw a mark to fill a gap. Destinations without a real logo use a
  monogram on purpose; an approximated mark is visibly wrong and is the thing
  vendors most clearly prohibit.

## 5. Service ids

Confirmed ids: chatgpt, claude, perplexity, grok, deepseek, mistral (Le Chat),
kagi (Kagi Assistant), t3chat, aistudio (Google AI Studio).

Do not invent ids. Run `npx @raptrx/askai list` for the authoritative set —
it prints every destination with its parameter, cap, tier, and whether it runs
the prompt or only fills the composer.

## 6. Styling

Retheme with CSS custom properties, no rule overrides needed:

    .askai {
      --askai-bg: var(--my-surface);
      --askai-fg: var(--my-text);
      --askai-border: var(--my-border);
      --askai-focus: var(--my-ring);
      --askai-radius: 4px;
      --askai-duration: 100ms;
    }

Past that: per-part `classNames` (merged after the built-ins, so yours win),
`unstyled` (no askai-* class is emitted and the stylesheet becomes
unnecessary — the ARIA and keyboard behaviour stay), or `useAskAI` to render
it yourself.

## 7. Server and multi-tenant

Use `createRegistry()` rather than the global `addService()` anywhere
requests share a process. The global registry is process-wide, so one tenant's
destination would leak into another's request.

    import { createRegistry } from '@raptrx/askai';

    const registry = createRegistry();
    registry.add('acme', {
      name: 'Acme AI',
      url: 'https://ai.acme.internal/chat',
      param: 'prompt',
    });

## 8. Verify before you call it done

    npx @raptrx/askai list

Then click the control and confirm the prompt actually lands in the
destination's composer. If it opens empty, the parameter changed — open an
issue at https://github.com/aliarain/askai rather than patching around it, so
the fix reaches everyone.

Docs: https://docs.aliarain.com/askai
Source: https://github.com/aliarain/askai