mirror of
https://github.com/hanzoai/chat.git
synced 2026-09-30 20:51:17 +00:00
zeekay
12b6f6ece2
- env vars LIBRECHAT_* -> CHAT_* (USER_ID, GRAPH_ACCESS_TOKEN, OPENID_*, LOG_DIR, ...) - config file librechat.yaml -> chat.yaml (matches prod CONFIG_PATH) + .example - identifiers LibreChat -> Chat (extractChatParams, ChatKeys, ChatParams, importChatConvo) - lowercase librechat -> chat: i18n keys, helm charts (helm/chat, helm/chat-rag-api), CI workflows, OTel service/span keys, codeapi JWT issuer, x-chat-thread-id header - README.md rewritten (Node 24, pnpm 10, Zen family, Cloud Agents, hanzo.id OIDC); README.zh.md added (Simplified Chinese) MIT LICENSE copyright + one 'Forked from LibreChat (MIT)' attribution retained. Build 5/5 green.
111 lines
3.0 KiB
JavaScript
111 lines
3.0 KiB
JavaScript
/**
|
|
* OpenAI-compatible API routes for Chat agents.
|
|
*
|
|
* Provides a /v1/chat/completions compatible interface for
|
|
* interacting with Chat agents remotely via API.
|
|
*
|
|
* Usage:
|
|
* POST /v1/chat/completions - Chat with an agent
|
|
* GET /v1/models - List available agents
|
|
* GET /v1/models/:model - Get agent details
|
|
*
|
|
* Request format:
|
|
* {
|
|
* "model": "agent_id_here",
|
|
* "messages": [{"role": "user", "content": "Hello!"}],
|
|
* "stream": true
|
|
* }
|
|
*/
|
|
const express = require('express');
|
|
const { PermissionTypes, Permissions } = require('@hanzochat/data-provider');
|
|
const {
|
|
generateCheckAccess,
|
|
createRequireApiKeyAuth,
|
|
createCheckRemoteAgentAccess,
|
|
} = require('@hanzochat/api');
|
|
const {
|
|
OpenAIChatCompletionController,
|
|
ListModelsController,
|
|
GetModelController,
|
|
} = require('~/server/controllers/agents/openai');
|
|
const { getEffectivePermissions } = require('~/server/services/PermissionService');
|
|
const { validateAgentApiKey, findUser } = require('~/models');
|
|
const { configMiddleware } = require('~/server/middleware');
|
|
const { getRoleByName } = require('~/models/Role');
|
|
const { getAgent } = require('~/models/Agent');
|
|
|
|
const router = express.Router();
|
|
|
|
const requireApiKeyAuth = createRequireApiKeyAuth({
|
|
validateAgentApiKey,
|
|
findUser,
|
|
});
|
|
|
|
const checkRemoteAgentsFeature = generateCheckAccess({
|
|
permissionType: PermissionTypes.REMOTE_AGENTS,
|
|
permissions: [Permissions.USE],
|
|
getRoleByName,
|
|
});
|
|
|
|
const checkAgentPermission = createCheckRemoteAgentAccess({
|
|
getAgent,
|
|
getEffectivePermissions,
|
|
});
|
|
|
|
router.use(requireApiKeyAuth);
|
|
router.use(configMiddleware);
|
|
router.use(checkRemoteAgentsFeature);
|
|
|
|
/**
|
|
* @route POST /v1/chat/completions
|
|
* @desc OpenAI-compatible chat completions with agents
|
|
* @access Private (API key auth required)
|
|
*
|
|
* Request body:
|
|
* {
|
|
* "model": "agent_id", // Required: The agent ID to use
|
|
* "messages": [...], // Required: Array of chat messages
|
|
* "stream": true, // Optional: Whether to stream (default: false)
|
|
* "conversation_id": "...", // Optional: Conversation ID for context
|
|
* "parent_message_id": "..." // Optional: Parent message for threading
|
|
* }
|
|
*
|
|
* Response (streaming):
|
|
* - SSE stream with OpenAI chat.completion.chunk format
|
|
* - Includes delta.reasoning for thinking/reasoning content
|
|
*
|
|
* Response (non-streaming):
|
|
* - Standard OpenAI chat.completion format
|
|
*/
|
|
router.post('/chat/completions', checkAgentPermission, OpenAIChatCompletionController);
|
|
|
|
/**
|
|
* @route GET /v1/models
|
|
* @desc List available agents as models
|
|
* @access Private (API key auth required)
|
|
*
|
|
* Response:
|
|
* {
|
|
* "object": "list",
|
|
* "data": [
|
|
* {
|
|
* "id": "agent_id",
|
|
* "object": "model",
|
|
* "name": "Agent Name",
|
|
* "provider": "openai",
|
|
* ...
|
|
* }
|
|
* ]
|
|
* }
|
|
*/
|
|
router.get('/models', ListModelsController);
|
|
|
|
/**
|
|
* @route GET /v1/models/:model
|
|
* @desc Get details for a specific agent/model
|
|
* @access Private (API key auth required)
|
|
*/
|
|
router.get('/models/:model', GetModelController);
|
|
|
|
module.exports = router;
|