@squidcloud/cli 1.0.488 → 1.0.489

package/dist/index.js

@@ -32174,7 +32174,8 @@ module.exports = function toBuffer(data, encoding) {
 var __webpack_unused_export__;
 
 __webpack_unused_export__ = ({ value: true });
-__webpack_unused_export__ = __webpack_unused_export__ = __webpack_unused_export__ = __webpack_unused_export__ = __webpack_unused_export__ = exports.h3 = exports.VF = __webpack_unused_export__ = exports.F3 = exports.eS = exports.Eh = exports.dH = exports.mz = exports.Pq = exports.lZ = exports.I1 = exports.xV = exports.Kq = exports.oL = exports.hp = exports.AI_PROVIDER_TYPES = __webpack_unused_export__ = void 0;
+__webpack_unused_export__ = __webpack_unused_export__ = __webpack_unused_export__ = __webpack_unused_export__ = __webpack_unused_export__ = exports.h3 = exports.VF = __webpack_unused_export__ = exports.F3 = exports.eS = exports.Eh = exports.dH = exports.mz = exports.Pq = exports.lZ = exports.I1 = exports.xV = exports.Kq = exports.oL = exports.hp = exports.MD = exports.AI_PROVIDER_TYPES = __webpack_unused_export__ = void 0;
+__webpack_unused_export__ = isFileCapableProviderType;
 __webpack_unused_export__ = isVendorAiChatModelName;
 __webpack_unused_export__ = isAiEmbeddingsModelName;
 __webpack_unused_export__ = isIntegrationEmbeddingModelSpec;
@@ -32204,29 +32205,40 @@ exports.AI_PROVIDER_TYPES = [
     'vertex',
     'external', // This is a technicality, referring to user-defined providers.
 ];
+/**
+ * The AI providers that support file upload operations, and so are the only ones that resolve a
+ * pre-uploaded file id. Declared as the list, with the type derived from it, so the two cannot drift:
+ * a provider added to one is added to both.
+ */
+exports.MD = [
+    'openai',
+    'gemini',
+    'anthropic',
+    'grok',
+];
+/**
+ * True when the provider resolves pre-uploaded file ids. Every other provider — the integration-backed
+ * and user-defined ones, which report no vendor identity of their own — ignores `fileIds` outright, so
+ * for them the ids are inert rather than wrong.
+ */
+function isFileCapableProviderType(type) {
+    return exports.MD.includes(type);
+}
 /**
  * Public OpenAI chat model names (active models only).
  * @category AI
  */
-exports.hp = [
-    'gpt-5.4-mini',
-    'gpt-5.4-nano',
-    'gpt-5.5',
-    'gpt-5.5-pro',
-    'gpt-5.6-sol',
-    'gpt-5.6-terra',
-    'gpt-5.6-luna',
-];
+exports.hp = ['gpt-5.5-pro', 'gpt-5.6-sol', 'gpt-5.6-terra', 'gpt-5.6-luna'];
 /**
  * Public Gemini chat model names (active models only).
  * @category AI
  */
-exports.oL = ['gemini-3.1-pro', 'gemini-3.6-flash', 'gemini-3.5-flash-lite'];
+exports.oL = ['gemini-3.1-pro', 'gemini-3.7-flash', 'gemini-3.5-flash-lite'];
 /**
  * Public Grok chat model names (active models only).
  * @category AI
  */
-exports.Kq = ['grok-4.5', 'grok-4-1-fast-reasoning', 'grok-4-1-fast-non-reasoning'];
+exports.Kq = ['grok-4.6', 'grok-4-1-fast-reasoning', 'grok-4-1-fast-non-reasoning'];
 /**
  * Public Anthropic chat model names (active models only).
  * @category AI
@@ -34735,7 +34747,24 @@ onStagingStarted) {
     activeJobIds.add(jobId);
     const { finalStatus, timedOut } = await waitForJobCompletion(client, jobId, batchLabel, timeoutMillis, isInterrupted);
     activeJobIds.delete(jobId);
-    return { batchIndex, batchCount, jobId, uploadFailures, duplicates, finalStatus, timedOut };
+    // A duplicate found by the deferred extraction pass (a presigned object's bytes are first hashed
+    // there) reports as a failed file with `errorCode: 'DUPLICATE_CONTENT'` — the same skip a
+    // staging-time rejection is, so fold it into the duplicates the summary reconciles by name.
+    const deferredDuplicates = (finalStatus?.files ?? [])
+        .filter(file => file.errorCode === 'DUPLICATE_CONTENT')
+        .map(file => file.title);
+    if (deferredDuplicates.length > 0) {
+        console.log(`${batchLabel}: ${deferredDuplicates.length} file(s) skipped as content this knowledge base already holds.`);
+    }
+    return {
+        batchIndex,
+        batchCount,
+        jobId,
+        uploadFailures,
+        duplicates: [...duplicates, ...deferredDuplicates],
+        finalStatus,
+        timedOut,
+    };
 }
 /** Mints presigned upload URLs for a batch, chunking requests to the server's per-call cap. */
 async function createUploadUrlsForBatch(client, fileNames) {
@@ -34832,7 +34861,13 @@ async function cancelActiveJobs(client, activeJobIds) {
 }
 function printProgress(batchLabel, jobId, status) {
     const { counts, state } = status;
-    const line = `${batchLabel} job ${jobId}: ${counts.finalized}/${counts.files} finalized, ${counts.failed} failed, state=${state}`;
+    // Deferred duplicates sit inside counts.failed but are skips to the caller (see printSummary) — shown
+    // raw, the live line says "1 failed" on a job the summary then reports as 0 failed, 1 skipped.
+    const duplicateSkips = status.files.filter(file => file.errorCode === 'DUPLICATE_CONTENT').length;
+    const failed = Math.max(0, counts.failed - duplicateSkips);
+    const skippedPart = duplicateSkips > 0 ? `, ${duplicateSkips} skipped` : '';
+    const line = `${batchLabel} job ${jobId}: ${counts.finalized}/${counts.files} finalized, ` +
+        `${failed} failed${skippedPart}, state=${state}`;
     process.stdout.write(`\r${line}${' '.repeat(Math.max(0, PROGRESS_LINE_WIDTH - line.length))}`);
 }
 /** Narrows a `FileUploadResult` to one that uploaded successfully (has a `stagedObjectKey`, no `error`). */
@@ -34855,7 +34890,13 @@ async function printDryRun(dir, files, batchSize) {
 }
 function printSummary(totalFiles, results) {
     const totalFinalized = results.reduce((sum, result) => sum + (result.finalStatus?.counts.finalized ?? 0), 0);
-    const totalServerFailed = results.reduce((sum, result) => sum + (result.finalStatus?.counts.failed ?? 0), 0);
+    // Deferred duplicates sit inside counts.failed but are reported on the "Skipped as duplicate" line
+    // (runBatch folds them into `duplicates`), so subtract them here or the two lines double-count.
+    const totalServerFailed = results.reduce((sum, result) => {
+        const failed = result.finalStatus?.counts.failed ?? 0;
+        const duplicateFailures = (result.finalStatus?.files ?? []).filter(file => file.errorCode === 'DUPLICATE_CONTENT').length;
+        return sum + Math.max(0, failed - duplicateFailures);
+    }, 0);
     const totalUploadFailed = results.reduce((sum, result) => sum + result.uploadFailures.length, 0);
     const totalDuplicates = results.reduce((sum, result) => sum + result.duplicates.length, 0);
     const totalStagedButFailed = results.reduce((sum, result) => sum + (result.stagingError ? (result.stagedCount ?? 0) : 0), 0);
@@ -34890,9 +34931,15 @@ function printSummary(totalFiles, results) {
         const state = result.timedOut
             ? `${result.finalStatus?.state ?? 'unknown'} (timed out waiting)`
             : result.finalStatus?.state;
-        console.log(`  ${label}: job ${result.jobId} — ${result.finalStatus?.counts.finalized ?? 0}/${result.finalStatus?.counts.files ?? 0} finalized, ${result.finalStatus?.counts.failed ?? 0} failed [${state}]`);
+        // Deferred duplicates are excluded from BOTH the failed count and the per-file failure lines: they
+        // are already named on the "skipped" lines below, and a clean idempotent re-run must not read as
+        // "0/1 finalized, 1 failed" while exiting 0 — the CLI tells one story about a skip.
+        const deferredDuplicateCount = result.finalStatus?.files.filter(file => file.errorCode === 'DUPLICATE_CONTENT').length ?? 0;
+        const failedCount = Math.max(0, (result.finalStatus?.counts.failed ?? 0) - deferredDuplicateCount);
+        console.log(`  ${label}: job ${result.jobId} — ${result.finalStatus?.counts.finalized ?? 0}/${result.finalStatus?.counts.files ?? 0} finalized, ${failedCount} failed [${state}]`);
         // Per-file failure reasons, straight from the job-status response (BulkIngestionFileStatus).
-        const failedFiles = result.finalStatus?.files.filter(file => file.status === 'failed') ?? [];
+        const failedFiles = result.finalStatus?.files.filter(file => file.status === 'failed' && file.errorCode !== 'DUPLICATE_CONTENT') ??
+            [];
         for (const failedFile of failedFiles) {
             console.log(`    - ${failedFile.title}: ${failedFile.errorMessage ?? 'unknown error'}`);
         }
@@ -34908,7 +34955,10 @@ function hasBatchFailed(result) {
         return true;
     if (!result.finalStatus)
         return true;
-    return result.finalStatus.state !== 'completed' || result.finalStatus.counts.failed > 0;
+    // Deferred duplicates are skips, not failures: an idempotent re-run over an already-ingested
+    // directory must exit 0, exactly as it does when staging rejects the duplicates synchronously.
+    const duplicateFailures = result.finalStatus.files.filter(file => file.errorCode === 'DUPLICATE_CONTENT').length;
+    return result.finalStatus.state !== 'completed' || result.finalStatus.counts.failed > duplicateFailures;
 }
 /** Recursively walks `dir`, skipping symlinks and dotfiles/dot-directories, filtered to `extensions`. */
 async function collectFiles(dir, extensions) {
@@ -40729,7 +40779,7 @@ module.exports = /*#__PURE__*/JSON.parse('{"name":"seek-bzip","version":"1.0.6",
 (module) {
 
 "use strict";
-module.exports = /*#__PURE__*/JSON.parse('{"name":"@squidcloud/cli","version":"1.0.488","description":"The Squid CLI","main":"dist/index.js","scripts":{"start":"node dist/index.js","start-ts":"ts-node -r tsconfig-paths/register src/index.ts","prebuild":"rimraf dist","build":"webpack --mode=production","build:dev":"webpack --mode=development","lint":"eslint","link":"npm run build && chmod 755 dist/index.js && npm link","watch":"webpack --watch","deploy":"npm run build && npm pack --silent | xargs -I {} mv {} package.tgz && npm install -g package.tgz && rm -rf package.tgz","publish:public":"npm run build && npm publish --access public"},"files":["dist/**/*"],"bin":{"squid":"dist/index.js"},"keywords":[],"author":"","license":"ISC","engines":{"node":">=18.0.0"},"dependencies":{"@squidcloud/local-backend":"^1.0.488","adm-zip":"^0.5.16","copy-webpack-plugin":"^14.0.0","decompress":"^4.2.1","logpipes":"^1.11.0","nodemon":"^3.1.9","terser-webpack-plugin":"^5.5.0","ts-loader":"^9.5.1","ts-node":"^10.9.2","tsconfig-paths":"^4.2.0","tsconfig-paths-webpack-plugin":"^4.1.0","webpack":"^5.106.2","zip-webpack-plugin":"^4.0.1"},"devDependencies":{"@types/adm-zip":"^0.5.7","@types/decompress":"^4.2.7","terminal-link":"^3.0.0"}}');
+module.exports = /*#__PURE__*/JSON.parse('{"name":"@squidcloud/cli","version":"1.0.489","description":"The Squid CLI","main":"dist/index.js","scripts":{"start":"node dist/index.js","start-ts":"ts-node -r tsconfig-paths/register src/index.ts","prebuild":"rimraf dist","build":"webpack --mode=production","build:dev":"webpack --mode=development","lint":"eslint","link":"npm run build && chmod 755 dist/index.js && npm link","watch":"webpack --watch","deploy":"npm run build && npm pack --silent | xargs -I {} mv {} package.tgz && npm install -g package.tgz && rm -rf package.tgz","publish:public":"npm run build && npm publish --access public"},"files":["dist/**/*"],"bin":{"squid":"dist/index.js"},"keywords":[],"author":"","license":"ISC","engines":{"node":">=18.0.0"},"dependencies":{"@squidcloud/local-backend":"^1.0.489","adm-zip":"^0.5.16","copy-webpack-plugin":"^14.0.0","decompress":"^4.2.1","logpipes":"^1.11.0","nodemon":"^3.1.9","terser-webpack-plugin":"^5.5.0","ts-loader":"^9.5.1","ts-node":"^10.9.2","tsconfig-paths":"^4.2.0","tsconfig-paths-webpack-plugin":"^4.1.0","webpack":"^5.106.2","zip-webpack-plugin":"^4.0.1"},"devDependencies":{"@types/adm-zip":"^0.5.7","@types/decompress":"^4.2.7","terminal-link":"^3.0.0"}}');
 
 /***/ }
 

package/dist/resources/claude/skills/squid-development/reference/ai.md

@@ -59,10 +59,10 @@ import {
 
 | Provider | `*_CHAT_MODEL_NAMES` |
 |---|---|
-| OpenAI | `gpt-5.4-mini`, `gpt-5.4-nano`, `gpt-5.5`, `gpt-5.5-pro`, `gpt-5.6-sol`, `gpt-5.6-terra`, `gpt-5.6-luna` |
+| OpenAI | `gpt-5.5-pro`, `gpt-5.6-sol`, `gpt-5.6-terra`, `gpt-5.6-luna` |
 | Anthropic | `claude-fable-5`, `claude-haiku-4-5-20251001`, `claude-opus-5`, `claude-sonnet-5` |
-| Gemini | `gemini-3.1-pro`, `gemini-3.6-flash`, `gemini-3.5-flash-lite` |
-| Grok | `grok-4.5`, `grok-4-1-fast-reasoning`, `grok-4-1-fast-non-reasoning` |
+| Gemini | `gemini-3.1-pro`, `gemini-3.7-flash`, `gemini-3.5-flash-lite` |
+| Grok | `grok-4.6`, `grok-4-1-fast-reasoning`, `grok-4-1-fast-non-reasoning` |
 
 This list moves. **Don't hardcode a model name from this table into user code** — call
 `squid.ai().listChatModels()`, which also returns the app's custom integration models
@@ -72,7 +72,7 @@ This list moves. **Don't hardcode a model name from this table into user code**
 **Model Categories:**
 - **Chat Models**: Used for AI Agents, AI Query, etc. (OpenAI, Anthropic, Gemini, Grok)
 - **Embedding Models**: Used for Knowledge Bases (OpenAI, Voyage)
-- **Image Generation Models**: Used for image creation (DALL-E, Stable Diffusion, Flux)
+- **Image Generation Models**: Used for image creation (OpenAI `gpt-image-*`, Stable Diffusion, Flux)
 - **Audio Models**: Transcription (Whisper, GPT-4o) and Text-to-Speech (TTS-1, GPT-4o-mini-tts)
 
 ## AI Agents
@@ -115,7 +115,7 @@ await myAgent.upsert({
   isPublic: false,  // Whether the agent is publicly accessible
   auditLog: true,   // Enable audit logging for compliance
   options: {
-    model: 'gpt-5.4-mini', // or 'claude-sonnet-5', 'gemini-3.6-flash' - see Supported Models
+    model: 'gpt-5.6-terra', // or 'claude-sonnet-5', 'gemini-3.7-flash' - see Supported Models
     instructions: 'You are a helpful customer support assistant. Be concise and professional.',
     temperature: 0.7
   }
@@ -386,7 +386,7 @@ const chatObs = agent.chat('What is your return policy?', {
   connectedKnowledgeBases: [{ knowledgeBaseId: 'kb1', description: 'When to use this KB' }],
 
   // Model & generation
-  model: 'gpt-5.4-mini', // Override agent's default model
+  model: 'gpt-5.6-terra', // Override agent's default model
   temperature: 0.7,
   maxTokens: 4000,
   maxOutputTokens: 2000,
@@ -433,7 +433,7 @@ const chatObs = agent.chat('What is your return policy?', {
   useCodeInterpreter: 'llm', // 'none' | 'llm' (OpenAI/Gemini only)
   executionPlanOptions: {
     enabled: true,
-    model: 'gpt-5.4-mini',
+    model: 'gpt-5.6-terra',
     reasoningEffort: 'high',
     allowClarificationQuestions: false
   },
@@ -818,10 +818,10 @@ REST API: [AI Image API](https://docs.getsquid.ai/reference-docs/api/#tag/AI-Ima
 ### Image Generation
 
 ```typescript
-// Generate image
+// Generate image - `modelName` is required
 const imageUrl = await squid.ai().image().generate(
   'A futuristic city',
-  { size: '1024x1024', quality: 'hd' }
+  { modelName: 'gpt-image-1', size: '1024x1024', quality: 'high' }
 );
 
 // Remove background
@@ -894,7 +894,7 @@ const settings = await aiClient.getApplicationAiSettings();
 
 // Set application AI settings
 await aiClient.setApplicationAiSettings({
-  defaultModel: 'gpt-5.4-mini',
+  defaultModel: 'gpt-5.6-terra',
   // ... other settings
 });
 

package/dist/resources/claude/skills/squid-development/reference/chat-widget.md

@@ -763,7 +763,7 @@ declare namespace JSX {
   squid-ai-instructions="Be concise and professional."
   squid-ai-functions="getOrderStatus,lookupAccount"
   squid-ai-connected-agents='[{"agentId":"billing-agent","description":"Handles billing questions"}]'
-  squid-ai-override-model="gpt-5.4-mini"
+  squid-ai-override-model="gpt-5.6-terra"
   squid-ai-temperature="0.7"
   squid-ai-max-tokens="2000"
   squid-ai-agent-chat-options='{

package/dist/resources/claude/skills/squid-development/reference/client.md

@@ -77,7 +77,7 @@ Every Squid application includes the **Essentials Connector** - a built-in integ
 | **Web Utilities** | `squid.web()` | AI-powered web search, URL content extraction, short URLs | [Web section](#web) |
 | **AI Agents** | `squid.ai().agent()` | Chat with built-in or custom AI agents | [ai.md](ai.md) |
 | **Knowledge Bases** | `squid.ai().knowledgeBase()` | RAG with semantic, keyword, and knowledge-graph search plus reranking | [ai.md](ai.md) |
-| **Image Generation** | `squid.ai().image()` | Generate images with DALL-E | [ai.md](ai.md) |
+| **Image Generation** | `squid.ai().image()` | Generate images with `gpt-image-*`, Stable Diffusion, or Flux | [ai.md](ai.md) |
 | **Audio** | `squid.ai().audio()` | Transcription and text-to-speech | [ai.md](ai.md) |
 | **PDF/Extraction** | `squid.extraction()` | Create PDFs, extract data from documents | [Extraction section](#extraction) |
 | **Observability** | `squid.observability` | Report and query custom metrics | [Observability section](#observability--metrics) |

package/dist/resources/claude/skills/squid-development/reference/console.md

@@ -156,7 +156,7 @@ const agent = squid.ai().agent('my-agent');
 await agent.upsert({
   description: 'Customer support agent',
   options: {
-    model: 'gpt-4o',
+    model: 'gpt-5.6-terra',
     instructions: 'You are a helpful support agent...'
   }
 });

package/dist/resources/claude/skills/squid-development/reference/openai.md

@@ -7,7 +7,7 @@ OpenAI-specific features in Squid. For general AI usage, see [ai.md](ai.md).
 ```typescript
 import {
   OPENAI_CHAT_MODEL_NAMES,                  // Chat models
-  OPENAI_IMAGE_MODEL_NAMES,                 // DALL-E
+  OPENAI_IMAGE_MODEL_NAMES,                 // gpt-image-*
   OPENAI_AUDIO_TRANSCRIPTION_MODEL_NAMES,   // Whisper
   OPENAI_AUDIO_CREATE_SPEECH_MODEL_NAMES,   // TTS
   OPENAI_EMBEDDINGS_MODEL_NAMES,            // Embeddings

package/dist/resources/claude/skills/squid-integrations/reference/connector-functions.md

@@ -12,7 +12,7 @@ Each Squid SaaS connector provides built-in AI functions that AI agents can call
 await squid.ai().agent('my-agent').upsert({
   description: 'Support agent',
   options: {
-    model: 'gpt-5.4-mini',
+    model: 'gpt-5.6-terra',
     instructions: 'You are a support agent that can search tickets and send messages.'
   }
 });

package/dist/resources/claude/skills/squid-react-development/SKILL.md

@@ -164,12 +164,13 @@ function TaskList({ userId }: { userId: string }) {
   const tasksCollection = useCollection<Task>('tasks');
   const query = tasksCollection.query().where('userId', '==', userId);
 
-  const { loading, data, error } = useQuery(query, {
+  const { loading, data, error, enabled } = useQuery(query, {
     enabled: !!userId,      // Only run when userId is set
     subscribe: true,        // Real-time updates (default)
     initialData: [],        // Initial data before first load
   }, [userId]);             // Re-subscribe when userId changes
 
+  if (!enabled) return <div>No user selected</div>;  // Check before `loading`
   if (loading) return <div>Loading...</div>;
   if (error) return <div>Error: {error.message}</div>;
 
@@ -201,9 +202,20 @@ interface QueryType<T> {
   loading: boolean;
   data: Array<T>;
   error: any;
+  enabled: boolean;       // Mirrors options.enabled
 }
 ```
 
+**`loading` stays `true` while the query is disabled.** A disabled query never subscribes, so it
+never resolves — gate on `enabled` first, or `if (loading)` renders a spinner forever:
+
+```typescript
+const { loading, data, error, enabled } = useQuery(query, { enabled: !!userId }, [userId]);
+
+if (!enabled) return <SelectUserPrompt />;  // Not "loading" - just not running
+if (loading) return <Spinner />;
+```
+
 **Single Snapshot vs Real-time:**
 ```typescript
 // Real-time updates (subscribe: true) - default
@@ -940,7 +952,7 @@ function AdvancedFeatures() {
     const agent = squid.ai().agent('new-agent');
     await agent.upsert({
       description: 'My new agent',
-      options: { model: 'gpt-4o' },
+      options: { model: 'gpt-5.6-terra' },
     });
   };
 
@@ -1054,13 +1066,18 @@ const { data } = useQuery(
 ### 2. Use `enabled` for Conditional Fetching
 
 ```typescript
-// GOOD: Prevent unnecessary queries
-const { data } = useQuery(query, { enabled: !!userId }, [userId]);
+// GOOD: Prevent unnecessary queries, and distinguish "disabled" from "loading"
+const { data, loading, enabled } = useQuery(query, { enabled: !!userId }, [userId]);
+if (!enabled) return <EmptyState />;   // `loading` is still true here
+if (loading) return <Spinner />;
 
 // BAD: Query runs even when userId is null
 const { data } = useQuery(query, {}, [userId]);
 ```
 
+Only `useQuery` returns `enabled`. For the other hooks, track the same condition yourself rather
+than relying on `loading` to go false while they are disabled.
+
 ### 3. Provide Type Parameters
 
 ```typescript

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@squidcloud/cli",
-  "version": "1.0.488",
+  "version": "1.0.489",
   "description": "The Squid CLI",
   "main": "dist/index.js",
   "scripts": {
@@ -28,7 +28,7 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@squidcloud/local-backend": "^1.0.488",
+    "@squidcloud/local-backend": "^1.0.489",
     "adm-zip": "^0.5.16",
     "copy-webpack-plugin": "^14.0.0",
     "decompress": "^4.2.1",