@jeffusion/bungee-llms 3.2.0

package/README.md

@@ -0,0 +1,38 @@
+# @jeffusion/bungee-llms
+
+Independent LLM adapters and protocol conversion package for Bungee.
+
+## Scope
+
+- Provider-agnostic protocol conversion abstractions
+- Adapter registry and conversion service
+- Provider catalog and runtime container
+- OpenAI/Anthropic/Gemini protocol converters (request/response/stream) centralized in `src/protocol-converters`
+- Runtime registration helper `registerDefaultProtocolConverters()` for plugin/wrapper layers
+
+## Usage
+
+```ts
+import {
+  LLMProtocolAdapterRegistry,
+  LLMProtocolConversionService,
+  LLMSRuntime,
+  registerDefaultProtocolConverters
+} from '@jeffusion/bungee-llms';
+
+registerDefaultProtocolConverters();
+```
+
+### Plugin/Wrapper Stable Facade
+
+For plugin and wrapper layers, prefer the dedicated stable entrypoint to reduce coupling to internal file layout:
+
+```ts
+import {
+  type AIConverter,
+  ProtocolTransformerRegistry,
+  registerDefaultProtocolConverters,
+  OpenAIProtocolConversion,
+  OpenAIMessagesCompatibilityNormalizer
+} from '@jeffusion/bungee-llms/plugin-api';
+```

package/dist/adapter.d.ts

@@ -0,0 +1 @@
+export * from './core/adapter';

package/dist/core/adapter.d.ts

@@ -0,0 +1,10 @@
+import type { CanonicalRequest, CanonicalResponse, CanonicalStreamEvent, ConversionContext, LLMProvider } from './types';
+export interface LLMProtocolAdapter<ProviderRequest = unknown, ProviderResponse = unknown, ProviderStreamEvent = unknown> {
+    readonly provider: LLMProvider;
+    toCanonicalRequest(request: ProviderRequest, context: ConversionContext): CanonicalRequest;
+    fromCanonicalRequest(request: CanonicalRequest, context: ConversionContext): ProviderRequest;
+    toCanonicalResponse(response: ProviderResponse, context: ConversionContext): CanonicalResponse;
+    fromCanonicalResponse(response: CanonicalResponse, context: ConversionContext): ProviderResponse;
+    toCanonicalStreamEvent?(event: ProviderStreamEvent, context: ConversionContext): CanonicalStreamEvent | null;
+    fromCanonicalStreamEvent?(event: CanonicalStreamEvent, context: ConversionContext): ProviderStreamEvent | null;
+}

package/dist/core/conversion-service.d.ts

@@ -0,0 +1,14 @@
+import type { LLMProtocolAdapter } from './adapter';
+import { LLMProtocolAdapterRegistry } from './registry';
+import type { CanonicalStreamEvent, LLMProvider } from './types';
+export declare class LLMProtocolConversionService {
+    private readonly registry;
+    constructor(registry?: LLMProtocolAdapterRegistry);
+    registerAdapter(adapter: LLMProtocolAdapter): void;
+    unregisterAdapter(provider: LLMProvider): void;
+    convertRequest<T = unknown>(from: LLMProvider, to: LLMProvider, request: unknown, metadata?: Record<string, unknown>): T;
+    convertResponse<T = unknown>(from: LLMProvider, to: LLMProvider, response: unknown, metadata?: Record<string, unknown>): T;
+    convertStreamEvent<T = unknown>(from: LLMProvider, to: LLMProvider, event: unknown, metadata?: Record<string, unknown>): T | null;
+    getRegisteredProviders(): string[];
+    createPassthroughStreamEvent(type: string, payload: unknown): CanonicalStreamEvent;
+}

package/dist/core/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types';
+export * from './adapter';
+export * from './registry';
+export * from './conversion-service';

package/dist/core/registry.d.ts

@@ -0,0 +1,10 @@
+import type { LLMProtocolAdapter } from './adapter';
+import type { LLMProvider } from './types';
+export declare class LLMProtocolAdapterRegistry {
+    private readonly adapters;
+    register(adapter: LLMProtocolAdapter): void;
+    unregister(provider: LLMProvider): void;
+    get(provider: LLMProvider): LLMProtocolAdapter | undefined;
+    require(provider: LLMProvider): LLMProtocolAdapter;
+    listProviders(): string[];
+}

package/dist/core/types.d.ts

@@ -0,0 +1,40 @@
+export type LLMProvider = 'openai' | 'anthropic' | 'gemini' | (string & {});
+export type CanonicalRole = 'system' | 'developer' | 'user' | 'assistant' | 'tool';
+export interface CanonicalToolDefinition {
+    name: string;
+    description?: string;
+    parameters?: Record<string, unknown>;
+}
+export interface CanonicalToolCall {
+    id: string;
+    name: string;
+    arguments: string;
+}
+export interface CanonicalMessage {
+    role: CanonicalRole;
+    content: unknown;
+    toolCalls?: CanonicalToolCall[];
+    toolCallId?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface CanonicalRequest {
+    model?: string;
+    messages: CanonicalMessage[];
+    tools?: CanonicalToolDefinition[];
+    toolChoice?: unknown;
+    metadata?: Record<string, unknown>;
+}
+export interface CanonicalResponse {
+    message?: CanonicalMessage;
+    messages?: CanonicalMessage[];
+    metadata?: Record<string, unknown>;
+}
+export interface CanonicalStreamEvent {
+    type: string;
+    payload: unknown;
+}
+export interface ConversionContext {
+    from: LLMProvider;
+    to: LLMProvider;
+    metadata?: Record<string, unknown>;
+}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from './core';
+export * from './providers';
+export * from './runtime';
+export * from './types';
+export * from './adapter';
+export * from './registry';
+export * from './service';
+export * from './openai';
+export * from './openai-anthropic';
+export * from './protocol-converters';