@squidcloud/cli 1.0.487 → 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.487","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.487","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/SKILL.md

@@ -21,15 +21,15 @@ Squid is a backend-as-a-service platform that provides:
 
 ## Feature-Specific Guidance
 
-- **[client.md](reference/client.md)** → client SDK, initialization, setup, auth, login, tokens, OAuth, appId, region, environmentId, apiKey, authProvider, getToken, setAuthProvider, Squid client, frontend, collection, executeFunction, executeFunctionWithHeaders, getWebhookUrl, externalAuth, saveAuthCode, getAccessToken, storage, uploadFile, downloadUrl, queues, produce, consume, distributed locks, acquireLock, withLock, web, aiSearch, getUrlContent, createShortUrl, jobs, getJob, awaitJob, observability, metrics, reportMetric, queryMetrics, notifications, publishNotification, observeNotifications
-- **[console.md](reference/console.md)** → Squid Console, web UI, organizations, applications, AI Studio, knowledge bases, integrations, monitoring, logs, API keys, secrets, testing, debugging, profile settings, management API keys
-- **[ai.md](reference/ai.md)** → AI agents, chat, ask, askWithAnnotations, askAsync, askWithVoiceResponse, transcribeAndChat, transcribeAndAsk, knowledge bases, RAG, embeddings, image generation, audio, transcription, text-to-speech, TTS, connectedAgents, connectedIntegrations, connectedKnowledgeBases, @aiFunction, @secureAiAgent, @secureAiQuery, memory, memoryOptions, voiceOptions, OpenAI, Anthropic, Gemini, Grok, DALL-E, Whisper, MCP, @mcpServer, @mcpTool, executeAiQuery, executeAiApiCall, extraction, createPdf, upsert agent, listAgents, spreadsheet understanding, querySpreadsheetsWithAi, searchMode, keyword search, xlsx, csv
+- **[client.md](reference/client.md)** → client SDK, initialization, setup, auth, login, tokens, OAuth, appId, region, environmentId, apiKey, authProvider, getToken, setAuthProvider, Squid client, frontend, collection, executeFunction, executeFunctionWithHeaders, getWebhookUrl, externalAuth, saveAuthCode, getAccessToken, storage, uploadFile, downloadUrl, queues, produce, consume, distributed locks, acquireLock, withLock, web, aiSearch, allowedDomains, getUrlContent, createShortUrl, jobs, getJob, awaitJob, startJob, completeJob, failJob, events, squid.events(), emit, TriggerEvent, LangGraph, squid.langGraph(), invoke, invokeAsync, resume, getState, deleteThread, observability, metrics, reportMetric, queryMetrics, setMetricAnnotations, notifications, publishNotification, observeNotifications
+- **[console.md](reference/console.md)** → Squid Console, web UI, organizations, applications, AI Studio, knowledge bases, knowledge graph toggle, integrations, monitoring, logs, API keys, secrets, testing, debugging, profile settings, management API keys
+- **[ai.md](reference/ai.md)** → AI agents, chat, ask, askWithAnnotations, askAsync, askWithVoiceResponse, transcribeAndChat, transcribeAndAsk, knowledge bases, RAG, embeddings, image generation, audio, transcription, text-to-speech, TTS, connectedAgents, connectedIntegrations, connectedKnowledgeBases, @aiFunction, @secureAiAgent, @secureAiQuery, memory, memoryOptions, metricAnnotations, voiceOptions, OpenAI, Anthropic, Gemini, Grok, DALL-E, Whisper, MCP, @mcpServer, @mcpTool, agent as MCP server, updateMcpServer, generateMcpDescriptions, agent API key, executeAiQuery, executeAiApiCall, extraction, createPdf, upsert agent, listAgents, listChatModels, listFunctions, spreadsheet understanding, querySpreadsheetsWithAi, searchMode, keyword search, xlsx, csv, grep, literal scan, knowledge graph, GraphRAG, graphRag, graph search, queryGraph, getGraphStatus, rebuildGraph, exploreGraph, searchWithGraphContext, graphOptions, graphFilter, underConcept, entityTypes, queryKnowledgeGraph, bulk ingestion, bulkUpsertContexts, createBulkUploadUrls, observeBulkIngestionJob, listContextsPage, generateMetadataFieldDescriptions
 - **[chat-widget.md](reference/chat-widget.md)** → AI chat widget, @squidcloud/react-chat-widget, squid-chat-widget, squid-chat-widget-with-fab-button, embeddable chat, custom API webhook, AI query mode, chain-of-thought, status updates, session management, agentContext, memoryOptions, squid-ai-custom-api-url, squid-ai-agent-chat-options, FAB button, theming, CSS variables, localization, RTL, menu items slots, suggested prompts, voice transcription, error formatting, authentication, squid-auth-provider, onChange events
-- **[databases.md](reference/databases.md)** → collections, documents, queries, subscriptions, snapshots, insert, update, delete, CRUD, real-time, dereference, pagination, transactions, query operators, eq, neq, gt, gte, lt, lte, like, in, nin, arrayIncludesSome, arrayIncludesAll, sortBy, limit, join queries, OR queries, @trigger, native queries, SQL, MongoDB, Elasticsearch, incrementInPath, decrementInPath, watch changes, doc(), projectFields, field projection, __docId__, __id
-- **[backend.md](reference/backend.md)** → SquidService, @executable, @webhook, @trigger, TriggerRequest, @scheduler, @limits, rate limiting, quotas, decorators, backend functions, WebhookRequest, CronExpression, cron, file handling, SquidFile, getUserAuth, isAuthenticated, assertIsAuthenticated, createWebhookResponse, this.squid, this.secrets, @clientConnectionStateHandler, @onQueueMessage, QueueMessageRequest, queue message handler, server-side queue consumer, CLI, squid init, squid start, squid deploy, squid build, project structure, multiple services, service architecture, squidInject, cross-service communication
-- **[security.md](reference/security.md)** → security rules, @secureDatabase, @secureCollection, @secureTopic, @secureStorage, @secureApi, @secureNativeQuery, @secureAiQuery, @secureAiAgent, @secureDistributedLock, @secureGraphQL, QueryContext, MutationContext, isSubqueryOf, affectsPath, permissions, authorization, row-level security, role-based access
-- **[admin.md](reference/admin.md)** → ManagementClient, management API keys, organizations, applications, programmatic management, CI/CD, automation, integrations admin, secrets admin, upsertIntegration, discoverDataConnectionSchema, testDataConnection, createOrganization, createApplication
-- **[api.md](reference/api.md)** → API, REST API, HTTP endpoints, API reference, Agent API, AI Audio API, AI Image API, KnowledgeBase API, Matchmaking API, Web Utilities API, Database API, Extraction API
+- **[databases.md](reference/databases.md)** → collections, documents, queries, subscriptions, snapshots, insert, update, delete, CRUD, real-time, dereference, pagination, transactions, query operators, eq, neq, gt, gte, lt, lte, like, in, nin, arrayIncludesSome, arrayIncludesAll, sortBy, limit, join queries, OR queries, @trigger, native queries, SQL, MongoDB, Elasticsearch, incrementInPath, decrementInPath, watch changes, doc(), docId, docIds, query.delete(), delete by query, projectFields, field projection, __docId__, __id
+- **[backend.md](reference/backend.md)** → SquidService, @executable, @webhook, @trigger, TriggerRequest, @scheduler, @limits, rate limiting, quotas, decorators, backend functions, WebhookRequest, CronExpression, cron, file handling, SquidFile, getUserAuth, isAuthenticated, assertIsAuthenticated, createWebhookResponse, this.squid, getSquid, getPassiveSquid, this.secrets, @clientConnectionStateHandler, @onQueueMessage, QueueMessageRequest, queue message handler, server-side queue consumer, @eventHandler, event handler, workspace, CLI, squid init, squid start, squid deploy, squid build, squid kb-upload, printBundle, project structure, multiple services, service architecture, squidInject, cross-service communication
+- **[security.md](reference/security.md)** → security rules, @secureDatabase, @secureCollection, @publicCollection, public read, @secureTopic, @secureStorage, @secureApi, @secureNativeQuery, @secureAiQuery, @secureAiAgent, @secureLangGraph, @secureDistributedLock, @secureGraphQL, QueryContext, MutationContext, SecureLangGraphContext, isSubqueryOf, affectsPath, permissions, authorization, row-level security, role-based access
+- **[admin.md](reference/admin.md)** → ManagementClient, management API keys, organizations, applications, programmatic management, CI/CD, automation, integrations admin, secrets admin, connectors admin, squid.admin().connectors(), attach connector, appConnectors, upsertIntegration, discoverDataConnectionSchema, testDataConnection, createOrganization, createApplication
+- **[api.md](reference/api.md)** → API, REST API, HTTP endpoints, API reference, Agent API, AiSettings API, AiFunction API, AI Audio API, AI Image API, KnowledgeBase API, Matchmaking API, Web Utilities API, Database API, Extraction API, apiKeyAuth, agentApiKeyAuth, x-squid-agent-api-key, memoryOptions, memoryId, memoryMode
 - **[openai.md](reference/openai.md)** → OpenAI, code interpreter, verbosity, reasoning models, o1, o3, gpt-5, DALL-E, Whisper, TTS, voice options, structured output, file upload
 - **[connectors.md](reference/connectors.md)** → connectors, integrations, IntegrationType, postgres, mongo, auth0, s3, kafka, salesforce, essentials connector, built-in connector, @squidcloud/slack-client, @squidcloud/jira-client, @squidcloud/github-client, @squidcloud/salesforce-client, @squidcloud/freshdesk-client, @squidcloud/linear-client, @squidcloud/mail-client, @squidcloud/google-calendar-client, @squidcloud/google-drive-client, @squidcloud/teams-client, @squidcloud/sharepoint-client, @squidcloud/servicenow_csm-client, @squidcloud/jira-jsm-client, SquidSlackClient, SquidJiraClient, SquidGitHubClient, sendMail, sendMessage, searchIssues, createIssue, connector SDK
 - **Integrations** → See `squid-integrations` skill for full catalog, connector AI functions, SDK methods, and configuration

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

@@ -5,6 +5,7 @@ This document covers programmatic management of Squid organizations, application
 ## Contents
 - ManagementClient
 - Admin Integrations
+- Admin Connectors
 - Admin Secrets
 
 ## ManagementClient
@@ -204,6 +205,35 @@ const openApiSchema = await integrations.discoverOpenApiSchema('my-api', {
 const fileSchema = await integrations.discoverOpenApiSchemaFromFile('my-api');
 ```
 
+### Admin - Connectors
+
+Attach and detach **app-level (integration-less) connectors**. Unlike integrations, these carry no
+per-connector configuration record — attaching one adds it to the application's `appConnectors` list
+and (re)deploys its bundle. Any configuration the connector needs comes in out of band, e.g. via
+application secrets.
+
+```typescript
+const connectors = squid.admin().connectors();
+
+// List the connectors explicitly attached to the app
+const attached = await connectors.list();       // Array<ConnectorId>
+
+// Attach (idempotent - attaching an already-attached connector is a no-op)
+await connectors.connect('slack');
+
+// Detach
+await connectors.disconnect('slack');
+```
+
+`ConnectorId` is one of: `bitbucket`, `confluence`, `cotomi`, `essentials`, `freshdesk`, `github`,
+`google_calendar`, `google_drive`, `hubspot`, `sharepoint`, `jira`, `jira_jsm`, `linear`, `mail`,
+`onedrive`, `outlook`, `salesforce`, `servicenow_csm`, `slack`, `teams`, `ticketmind_companion`,
+`zendesk`.
+
+**Connectors vs integrations:** use `squid.admin().integrations()` when the connection needs
+configuration (credentials, a connection string, an OAuth app). Use `connectors()` for connectors the
+app just needs turned on.
+
 ### Admin - Secrets
 
 ```typescript