@proveanything/smartlinks 1.7.8 → 1.7.9

package/dist/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.7.8  |  Generated: 2026-03-12T16:18:35.207Z
+Version: 1.7.9  |  Generated: 2026-03-12T17:26:42.940Z
 
 This is a concise summary of all available API functions and types.
 

package/dist/docs/ai.md

@@ -349,8 +349,11 @@ if (toolCall) {
 const models = await ai.models.list('my-collection');
 
 // Or filter by provider / capability
-const googleVisionModels = await ai.models.list('my-collection', {
-  provider: 'google',
+const openAiModels = await ai.models.list('my-collection', {
+  provider: 'openai'
+});
+
+const visionModels = await ai.models.list('my-collection', {
   capability: 'vision'
 });
 
@@ -366,13 +369,18 @@ const model = await ai.models.get('my-collection', 'google/gemini-2.5-flash');
 console.log(model.capabilities); // ['text', 'vision', 'audio', 'code']
 ```
 
+Use `ai.models.list(collectionId)` as the source of truth for what your collection can use at runtime. The public docs provide recommendations, but actual availability depends on the SmartLinks model catalog exposed to that collection.
+
 **Recommended Models:**
 
 | Model | Use Case | Speed | Cost |
 |-------|----------|-------|------|
-| `google/gemini-2.5-flash-lite` | Simple Q&A | Fastest | Lowest |
-| `google/gemini-2.5-flash` | General purpose | Fast | Low |
-| `google/gemini-2.5-pro` | Complex reasoning | Slower | Higher |
+| `openai/gpt-5.4` | Default for new agentic and structured-output workflows | Balanced | Medium |
+| `openai/gpt-5-mini` | Lower-cost general purpose and JSON tasks | Fast | Low |
+| `google/gemini-2.5-flash` | Fast multimodal and cost-sensitive general use | Fast | Low |
+| `google/gemini-2.5-pro` | Complex reasoning and heavier multimodal tasks | Slower | Higher |
+
+If you want a safe default for most new work, start with `openai/gpt-5.4`. If you want a lower-cost fallback, use `openai/gpt-5-mini` or `google/gemini-2.5-flash` depending on your latency and pricing goals.
 
 ---
 
@@ -1577,23 +1585,27 @@ console.log('Rate limit reset for user-123');
 ### 1. Choose the Right Model
 
 ```typescript
-// For simple Q&A (fast, cheap)
-await ai.chat.completions.create('my-collection', {
-  model: 'google/gemini-2.5-flash-lite',
-  messages: [...]
+// For most new workflows (recommended default)
+await ai.chat.responses.create('my-collection', {
+  model: 'openai/gpt-5.4',
+  input: 'Create a concise onboarding checklist.'
 });
 
-// For general use (balanced)
-await ai.chat.completions.create('my-collection', {
-  model: 'google/gemini-2.5-flash',
-  messages: [...]
+// For lower-cost structured or JSON-oriented work
+await ai.chat.responses.create('my-collection', {
+  model: 'openai/gpt-5-mini',
+  input: 'Return a color palette as JSON.'
 });
 
-// For complex reasoning (powerful)
+// For fast multimodal or cost-sensitive general use
 await ai.chat.completions.create('my-collection', {
-  model: 'google/gemini-2.5-pro',
+  model: 'google/gemini-2.5-flash',
   messages: [...]
 });
+
+// When you need the actual available catalog for this collection
+const available = await ai.models.list('my-collection');
+console.log(available.data.map(model => model.id));
 ```
 
 ### 2. Use Streaming for Long Responses

package/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.7.8  |  Generated: 2026-03-12T16:18:35.207Z
+Version: 1.7.9  |  Generated: 2026-03-12T17:26:42.940Z
 
 This is a concise summary of all available API functions and types.
 

package/docs/ai.md

@@ -349,8 +349,11 @@ if (toolCall) {
 const models = await ai.models.list('my-collection');
 
 // Or filter by provider / capability
-const googleVisionModels = await ai.models.list('my-collection', {
-  provider: 'google',
+const openAiModels = await ai.models.list('my-collection', {
+  provider: 'openai'
+});
+
+const visionModels = await ai.models.list('my-collection', {
   capability: 'vision'
 });
 
@@ -366,13 +369,18 @@ const model = await ai.models.get('my-collection', 'google/gemini-2.5-flash');
 console.log(model.capabilities); // ['text', 'vision', 'audio', 'code']
 ```
 
+Use `ai.models.list(collectionId)` as the source of truth for what your collection can use at runtime. The public docs provide recommendations, but actual availability depends on the SmartLinks model catalog exposed to that collection.
+
 **Recommended Models:**
 
 | Model | Use Case | Speed | Cost |
 |-------|----------|-------|------|
-| `google/gemini-2.5-flash-lite` | Simple Q&A | Fastest | Lowest |
-| `google/gemini-2.5-flash` | General purpose | Fast | Low |
-| `google/gemini-2.5-pro` | Complex reasoning | Slower | Higher |
+| `openai/gpt-5.4` | Default for new agentic and structured-output workflows | Balanced | Medium |
+| `openai/gpt-5-mini` | Lower-cost general purpose and JSON tasks | Fast | Low |
+| `google/gemini-2.5-flash` | Fast multimodal and cost-sensitive general use | Fast | Low |
+| `google/gemini-2.5-pro` | Complex reasoning and heavier multimodal tasks | Slower | Higher |
+
+If you want a safe default for most new work, start with `openai/gpt-5.4`. If you want a lower-cost fallback, use `openai/gpt-5-mini` or `google/gemini-2.5-flash` depending on your latency and pricing goals.
 
 ---
 
@@ -1577,23 +1585,27 @@ console.log('Rate limit reset for user-123');
 ### 1. Choose the Right Model
 
 ```typescript
-// For simple Q&A (fast, cheap)
-await ai.chat.completions.create('my-collection', {
-  model: 'google/gemini-2.5-flash-lite',
-  messages: [...]
+// For most new workflows (recommended default)
+await ai.chat.responses.create('my-collection', {
+  model: 'openai/gpt-5.4',
+  input: 'Create a concise onboarding checklist.'
 });
 
-// For general use (balanced)
-await ai.chat.completions.create('my-collection', {
-  model: 'google/gemini-2.5-flash',
-  messages: [...]
+// For lower-cost structured or JSON-oriented work
+await ai.chat.responses.create('my-collection', {
+  model: 'openai/gpt-5-mini',
+  input: 'Return a color palette as JSON.'
 });
 
-// For complex reasoning (powerful)
+// For fast multimodal or cost-sensitive general use
 await ai.chat.completions.create('my-collection', {
-  model: 'google/gemini-2.5-pro',
+  model: 'google/gemini-2.5-flash',
   messages: [...]
 });
+
+// When you need the actual available catalog for this collection
+const available = await ai.models.list('my-collection');
+console.log(available.data.map(model => model.id));
 ```
 
 ### 2. Use Streaming for Long Responses

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proveanything/smartlinks",
-  "version": "1.7.8",
+  "version": "1.7.9",
   "description": "Official JavaScript/TypeScript SDK for the Smartlinks API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",