rosetta-ai 1.0.0 → 1.0.1

package/README.md

@@ -2,18 +2,19 @@
 
 The translation layer for LLM provider messages.
 
-Rosetta allows you to seamlessly convert messages between different LLM providers using a standardized intermediate format (GenAI).
+Rosetta converts messages between different LLM providers using a standardized intermediate format (GenAI). Just pass in messages from any provider—OpenAI, Anthropic, Google, or even custom formats—and get consistent output. No manual mapping required.
 
 ## Features
 
-- Convert messages from any supported provider to a unified GenAI format
-- Convert GenAI messages to any supported provider format
-- Automatic provider detection when source is not specified
-- Full TypeScript support with strict types
-- Runtime validation with Zod schemas
-- Preserve provider-specific metadata for lossless round-trips
-- Works in Node.js and browsers
-- Tree-shakeable ESM build
+- 🔄 Convert messages from any supported provider to a unified GenAI format
+- 🔀 Convert GenAI messages to any supported provider format
+- 🪄 **Universal fallback** - Pass messages from *any* LLM provider or framework, even unsupported ones, and we'll attempt best-effort conversion
+- 🔍 Automatic provider detection when source is not specified
+- 📝 Full TypeScript support with strict types
+- ✅ Runtime validation with Zod schemas
+- 💾 Preserve provider-specific metadata for lossless round-trips
+- 🌐 Works in Node.js and browsers
+- 🌳 Tree-shakeable ESM build
 
 ## Installation
 
@@ -115,7 +116,24 @@ const { messages } = translator.translate(inputMessages);
 | Google Gemini      | ✅ Available | ✅      | -         |
 | Compat             | ✅ Available | ✅      | -         |
 
-**Compat Provider**: A universal fallback that attempts to convert any message format to GenAI. It automatically normalizes field names (e.g., `tool_calls` vs `toolCalls`) and detects common LLM message patterns. When auto-detection is enabled and no specific provider matches, Compat is used as the fallback.
+### Universal Compatibility
+
+The **Compat** provider is a universal fallback that handles messages from *any* LLM provider—even ones not explicitly supported. When you call `translate()` without specifying a source provider, Rosetta tries to match against known provider schemas. If none match, it automatically falls back to Compat, which:
+
+- Normalizes field names across conventions (`tool_calls`, `toolCalls`, `tool-calls` all work)
+- Detects common patterns: roles, content arrays, tool calls, images, reasoning, etc.
+- Handles formats from Cohere, Mistral, Ollama, AWS Bedrock, LangChain, and more
+- Preserves unrecognized data so nothing is lost
+
+```typescript
+// Works with any provider - no need to specify the source
+const weirdMessages = [
+  { role: "user", content: "Hello" },
+  { role: "assistant", tool_calls: [{ id: "1", function: { name: "search", arguments: "{}" } }] },
+];
+
+const { messages } = translate(weirdMessages); // Just works™
+```
 
 More providers will be added. See [AGENTS.md](./AGENTS.md) for contribution guidelines.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rosetta-ai",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "author": "Latitude Data SL",
   "license": "MIT",
   "description": "The translation layer for LLM provider messages",