@jeffusion/bungee-llms 5.20.0 → 5.22.0

package/README.md

@@ -1,38 +1,15 @@
 # @jeffusion/bungee-llms
 
-Independent LLM adapters and protocol conversion package for Bungee.
+Pure protocol sessions, canonical messages/tools, streaming state machines and token accounting 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
+Gateway plugins consume `llm-protocol-adapter` public services. The adapter executes the codec locally in each worker; generation bodies never go through control RPC. Provider runtime abstractions remain available to other package consumers, but are not a second gateway conversion path.
 
 ```ts
-import {
-  LLMProtocolAdapterRegistry,
-  LLMProtocolConversionService,
-  LLMSRuntime,
-  registerDefaultProtocolConverters
-} from '@jeffusion/bungee-llms';
-
-registerDefaultProtocolConverters();
+import {createProtocolSession, describeProtocolConversion} from '@jeffusion/bungee-llms/plugin-api';
+const session = createProtocolSession({sourceProtocol: 'responses', targetProtocol: 'chat_completions', model: 'model'});
+const request = session.convertRequest({input: 'Hello'});
+// Feed the target JSON response or parsed SSE events into the same session.
+session.dispose();
 ```
 
-### 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';
-```
+The matrix has four passthrough pairs, ten direct conversions and two rejected Responses/Gemini pairs. Explicit reasoning controls require a verified wire policy. Tools, history and output constraints fail with a safe reason and param when their semantics cannot be preserved. See [LLM Protocol Adapter](../../docs/reference/llm-protocol-adapter.md).

package/dist/index.d.ts

@@ -7,6 +7,6 @@ export * from './registry';
 export * from './service';
 export * from './openai';
 export * from './openai-anthropic';
-export * from './protocol-converters';
 export * from './token-accounting';
 export * from './responses-codec';
+export * from './protocol-session';