feat(ai-proxy): add HTTP client for frontend and agent-client usage

[Scra3]

Summary

• Add AiProxyClient class with a clean, UX-friendly API to interact with ai-proxy from frontend or agent-client
• Lightweight client: Import from @forestadmin/ai-proxy/client - zero dependencies

⚠️ Breaking Change

Langchain packages are now optional peer dependencies. Users of the server-side features (Router, ProviderDispatcher) must install them manually:

npm install @langchain/core @langchain/openai @langchain/community @langchain/mcp-adapters

Users who only use the client don't need to install anything extra.

API

// Lightweight import - no dependencies
import { createAiProxyClient } from '@forestadmin/ai-proxy/client';

const client = createAiProxyClient({
  baseUrl: 'https://my-agent.com/forest',
  apiKey: 'sk-...',
});

// Simple - just a message
const response = await client.chat('Hello');

// Advanced - with options
const response = await client.chat({
  messages: [{ role: 'user', content: 'Hello' }],
  tools: [...],
  toolChoice: 'auto',
  aiName: 'gpt-4',
});

// List available tools
const tools = await client.getTools();

// Call a tool
const result = await client.callTool('brave_search', [
  { role: 'user', content: 'cats' }
]);

Package Structure

Import	Use case	Dependencies
@forestadmin/ai-proxy	Server-side routing	Requires langchain (peer)
@forestadmin/ai-proxy/client	Frontend HTTP client	None

Test plan

• All existing tests pass
• New tests for client methods (16 tests)
• Build passes
• Lint passes

🤖 Generated with Claude Code

[qltysh]

2 new issues

Tool	Category	Rule	Count
qlty	Structure	Function with high complexity (count = 26): request	1
qlty	Structure	Function with many parameters (count = 4): constructor	1

[qltysh]

Coverage Impact

This PR will not change total coverage.

🚦 See full report on Qlty Cloud »

🛟 Help

• Diff Coverage: Coverage for added or modified lines of code (excludes deleted files). Learn more.

• Total Coverage: Coverage for the whole repository, calculated as the sum of all File Coverage. Learn more.

• File Coverage: Covered Lines divided by Covered Lines plus Missed Lines. (Excludes non-executable lines including blank lines and comments.)

  • Indirect Changes: Changes to File Coverage for files that were not modified in this PR. Learn more.