@framers/agentos 0.1.218 → 0.1.219

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +20 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -231,6 +231,26 @@ const m = mission('research').goal('Research {topic}').planner({ strategy: 'adap
231
231
 
232
232
  Auto-detection: OpenAI → Anthropic → OpenRouter → Gemini → Groq → Together → Mistral → xAI → CLI → Ollama
233
233
 
234
+ ### Model String Formats
235
+
236
+ Three ways to specify a model:
237
+
238
+ ```ts
239
+ // 1. Separate fields (recommended)
240
+ generateText({ provider: 'anthropic', model: 'claude-sonnet-4-20250514', prompt: '...' });
241
+
242
+ // 2. Colon format (canonical combined string)
243
+ generateText({ model: 'anthropic:claude-sonnet-4-20250514', prompt: '...' });
244
+
245
+ // 3. Slash format (also supported for known providers)
246
+ generateText({ model: 'anthropic/claude-sonnet-4-20250514', prompt: '...' });
247
+
248
+ // Auto-detect (omit both provider and model)
249
+ generateText({ prompt: '...' }); // uses first available provider
250
+ ```
251
+
252
+ The slash format only splits on known provider prefixes (`openai`, `anthropic`, `openrouter`, etc.). Unknown prefixes like `meta-llama/llama-3.1-8b` pass through as a plain model name to the auto-detected provider.
253
+
234
254
  ---
235
255
 
236
256
  ## API Reference
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@framers/agentos",
3
- "version": "0.1.218",
3
+ "version": "0.1.219",
4
4
  "description": "Modular AgentOS orchestration library",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",