@agimon-ai/model-proxy-mcp 0.2.2 → 0.2.4

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agimon-ai/model-proxy-mcp",
   "description": "Claude-compatible model proxy MCP with ChatGPT Codex upstream support",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "license": "AGPL-3.0",
   "keywords": [
     "mcp",
@@ -12,7 +12,7 @@
   "bin": {
     "model-proxy-mcp": "./dist/cli.mjs"
   },
-  "main": "./dist/index.mjs",
+  "main": "./dist/index.cjs",
   "types": "./dist/index.d.mts",
   "module": "./dist/index.mjs",
   "files": [
@@ -41,10 +41,12 @@
   "type": "module",
   "exports": {
     ".": {
-      "import": "./dist/index.mjs"
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
     },
     "./cli": {
-      "import": "./dist/cli.mjs"
+      "import": "./dist/cli.mjs",
+      "require": "./dist/cli.cjs"
     },
     "./package.json": "./package.json"
   },

package/dist/cli.d.mts

@@ -1 +0,0 @@
-export { };

package/dist/index.d.mts

@@ -1,468 +0,0 @@
-import "@hono/node-server";
-import { Hono } from "hono";
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import * as hono_types0 from "hono/types";
-
-//#region src/types/index.d.ts
-interface LoggerLike {
-  info: (msg: string, data?: unknown) => void;
-  error: (msg: string, error?: unknown) => void;
-  debug: (msg: string, data?: unknown) => void;
-  warn: (msg: string, data?: unknown) => void;
-}
-type ReasoningEffort = 'minimal' | 'low' | 'medium' | 'high';
-type ProxyProviderType = 'chatgpt-codex' | 'anthropic-compatible' | 'gemini-direct';
-type GeminiAuthMode = 'auto' | 'api-key' | 'oauth';
-type ModelSlot = 'default' | 'sonnet' | 'opus' | 'haiku' | 'subagent';
-interface ProviderRuntimeConfig {
-  type: ProxyProviderType;
-  endpoint: string;
-  authTokenEnvVar?: string | null;
-  apiTimeoutMs?: number | null;
-  authMode?: GeminiAuthMode | null;
-  apiKeyEnvVar?: string | null;
-  project?: string | null;
-  location?: string | null;
-  apiVersion?: string | null;
-}
-interface ProxyProfile {
-  id: string;
-  label: string;
-  provider: string;
-  providerType: ProxyProviderType | null;
-  model: string;
-  endpoint: string | null;
-  reasoningEffort: ReasoningEffort;
-  enabled: boolean;
-}
-interface ProxyModelConfig {
-  id: string;
-  label: string;
-  provider: string;
-  model: string;
-  reasoningEffort: ReasoningEffort;
-  enabled: boolean;
-}
-interface ScopeModelSelection {
-  provider: string;
-  model: string;
-  reasoningEffort: ReasoningEffort;
-  thinkingDisabled?: boolean;
-}
-interface ScopeSlotConfig {
-  main: ScopeModelSelection;
-  fallbacks: ScopeModelSelection[];
-}
-interface ScopeSettings {
-  models: Partial<Record<ModelSlot, ScopeSlotConfig>>;
-}
-interface ProxySettings {
-  providers: Record<string, ProviderRuntimeConfig>;
-  models: ProxyModelConfig[];
-  scope: ScopeSettings;
-}
-interface ScopeConfig {
-  activeProfileId: string | null;
-  slotProfileIds: Partial<Record<ModelSlot, string | null>>;
-  providers: Record<string, ProviderRuntimeConfig>;
-  profiles: ProxyProfile[];
-  scope: ScopeSettings;
-}
-interface ProxyConfig extends ScopeConfig {}
-interface ResolvedSlotConfig {
-  slot: ModelSlot;
-  profileId: string | null;
-  label: string | null;
-  provider: string | null;
-  providerType: ProxyProviderType | null;
-  endpoint: string | null;
-  model: string | null;
-  reasoningEffort: ReasoningEffort;
-  thinkingDisabled?: boolean;
-  fallbacks: ScopeModelSelection[];
-}
-interface AdminConfig {
-  scope: string;
-  providerConfigPath: string;
-  modelListPath: string;
-  scopeConfigPath: string;
-  providers: Record<string, ProviderRuntimeConfig>;
-  models: ProxyProfile[];
-  scopeModels: ScopeSettings['models'];
-  slots: Record<ModelSlot, ResolvedSlotConfig>;
-}
-interface GatewayStatus {
-  running: boolean;
-  port?: number;
-  pid?: number;
-  scope: string;
-  activeProfileId: string | null;
-  activeModel?: string;
-  activeReasoningEffort?: ReasoningEffort;
-  slotModels: Partial<Record<ModelSlot, {
-    profileId: string | null;
-    provider: string | null;
-    model: string | null;
-    reasoningEffort: ReasoningEffort;
-    thinkingDisabled?: boolean;
-  }>>;
-  auth: {
-    configured: boolean;
-    accountId?: string | null;
-    authFilePath: string;
-    lastRefresh?: string | null;
-  };
-  profiles: ProxyProfile[];
-  error?: string;
-}
-interface AdminConfigUpdate {
-  models?: Partial<Record<ModelSlot, ScopeSlotConfig | null>>;
-}
-interface ConversationHistoryEntry {
-  id: string;
-  scope: string;
-  requestId: string;
-  direction: 'request' | 'response' | 'error';
-  role: string | null;
-  messageType: string;
-  model: string | null;
-  slot: ModelSlot;
-  payloadJson: string;
-  createdAt: string;
-}
-interface ConversationHistoryPage {
-  items: ConversationHistoryEntry[];
-  nextCursor: string | null;
-  total: number;
-}
-interface ConversationHistoryStats {
-  scope: string;
-  retentionLimit: number;
-  totalMessages: number;
-  oldestCreatedAt: string | null;
-  newestCreatedAt: string | null;
-}
-interface TransportHandler {
-  start(): Promise<void>;
-  stop(): Promise<void>;
-}
-//#endregion
-//#region src/adapters/codex/CodexAuth.d.ts
-declare class CodexAuth {
-  private readonly logger;
-  private readonly authFilePath;
-  private static readonly TOKEN_REFRESH_URL;
-  private static readonly CLIENT_ID;
-  constructor(logger?: LoggerLike, authFilePath?: string);
-  getAuthFilePath(): string;
-  getAuthStatus(): Promise<{
-    configured: boolean;
-    accountId?: string | null;
-    authFilePath: string;
-    lastRefresh?: string | null;
-  }>;
-  getAccountId(): Promise<string | null>;
-  getAccessToken(): Promise<string | null>;
-  private readAuthFile;
-  private isTokenExpired;
-  private decodeJWT;
-  private refreshAccessToken;
-  private saveTokens;
-}
-//#endregion
-//#region src/services/ConversationHistoryService.d.ts
-type NewHistoryEntry = Omit<ConversationHistoryEntry, 'id' | 'createdAt'> & {
-  id?: string;
-  createdAt?: string;
-};
-/**
- * Error raised for conversation history persistence failures.
- */
-
-/**
- * Persists scoped conversation history using SQLite and enforces bounded retention.
- *
- * Environment variables:
- * - `MODEL_PROXY_MCP_DB_PATH`
- */
-declare class ConversationHistoryService {
-  private readonly dbPath;
-  private readonly retentionLimit;
-  private readonly logger;
-  private sqlite;
-  /**
-   * Creates a SQLite-backed history store.
-   *
-   * `dbPath` defaults to `MODEL_PROXY_MCP_DB_PATH` or `~/.model-proxy/history.sqlite`.
-   * `retentionLimit` is enforced per scope after each insert batch.
-   * `logger` receives structured operational failures.
-   */
-  constructor(dbPath?: string, retentionLimit?: number, logger?: LoggerLike);
-  /**
-   * Eagerly initializes the SQLite database and schema.
-   */
-  ensureInitialized(): Promise<void>;
-  /**
-   * Inserts normalized history entries and prunes overflow per scope.
-   */
-  appendEntries(entries: NewHistoryEntry[]): Promise<void>;
-  /**
-   * Lists conversation history for a scope ordered from newest to oldest.
-   */
-  listHistory(scope: string, limit?: number, cursor?: string): Promise<ConversationHistoryPage>;
-  /**
-   * Clears all history rows for a single scope and returns the deleted count.
-   */
-  clearScope(scope: string): Promise<number>;
-  /**
-   * Returns retention stats for a scope.
-   */
-  getStats(scope: string): Promise<ConversationHistoryStats>;
-  /**
-   * Lists known scopes discovered from stored conversation history.
-   */
-  listScopes(): Promise<string[]>;
-  /**
-   * Removes the oldest rows for a scope when it exceeds retention.
-   */
-  private pruneScope;
-  /**
-   * Lazily initializes the SQLite connection and schema.
-   */
-  private getDb;
-  /**
-   * Maps a SQLite row into the public history DTO.
-   */
-  private toEntry;
-}
-//#endregion
-//#region src/services/ProfileStore.d.ts
-declare class ProfileStore {
-  private readonly providerConfigPath;
-  private readonly modelListPath;
-  private readonly scopeSettingsDir;
-  private readonly logger;
-  constructor(providerConfigPath?: string, modelListPath?: string, scopeSettingsDir?: string, logger?: LoggerLike);
-  getConfigPath(scope?: string): string;
-  ensureConfig(scope?: string, seedConfigPath?: string): Promise<ProxyConfig>;
-  listScopes(): Promise<string[]>;
-  getConfig(scope?: string, seedConfigPath?: string): Promise<ProxyConfig>;
-  getAdminConfig(scope?: string): Promise<AdminConfig>;
-  listProfiles(scope?: string): Promise<ProxyProfile[]>;
-  getActiveProfile(scope?: string, slot?: ModelSlot): Promise<ProxyProfile | null>;
-  getResolvedSlotConfig(scope?: string, slot?: ModelSlot): Promise<ResolvedSlotConfig>;
-  setActiveProfile(profileId: string, scope?: string, slot?: ModelSlot): Promise<ProxyConfig>;
-  upsertProfile(profile: ProxyProfile, scope?: string): Promise<ProxyConfig>;
-  updateConfig(update: AdminConfigUpdate, scope?: string): Promise<ProxyConfig>;
-  private getScopeConfigPath;
-  private sanitizeScope;
-  private getSettings;
-  private readSettings;
-  private isFileNotFoundError;
-  private loadScopeSeedSettings;
-  private getDefaultScopeSeedPath;
-  private normalizeSettings;
-  private normalizeProviders;
-  private getDefaultSelection;
-  private normalizeSlotSelection;
-  private normalizeFallbacks;
-  private toProxyConfig;
-  private resolveSlotConfig;
-  private toProfiles;
-  private saveSettings;
-}
-//#endregion
-//#region src/services/GatewayService.d.ts
-interface ForwardedResponse {
-  status: number;
-  body: string;
-  headers: Record<string, string>;
-}
-/**
- * Coordinates settings-backed model selection, request forwarding, and scoped history persistence.
- */
-declare class GatewayService {
-  private readonly profileStore;
-  private readonly codexAuth;
-  private readonly logger;
-  private readonly fetchImpl;
-  private readonly historyService;
-  constructor(profileStore?: ProfileStore, codexAuth?: CodexAuth, logger?: LoggerLike, fetchImpl?: typeof fetch, historyService?: ConversationHistoryService);
-  /**
-   * Lists all configured profiles for the given scope.
-   */
-  listProfiles(scope?: string): Promise<ProxyProfile[]>;
-  /**
-   * Eagerly seeds the scoped settings file so startup always has a backing config.
-   */
-  ensureConfig(scope?: string): Promise<Awaited<ReturnType<ProfileStore['ensureConfig']>>>;
-  /**
-   * Returns the resolved admin config used by the live HTTP server and UI.
-   */
-  getAdminConfig(scope?: string): Promise<AdminConfig>;
-  /**
-   * Updates the resolved admin config.
-   */
-  updateAdminConfig(update: AdminConfigUpdate, scope?: string): Promise<AdminConfig>;
-  /**
-   * Returns the currently selected profile for a scope/slot pair.
-   */
-  getActiveProfile(scope?: string, slot?: ModelSlot): Promise<ProxyProfile | null>;
-  /**
-   * Creates or updates a profile in the scoped settings file.
-   */
-  upsertProfile(profile: ProxyProfile, scope?: string): Promise<Awaited<ReturnType<ProfileStore['upsertProfile']>>>;
-  /**
-   * Selects the active profile by profile id for the requested slot.
-   */
-  setActiveProfile(profileId: string, scope?: string, slot?: ModelSlot): Promise<Awaited<ReturnType<ProfileStore['setActiveProfile']>>>;
-  /**
-   * Returns the active profile currently used for routing requests.
-   */
-  getCurrentModel(scope?: string, slot?: ModelSlot): Promise<ProxyProfile | null>;
-  /**
-   * Switches the selected model by model name.
-   */
-  switchModel(model: string, scope?: string, slot?: ModelSlot): Promise<Awaited<ReturnType<ProfileStore['updateConfig']>>>;
-  /**
-   * Lists persisted history for a scope.
-   */
-  listHistory(scope?: string, limit?: number, cursor?: string): Promise<ConversationHistoryPage>;
-  /**
-   * Clears persisted history for a scope.
-   */
-  clearHistory(scope?: string): Promise<{
-    deleted: number;
-  }>;
-  /**
-   * Lists known scopes from config files and stored history.
-   */
-  listScopes(): Promise<string[]>;
-  /**
-   * Returns persisted history stats for a scope.
-   */
-  getHistoryStats(scope?: string): Promise<ConversationHistoryStats>;
-  /**
-   * Returns the current gateway status, auth state, and active slot routing.
-   */
-  getStatus(scope?: string, port?: number, pid?: number): Promise<GatewayStatus>;
-  /**
-   * Returns the OpenAI-compatible model listing served by the proxy.
-   */
-  getModels(scope?: string): Promise<{
-    object: string;
-    data: Array<{
-      id: string;
-      object: string;
-      created: number;
-      owned_by: string;
-      metadata: Record<string, string>;
-    }>;
-  }>;
-  /**
-   * Forwards a Claude-compatible request to the configured upstream Codex endpoint.
-   */
-  forwardClaudeRequest(requestBody: string, scope?: string, requestHeaders?: Headers): Promise<ForwardedResponse>;
-  private buildAttemptTargets;
-  private forwardSingleAttempt;
-  private isRecoverableUpstreamError;
-  private forwardCodexRequest;
-  /**
-   * Forwards a Claude-compatible request to the Gemini GenerateContent REST API and translates the result back to Claude SSE.
-   */
-  private forwardGeminiDirectRequest;
-  private forwardGeminiCodeAssistRequest;
-  /**
-   * Builds response headers shared by successful SSE responses.
-   */
-  private createSuccessHeaders;
-  /**
-   * Builds the target Gemini REST endpoint for buffered or streaming requests.
-   */
-  private createGeminiRequestUrl;
-  private createCodeAssistUrl;
-  private resolveCodeAssistProjectId;
-  private toCodeAssistGenerateContentRequest;
-  private normalizeCodeAssistBufferedResponse;
-  private normalizeCodeAssistStreamingResponse;
-  private extractCodeAssistResponse;
-  /**
-   * Resolves the logical slot from a Claude model name or configured model mapping.
-   */
-  private resolveSlot;
-  /**
-   * Reconciles a request-specified concrete model with the resolved slot configuration.
-   */
-  private resolveRequestedModel;
-  /**
-   * Forwards a Claude-compatible request to an Anthropic-compatible upstream such as Z.ai.
-   */
-  private forwardAnthropicCompatibleRequest;
-  /**
-   * Resolves the environment-provided auth token for Anthropic-compatible upstreams.
-   */
-  private getAnthropicCompatibleAuthToken;
-  /**
-   * Resolves the request timeout for upstream Anthropic-compatible calls.
-   */
-  private resolveUpstreamTimeoutMs;
-  private createErrorResponse;
-  /**
-   * Parses and validates an inbound Claude request.
-   */
-  private parseClaudeRequest;
-  /**
-   * Persists normalized inbound request messages for a proxied call.
-   */
-  private recordRequest;
-  /**
-   * Persists normalized upstream response items or a stream fallback.
-   */
-  private recordResponse;
-  /**
-   * Persists a redacted error record for the request lifecycle.
-   */
-  private recordError;
-  /**
-   * Normalizes Claude system payloads into storable entries.
-   */
-  private normalizeSystemPayloads;
-  /**
-   * Removes proxy-private metadata before sending Claude payloads to strict Anthropic-compatible upstreams.
-   */
-  private sanitizeClaudePayloadForAnthropic;
-  private stripPrivateChatGptMetadata;
-  /**
-   * Extracts a message role string when present.
-   */
-  private extractRole;
-  /**
-   * Extracts response output items from upstream SSE payloads for storage.
-   */
-  private normalizeResponsePayloads;
-  /**
-   * Extracts the completed response envelope from an upstream SSE event payload.
-   */
-  private extractCompletedResponse;
-  /**
-   * Redacts large request bodies before they are stored in error history.
-   */
-  private summarizePayload;
-}
-//#endregion
-//#region src/server/http.d.ts
-declare function createHttpServer(gatewayService?: GatewayService): Hono<hono_types0.BlankEnv, hono_types0.BlankSchema, "/">;
-//#endregion
-//#region src/server/index.d.ts
-declare function createServer(gatewayService?: GatewayService, environment?: NodeJS.ProcessEnv): Server;
-//#endregion
-//#region src/transports/stdio.d.ts
-declare class StdioTransportHandler implements TransportHandler {
-  private readonly server;
-  private transport;
-  constructor(server: Server);
-  start(): Promise<void>;
-  stop(): Promise<void>;
-}
-//#endregion
-export { AdminConfig, AdminConfigUpdate, ConversationHistoryEntry, ConversationHistoryPage, ConversationHistoryService, ConversationHistoryStats, GatewayService, GatewayStatus, GeminiAuthMode, LoggerLike, ModelSlot, ProfileStore, ProviderRuntimeConfig, ProxyConfig, ProxyModelConfig, ProxyProfile, ProxyProviderType, ProxySettings, ReasoningEffort, ResolvedSlotConfig, ScopeConfig, ScopeModelSelection, ScopeSettings, ScopeSlotConfig, StdioTransportHandler, TransportHandler, createHttpServer, createServer };