sarvam-ai-sdk 0.0.4 → 0.0.6

package/README.md

@@ -69,9 +69,28 @@ const { text } = await transcribe({
 console.log(text); // പാചകം തുടരും സുഹൃത്തുക്കളെ
 ```
 
+## Translation
+
+> NB: Only transliterates `prompt` and `role:user` messages, not `system` not `assistant`.
+
+```ts
+import { sarvam } from "sarvam-ai-sdk";
+import { generateText } from "ai";
+
+const result = await generateText({
+    model: sarvam.translation({
+        "to": "en-IN",
+        "from": "ml-IN"
+    }),
+    prompt: "ഇതൊക്കെ ശ്രദ്ധിക്കണ്ടേ അംബാനെ?",
+});
+
+console.log(result.text); // Shouldn't we be careful about this, Ambane?
+```
+
 ## Transliterate
 
-> Only transliterates `prompt` and `role:user` messages, not `system` not `assistant`.
+> NB: Only transliterates `prompt` and `role:user` messages, not `system` not `assistant`.
 
 ```ts
 import { sarvam } from "sarvam-ai-sdk";
@@ -88,6 +107,22 @@ const result = await generateText({
 console.log(result.text); // എടാ മോനെ, ഹാപ്പി അല്ലേ?
 ```
 
+## Language Identification
+
+> NB: Only identifies `prompt` and `role:user` messages, not `system` not `assistant`.
+
+```ts
+import { sarvam } from "sarvam-ai-sdk";
+import { generateText } from "ai";
+
+const result = await generateText({
+    model: sarvam.languageIdentification(),
+    prompt: "ബുദ്ധിയാണ് സാറേ ഇവൻ്റെ മെയിൻ",
+});
+
+console.log(result.text); // ml-IN
+```
+
 ## Tool Calling
 
 > [!WARNING]
@@ -101,7 +136,7 @@ import { sarvam } from "sarvam-ai-sdk";
 
 const result = await generateText({
   model: sarvam("sarvam-m", {
-    simulateToolCalling: true, // ⚠️ important
+    simulate: "tool-calling" // ⚠️ important
   }),
   tools: {
     weather: tool({
@@ -121,6 +156,32 @@ const result = await generateText({
 
 console.log(result.toolResults);
 ```
+## Generate JSON object
+
+> [!WARNING]
+> Latest `sarvam-m` model isn't trained on native JSON object generation. So we simulate this with prompt engineering technique.
+
+```ts
+import { z } from "zod";
+import { sarvam } from "sarvam-ai-sdk";
+import { generateObject } from 'ai';
+
+const { object } = await generateObject({
+  model: sarvam("sarvam-m", {
+    simulate: "json-object" // ⚠️ important
+  }),
+  schema: z.object({
+    recipe: z.object({
+      name: z.string(),
+      ingredients: z.array(z.string()),
+      steps: z.array(z.string()),
+    }),
+  }),
+  prompt: 'Generate a South Indian recipe, in Malayalam',
+});
+
+console.log(object);
+```
 
 ## Documentation