@squidcloud/cli 1.0.447 → 1.0.450

package/dist/index.js

@@ -21930,6 +21930,43 @@ module.exports = Array.isArray || function (arr) {
 };
 
 
+/***/ },
+
+/***/ 6102
+(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+
+"use strict";
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   LOG_LEVELS: () => (/* binding */ e),
+/* harmony export */   createDateTimePipe: () => (/* binding */ g),
+/* harmony export */   createJsonPipe: () => (/* binding */ x),
+/* harmony export */   createJsonStringifyPipe: () => (/* binding */ P),
+/* harmony export */   createLogCachePipe: () => (/* binding */ O),
+/* harmony export */   createLogLevelFilterPipe: () => (/* binding */ V),
+/* harmony export */   createLogMessageFilterPipe: () => (/* binding */ N),
+/* harmony export */   createNoopPipe: () => (/* binding */ M),
+/* harmony export */   estimateArgsSizeByStringify: () => (/* binding */ L),
+/* harmony export */   generateUuidSimple: () => (/* binding */ v),
+/* harmony export */   getConsoleOverrides: () => (/* binding */ l),
+/* harmony export */   getDefaultDateTimePipeOptions: () => (/* binding */ f),
+/* harmony export */   getDefaultJsonPipeOptions: () => (/* binding */ h),
+/* harmony export */   getDefaultJsonSimplifierOptions: () => (/* binding */ y),
+/* harmony export */   getDefaultJsonStringifyPipeOptions: () => (/* binding */ S),
+/* harmony export */   getDefaultLogCachePipeOptions: () => (/* binding */ j),
+/* harmony export */   getLogMessageFilterPipeOptions: () => (/* binding */ I),
+/* harmony export */   getOriginalConsoleMethods: () => (/* binding */ u),
+/* harmony export */   installConsoleOverride: () => (/* binding */ o),
+/* harmony export */   installConsoleOverrides: () => (/* binding */ i),
+/* harmony export */   simplifyJson: () => (/* binding */ d),
+/* harmony export */   simplifyValue: () => (/* binding */ b),
+/* harmony export */   uninstallAllConsoleOverrides: () => (/* binding */ c),
+/* harmony export */   uninstallConsoleOverride: () => (/* binding */ s),
+/* harmony export */   uninstallConsoleOverrides: () => (/* binding */ a)
+/* harmony export */ });
+const e=["debug","error","info","log","trace","warn"],t=[],r=()=>{},n={debug:r,error:r,info:r,log:r,trace:r,warn:r};function o(e){i(...Array.isArray(e)?e:[e])}function i(...o){!function(){if(n.debug===r)for(const r of e)n[r]=console[r],console[r]=(...e)=>{var o,i,s;let a=r,c=e;for(const e of t){const t=e(a,...c);if(!t||(Array.isArray(t)?0===(null!==(o=null==t?void 0:t.length)&&void 0!==o?o:0):0===(null!==(s=null===(i=t.args)||void 0===i?void 0:i.length)&&void 0!==s?s:0)))return;Array.isArray(t)?c=t:(a=t.level,c=t.args)}n[a](...c)}}();for(const e of o)!t.includes(e)&&e.onInstall&&e.onInstall(),t.push(e)}function s(e){a(...Array.isArray(e)?e:[e])}function a(...o){for(const e of o)for(let r=t.indexOf(e);r>=0;r=t.indexOf(e)){const e=t.splice(r,1)[0];!t.includes(e)&&e.onUninstall&&e.onUninstall()}!function(){if(!(t.length>0)&&n.debug!==r)for(const t of e)console[t]=n[t],n[t]=r}()}function c(){for(const e of[...t])s(e)}function l(){return[...t]}function u(){if(n.debug!==r)return Object.assign({},n);const t={};for(const r of e)t[r]=console[r];return t}function f(){return{dateFormatter:e=>new Date(e).toISOString()}}function g({dateFormatter:e}=f()){return(t,...r)=>[e(Date.now()),...r]}function y(){return{maxDepthLimit:10,maxArrayLength:100,maxObjectPropertyCount:100,isIgnoredProperty:()=>!1,replacePropertyValue:(e,t)=>t,depthLimitValue:"[Depth limit ~]",arrayLengthLimitValue:"[Array, length: $length ~]",objectPropertyCountLimitValue:"[Object, properties: $count ~]",circularReferenceValue:"[Circular ~]",functionValue:"[Function ~]",symbolValue:"[Symbol ~]"}}const p={maxDepthLimit:10,maxArrayLength:100,maxObjectPropertyCount:100,isIgnoredProperty:()=>!1,replacePropertyValue:(e,t)=>t,depthLimitValue:"[Depth limit ~]",arrayLengthLimitValue:"[Array, length: $length ~]",objectPropertyCountLimitValue:"[Object, properties: $count ~]",circularReferenceValue:"[Circular ~]",functionValue:"[Function ~]",symbolValue:"[Symbol ~]"},m=["cause","message","name","stack"];function d(e,t={},r=0,n=new Set){const o=Object.assign(Object.assign({},p),t);if(r>o.maxDepthLimit)return o.depthLimitValue;if("string"==typeof(e=b(e))||"boolean"==typeof e||"number"==typeof e||null==e)return e;if(n.has(e))return o.circularReferenceValue;if(n.add(e),Array.isArray(e))return e.length>o.maxArrayLength?o.arrayLengthLimitValue.replace("$length",`${e.length}`):e.map((e=>d(e,o,r+1,n)));const i=Object.entries(e);if(i.length>o.maxObjectPropertyCount)return o.objectPropertyCountLimitValue.replace("$count",`${i.length}`);const s={};for(const[e,t]of i)0===r&&o.isIgnoredProperty(e)||(s[e]=d(t,o,r+1,n));for(const t of m)if(!s[t]&&!o.isIgnoredProperty(t)){const i=e[t];void 0!==i&&(s[t]=d(i,o,r+1,n))}if(o.replacePropertyValue!==p.replacePropertyValue)for(const[e,t]of Object.entries(s))s[e]=o.replacePropertyValue(e,t);return s}function b(e,t={}){if(null==e)return e;switch(typeof e){case"undefined":case"boolean":case"string":return e;case"bigint":return`BigInt(${e.toString()})`;case"number":return isNaN(e)?"NaN":e===1/0?"Infinity":e===-1/0?"-Infinity":e;case"function":return t.functionValue||p.functionValue;case"symbol":return t.symbolValue||p.symbolValue;case"object":if(e instanceof Set)return[...e.keys()];if(e instanceof Map)return Object.fromEntries([...e.entries()]);if(e instanceof String||e instanceof Number||e instanceof Boolean)return e.valueOf();if(e instanceof Date)return e.toISOString()}return e}function h(){return Object.assign(Object.assign({},{maxDepthLimit:10,maxArrayLength:100,maxObjectPropertyCount:100,isIgnoredProperty:()=>!1,replacePropertyValue:(e,t)=>t,depthLimitValue:"[Depth limit ~]",arrayLengthLimitValue:"[Array, length: $length ~]",objectPropertyCountLimitValue:"[Object, properties: $count ~]",circularReferenceValue:"[Circular ~]",functionValue:"[Function ~]",symbolValue:"[Symbol ~]"}),{messagePropertyName:"message",levelPropertyName:"level",levelPropertyFormatter:e=>e,timestampPropertyName:"timestamp",timestampPropertyFormatter:e=>new Date(e).toISOString(),messageIdPropertyName:"message_id",messageIdPropertyProvider:v,isIgnoredProperty:()=>!1,getObjectMessageToken:e=>`$${e+1}`,pickFieldNameAsObjectMessageTokenForSingleFieldObjects:!1,undefinedMessageValue:void 0})}function x(e={}){const t=h(),r=Object.assign(Object.assign({},t),e);let n,o="";const i=(e,...i)=>{const s={};let a;s[r.messagePropertyName]=void 0;let c=0;for(let e=0;e<i.length;e++){const t=b(i[e]);let n=t;if("object"==typeof t&&null!==t){let o=d(t,r);if(r.pickFieldNameAsObjectMessageTokenForSingleFieldObjects&&"object"==typeof o&&null!==o){const e=Object.entries(o);if(1===e.length){const[t,r]=e[0],i=`$${t}`;if(void 0===s[i])if(n=i,null===(l=r)||"string"==typeof l||void 0===l||"number"==typeof l||"boolean"==typeof l){const e="string"==typeof r?"'":"";n+=`:[${e}${r}${e}]`,o=void 0}else o=r}}"string"!=typeof n&&(n=r.getObjectMessageToken(c,t,e),c++),s[n]=o}else void 0===t?void 0!==r.undefinedMessageValue&&(n+=r.undefinedMessageValue):n=t;a=void 0===a?`${n}`:`${a} ${n}`}var l;if(a&&(s[r.messagePropertyName]=a),r.levelPropertyName&&(s[r.levelPropertyName]=r.levelPropertyFormatter(e)),r.timestampPropertyName&&(s[r.timestampPropertyName]=r.timestampPropertyFormatter(Date.now())),r.messageIdPropertyName){let a=n||r.messageIdPropertyProvider(e,...i);void 0===a&&(a=t.messageIdPropertyProvider()),o=a,s[r.messageIdPropertyName]=o,n=void 0}return[s]};return i.getLastMessageId=()=>o,i.setNextMessageId=e=>{n=e},i}function v(){let e=Date.now();return"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,(t=>{const r=(e+Math.floor(16*Math.random()))%16;return e=Math.floor(e/16),("x"===t?r:3&r|8).toString(16)}))}function S(){return Object.assign(Object.assign({},h()),{preStringifyCallback:()=>{}})}function P(e={}){const t=Object.assign(Object.assign({},S()),e),r=x(t),n=(e,...n)=>{const o=r(e,...n);if(0===o.length)return[];const i=o[0];return t.preStringifyCallback(i),[JSON.stringify(i)]};return n.getLastMessageId=r.getLastMessageId,n.setNextMessageId=r.setNextMessageId,n}function j(){return{cacheSize:1e3,cacheSizeByStringify:-1}}function O(e={}){const t=Object.assign(Object.assign({},{cacheSize:1e3,cacheSizeByStringify:-1}),e);if(t.cacheSize<0||isNaN(t.cacheSize))throw new Error(`Invalid cache size: ${t.cacheSize}`);const r={size:0};let n=!1,o=0;function i(){r.first&&(o>0&&(o-=L(...r.first.value.args)),r.first=r.first.next,r.size--)}const s=(e,...a)=>{if(0===t.cacheSize||n)return a;var c;c={value:{level:e,args:a,timestamp:Date.now()}},void 0===r.last?r.first=c:r.last.next=c,r.last=c,r.size++,t.cacheSizeByStringify>=0&&(o+=L(...c.value.args));const l=r.size>t.cacheSize,u=t.cacheSizeByStringify>=0&&o>t.cacheSizeByStringify;if((l||u)&&t.onCacheSizeReached){n=!0;try{t.onCacheSizeReached(s)}finally{n=!1}}if(u){for(;o>t.cacheSizeByStringify&&void 0!==r.first;)i();o=Math.max(o,0),void 0===r.first&&(o=0)}else l&&i();return a};return s.getMessages=()=>{const e=[];let t=r.first;for(;void 0!==t;)e.push(t.value),t=t.next;return e},s.clearMessages=()=>{r.first=void 0,r.last=void 0,r.size=0,o=0},s.onInstall=()=>s.clearMessages(),s}function L(...e){let t=0;for(const r of e)void 0!==r&&(t+=JSON.stringify(d(r)).length);return t}function V(e={}){const t=Object.assign({excludedLogLevels:[]},e);return(e,...r)=>{const n="function"==typeof t.excludedLogLevels?t.excludedLogLevels(e):t.excludedLogLevels;return("boolean"==typeof n?n:n.includes(e))?[]:r}}function I(){return{isCaseSensitive:!1,excludedMessageTokens:[]}}function N(e){const{excludedMessageTokens:t,isCaseSensitive:r}=Object.assign(Object.assign({},{isCaseSensitive:!1,excludedMessageTokens:[]}),e),n=t.filter((e=>"string"==typeof e)).map((e=>r?e:e.toLowerCase())),o=t.filter((e=>"object"==typeof e));return t.sort(((e,t)=>typeof e==typeof t?0:"string"==typeof e?-1:1)),(e,...i)=>{if(0===t.length)return i;if(r){for(const e of i)if("string"==typeof e){if(n.some((t=>e.includes(t))))return[];if(o.some((t=>t.test(e))))return[]}}else for(const e of i)if("string"==typeof e){const t=e.toLowerCase();if(n.some((e=>t.includes(e))))return[];if(o.some((t=>t.test(e))))return[]}return i}}function M(){return(e,...t)=>t}
+//# sourceMappingURL=index.esm.js.map
+
 /***/ },
 
 /***/ 2577
@@ -29619,6 +29656,7 @@ Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.OPEN_AI_CREATE_SPEECH_FORMATS = exports.AI_AUDIO_CREATE_SPEECH_MODEL_NAMES = exports.AI_AUDIO_TRANSCRIPTION_MODEL_NAMES = exports.AI_IMAGE_MODEL_NAMES = exports.FLUX_MODEL_NAMES = exports.STABLE_DIFFUSION_MODEL_NAMES = exports.OPENAI_AUDIO_MODEL_NAMES = exports.OPENAI_AUDIO_CREATE_SPEECH_MODEL_NAMES = exports.OPENAI_AUDIO_TRANSCRIPTION_MODEL_NAMES = exports.OPENAI_IMAGE_MODEL_NAMES = exports.AI_EMBEDDINGS_MODEL_NAMES = exports.BEDROCK_EMBEDDING_MODEL_NAMES = exports.VOYAGE_EMBEDDING_MODEL_NAMES = exports.OPENAI_EMBEDDINGS_MODEL_NAMES = exports.VENDOR_AI_CHAT_MODEL_NAMES = exports.ANTHROPIC_CHAT_MODEL_NAMES = exports.GROK_CHAT_MODEL_NAMES = exports.GEMINI_CHAT_MODEL_NAMES = exports.OPENAI_CHAT_MODEL_NAMES = exports.AI_PROVIDER_TYPES = exports.RERANK_PROVIDERS = void 0;
 exports.isVendorAiChatModelName = isVendorAiChatModelName;
 exports.isAiEmbeddingsModelName = isAiEmbeddingsModelName;
+exports.isIntegrationEmbeddingModelSpec = isIntegrationEmbeddingModelSpec;
 exports.isIntegrationModelSpec = isIntegrationModelSpec;
 /**
  * @category AI
@@ -29705,6 +29743,13 @@ exports.AI_EMBEDDINGS_MODEL_NAMES = [
 function isAiEmbeddingsModelName(modelName) {
     return exports.AI_EMBEDDINGS_MODEL_NAMES.includes(modelName);
 }
+/**
+ * Type guard for `IntegrationEmbeddingModelSpec`.
+ * @category AI
+ */
+function isIntegrationEmbeddingModelSpec(model) {
+    return (typeof model === 'object' && model !== null && 'integrationId' in model && 'model' in model && 'dimensions' in model);
+}
 /**
  * The supported AI image generation model names.
  * @category AI
@@ -29856,6 +29901,7 @@ exports.INTEGRATION_TYPES = [
     'legend',
     'teams',
     'openai_compatible',
+    'openai_compatible_embedding',
 ];
 /**
  * @category Database
@@ -30183,6 +30229,152 @@ exports.applicationAppConnectorsAssertion = {
 };
 
 
+/***/ },
+
+/***/ 8700
+(__unused_webpack_module, exports, __webpack_require__) {
+
+"use strict";
+
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.debugLogFilterPipe = void 0;
+const logpipes_1 = __webpack_require__(6102);
+const enable_debug_logs_decorator_1 = __webpack_require__(5692);
+const global_utils_1 = __webpack_require__(6334);
+exports.debugLogFilterPipe = (0, logpipes_1.createLogLevelFilterPipe)({
+    excludedLogLevels: level => {
+        if (level !== 'debug')
+            return false;
+        if ((0, global_utils_1.isDebugEnabled)())
+            return false; // Debug is enabled globally.
+        return !(0, enable_debug_logs_decorator_1.isInDebugDecoratorContext)(); // Check if debug is enabled only for this nested call.
+    },
+});
+
+
+/***/ },
+
+/***/ 5692
+(__unused_webpack_module, exports, __webpack_require__) {
+
+"use strict";
+
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.EnableDebugLogs = EnableDebugLogs;
+exports.isInDebugDecoratorContext = isInDebugDecoratorContext;
+const async_hooks_1 = __webpack_require__(290);
+const store = new async_hooks_1.AsyncLocalStorage();
+/**
+ * Method decorator that enables debug logs only within the async context of the decorated method call.
+ * This allows debug logging to be scoped to specific method executions without affecting global debug settings.
+ * Works by making isInDebugContext() return true within the decorated context.
+ *
+ * Note: the decoration works only in Node.js.
+ */
+function EnableDebugLogs(_target, _propertyName, descriptor) {
+    const method = descriptor.value;
+    descriptor.value = async function (...args) {
+        // Run the method within the debug context.
+        return store.run(true, async () => {
+            return await method.apply(this, args);
+        });
+    };
+    return descriptor;
+}
+/** Returns true if called from within debug log enabled context. */
+function isInDebugDecoratorContext() {
+    return store.getStore() === true;
+}
+
+
+/***/ },
+
+/***/ 6334
+(__unused_webpack_module, exports) {
+
+"use strict";
+
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.DebugLogger = void 0;
+exports.getGlobal = getGlobal;
+exports.isDebugEnabled = isDebugEnabled;
+exports.enableDebugLogs = enableDebugLogs;
+exports.disableTimestampsInLog = disableTimestampsInLog;
+/** @internal */
+function getGlobal() {
+    if (typeof window !== 'undefined') {
+        return window; // Browser environment.
+    }
+    if (typeof global !== 'undefined') {
+        return global; // Node.js environment.
+    }
+    if (typeof self !== 'undefined') {
+        return self; // Web Worker environment.
+    }
+    throw new Error('Unable to locate global object');
+}
+/** @internal */
+function isDebugEnabled() {
+    const globalObj = getGlobal();
+    return globalObj?.['SQUID_LOG_DEBUG_ENABLED'] === true;
+}
+/** @internal */
+function enableDebugLogs(isEnabled = true) {
+    const globalObj = getGlobal();
+    globalObj['SQUID_LOG_DEBUG_ENABLED'] = isEnabled;
+}
+function isSquidDebugEnabledByDefault() {
+    let param = '';
+    if (typeof window !== 'undefined' && window.location) {
+        const searchParams = new URLSearchParams(window.location.search);
+        param = searchParams.get('SQUID_DEBUG') || '';
+    }
+    else if (typeof process !== 'undefined' && process.env) {
+        param = process.env['SQUID_DEBUG'] || '';
+    }
+    return param === '1' || param === 'true';
+}
+// Auto-initialize debug flag only if not explicitly set already.
+// This prevents bundled code from overriding the flag set by the host application.
+if (getGlobal()?.['SQUID_LOG_DEBUG_ENABLED'] === undefined) {
+    enableDebugLogs(isSquidDebugEnabledByDefault());
+}
+/** @internal */
+function disableTimestampsInLog() {
+    const globalObj = getGlobal();
+    globalObj['SQUID_LOG_TIMESTAMPS_DISABLED'] = true;
+}
+function isTimestampsEnabled() {
+    const globalObj = getGlobal();
+    return globalObj?.['SQUID_LOG_TIMESTAMPS_DISABLED'] !== true;
+}
+/**
+ * This class is used by the @squidcloud/client code.
+ * We can’t override console.debug() with "logpipes" as we do for the core or tenant
+ * because @squidcloud/client code is run in user environment.
+ * Therefore, when we want to log anything from the client code, we use this logger.
+ *
+ * @internal.
+ */
+class DebugLogger {
+    static debug(...args) {
+        if (!isDebugEnabled())
+            return;
+        console.debug(`${getLogPrefixString()} DEBUG`, ...args);
+    }
+}
+exports.DebugLogger = DebugLogger;
+function getLogPrefixString() {
+    if (isTimestampsEnabled()) {
+        const date = new Date();
+        return `[${date.toLocaleTimeString()}.${date.getMilliseconds()}] squid`;
+    }
+    else {
+        return 'squid';
+    }
+}
+
+
 /***/ },
 
 /***/ 866
@@ -30266,6 +30458,38 @@ function isIOS(regionPrefix) {
 }
 
 
+/***/ },
+
+/***/ 9590
+(__unused_webpack_module, exports, __webpack_require__) {
+
+"use strict";
+
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.timeSince = timeSince;
+exports.timePeriod = timePeriod;
+/*** The file contains logging helper methods. Used to reduce boilerplate code in logging functions. */
+const time_units_1 = __webpack_require__(1929);
+/**
+ * Returns a formatted time duration string for the period from Date.now() to `startDate`.
+ * Example "in 12s".
+ * */
+function timeSince(startTime, prefix) {
+    return timePeriod(Date.now() - startTime, prefix);
+}
+/**
+ * Returns a formatted of duration of the `periodInMillis`.
+ * Example "in 12s".
+ * */
+function timePeriod(periodInMillis, prefix) {
+    prefix = prefix === undefined ? 'time: ' : prefix;
+    if (periodInMillis < time_units_1.MILLIS_PER_SECOND) {
+        return `${prefix}${periodInMillis}ms`;
+    }
+    return `${prefix}${periodInMillis / time_units_1.MILLIS_PER_SECOND}s`;
+}
+
+
 /***/ },
 
 /***/ 3563
@@ -31010,17 +31234,22 @@ const adm_zip_1 = __importDefault(__webpack_require__(8023));
 const assertic_1 = __webpack_require__(3205);
 const fsSync = __importStar(__webpack_require__(9896));
 const fs_1 = __webpack_require__(9896);
+const logpipes_1 = __webpack_require__(6102);
 const module_1 = __webpack_require__(3339);
 const node_child_process_1 = __webpack_require__(1421);
 const path_1 = __importDefault(__webpack_require__(6928));
 const webpack_1 = __importDefault(__webpack_require__(6807));
 const connector_types_1 = __webpack_require__(3420);
 const assertion_utils_1 = __webpack_require__(6883);
+const enable_debug_decorator_utils_1 = __webpack_require__(8700);
+const global_utils_1 = __webpack_require__(6334);
+const log_utils_1 = __webpack_require__(9590);
 const openapi_utils_1 = __webpack_require__(3563);
 const process_env_utils_1 = __webpack_require__(9360);
 const resolve_1 = __webpack_require__(412);
 const tsoa_utils_1 = __webpack_require__(1431);
 const packageJson = __importStar(__webpack_require__(8330));
+const update_skills_1 = __webpack_require__(7286);
 const logging_1 = __webpack_require__(443);
 const process_utils_1 = __webpack_require__(8251);
 const resolve_2 = __webpack_require__(3878);
@@ -31032,18 +31261,11 @@ const version_check_1 = __webpack_require__(4827);
 // - Default: colors only if TTY (stdout is a terminal).
 const isTerminal = process.stdout.isTTY;
 const useColorsInOutput = (0, process_env_utils_1.isEnvVarTruthy)('FORCE_COLOR') || (!(0, process_env_utils_1.isEnvVarTruthy)('NO_COLOR') && isTerminal);
-async function displayVersionWarning(versionCheckPromise) {
-    try {
-        const versionWarning = await versionCheckPromise;
-        if (versionWarning) {
-            console.warn(versionWarning);
-        }
-    }
-    catch (_ignored) { }
-}
 async function build({ verbose, dev, skipVersionCheck }) {
-    if (verbose)
-        console.log(`Starting Squid project build. CLI package version: ${packageJson.version}`);
+    const buildPhaseStart = Date.now();
+    (0, global_utils_1.enableDebugLogs)(verbose || (0, global_utils_1.isDebugEnabled)());
+    (0, logpipes_1.installConsoleOverrides)(enable_debug_decorator_utils_1.debugLogFilterPipe);
+    console.debug(`Starting Squid project build. CLI package version: ${packageJson.version}`);
     await (0, validate_1.validateSquidProject)();
     // Start version checks in the background if not disabled.
     const shouldSkipVersionCheck = skipVersionCheck || (0, process_env_utils_1.isEnvVarTruthy)('SQUID_SKIP_BUILD_TIME_VERSION_CHECK');
@@ -31052,27 +31274,29 @@ async function build({ verbose, dev, skipVersionCheck }) {
     const versionCheckPromise = shouldSkipVersionCheck ? Promise.resolve(undefined) : (0, version_check_1.checkCliVersion)(currentVersion);
     const distPath = path_1.default.resolve(process.cwd(), 'dist');
     if (fsSync.existsSync(distPath)) {
-        if (verbose)
-            console.log(`Cleaning existing dist dir before the build: ${distPath}`);
+        console.debug(`Cleaning existing dist dir before the build: ${distPath}`);
         await fs_1.promises.rm(distPath, { recursive: true, force: true });
     }
     await fs_1.promises.mkdir(distPath);
     const isSquidConnector = (0, process_env_utils_1.isEnvVarTruthy)('SQUID_CONNECTOR');
+    const specsStart = Date.now();
     const openApiSpecAndControllers = await tsoa_utils_1.TsoaUtils.generateAllSpecs(verbose, !isSquidConnector);
+    console.debug((0, log_utils_1.timeSince)(specsStart, 'OpenAPI specs generation time '));
     await fs_1.promises.writeFile(path_1.default.join(distPath, '', 'openapi-spec-and-controllers.json'), JSON.stringify(openApiSpecAndControllers));
     const isUserConfigMode = fsSync.existsSync(resolve_2.USER_WEBPACK_CONFIG_PATH);
     const webpackConfigPath = isUserConfigMode ? resolve_2.USER_WEBPACK_CONFIG_PATH : resolve_2.BUILT_IN_WEBPACK_CONFIG_PATH;
-    if (verbose)
-        console.log(`Using webpack config from ${webpackConfigPath}`);
+    console.debug(`Using webpack config from ${webpackConfigPath}`);
     const localConfig = (0, resolve_1.requirePath)(webpackConfigPath);
     const mode = dev ? 'development' : 'production';
     const webpackConfig = localConfig(undefined, { mode });
     webpackConfig.mode = webpackConfig.mode || mode;
     try {
         console.log((0, logging_1.primary)('Building...'));
+        const webpackStart = Date.now();
         await new Promise((resolve, reject) => {
             (0, webpack_1.default)(webpackConfig, (err, stats) => {
                 if (err) {
+                    console.debug((0, log_utils_1.timeSince)(webpackStart, 'Webpack build time '));
                     console.error('Build failed a fatal error.');
                     return reject(err);
                 }
@@ -31089,34 +31313,40 @@ async function build({ verbose, dev, skipVersionCheck }) {
                     }));
                 }
                 if (stats?.hasErrors()) {
+                    console.debug((0, log_utils_1.timeSince)(webpackStart, 'Webpack build time '));
                     return reject(new Error('Build failed with errors.'));
                 }
+                console.debug((0, log_utils_1.timeSince)(webpackStart, 'Webpack build time '));
                 console.log('Build succeeded.');
                 resolve();
             });
         });
         // Generate connector metadata if this is a connector build.
         if (isSquidConnector) {
-            if (verbose)
-                console.log('Generating connector metadata...');
-            await generateConnectorMetadata(distPath, verbose);
+            console.debug('Generating connector metadata...');
+            const metadataStart = Date.now();
+            await generateConnectorMetadata(distPath);
+            console.debug((0, log_utils_1.timeSince)(metadataStart, 'Connector metadata generation time '));
             // Add metadata to bundle.zip.
+            const metadataBundleStart = Date.now();
             const zipPath = path_1.default.join(distPath, 'bundle.zip');
             const zip = new adm_zip_1.default(zipPath);
             zip.addLocalFile(path_1.default.join(distPath, connector_types_1.CONNECTOR_METADATA_JSON_FILE));
             zip.writeZip(zipPath);
-            if (verbose)
-                console.log('Added connector metadata to bundle.zip');
+            console.debug('Added connector metadata to bundle.zip');
+            console.debug((0, log_utils_1.timeSince)(metadataBundleStart, 'Connector metadata bundling time '));
         }
         // Show version check warning after successful build.
-        await displayVersionWarning(versionCheckPromise);
+        await (0, version_check_1.displayVersionWarningIfOutdated)(versionCheckPromise);
+        (0, update_skills_1.displaySkillsWarningIfOutdated)();
+        console.debug((0, log_utils_1.timeSince)(buildPhaseStart, 'Build time '));
     }
     catch (e) {
         // Show a version check warning even if the build failed.
-        await displayVersionWarning(versionCheckPromise);
+        await (0, version_check_1.displayVersionWarningIfOutdated)(versionCheckPromise);
+        (0, update_skills_1.displaySkillsWarningIfOutdated)();
         const errorMessage = (0, assertic_1.getMessageFromError)(e);
-        if (verbose)
-            console.log(`Exiting with error: ${errorMessage}`);
+        console.debug(`Exiting with error: ${errorMessage}`);
         (0, process_utils_1.exitWithError)(errorMessage);
     }
 }
@@ -31125,7 +31355,7 @@ async function build({ verbose, dev, skipVersionCheck }) {
  */
 const INTEGRATIONLESS_CONNECTORS = ['cotomi'];
 /** Generates connector metadata JSON file in the dist directory. */
-async function generateConnectorMetadata(distPath, verbose) {
+async function generateConnectorMetadata(distPath) {
     const packageJsonPath = path_1.default.resolve(process.cwd(), 'package.json');
     const packageJson = JSON.parse(await fs_1.promises.readFile(packageJsonPath, 'utf8'));
     (0, assertic_1.assertTruthy)(packageJson.version, 'Failed to read version from package.json');
@@ -31148,8 +31378,7 @@ async function generateConnectorMetadata(distPath, verbose) {
     (0, assertic_1.assertTruthy)(typeof bundleData === 'object', `Unexpected "default:metadata" function response: ${typeof bundleData}`);
     // Populate openApiControllersMap from openapi-spec-and-controllers.json.
     await (0, openapi_utils_1.populateOpenApiControllersMap)(bundleData, distPath, 'connector');
-    if (verbose)
-        console.log('Populated openApiControllersMap in bundle metadata');
+    console.debug('Populated openApiControllersMap in bundle metadata');
     const integrationTypes = INTEGRATIONLESS_CONNECTORS.includes(connectorId)
         ? []
         : buildSupportedIntegrationTypesFromBundleData(bundleData);
@@ -31161,10 +31390,7 @@ async function generateConnectorMetadata(distPath, verbose) {
     };
     const metadataPath = path_1.default.join(distPath, connector_types_1.CONNECTOR_METADATA_JSON_FILE);
     await fs_1.promises.writeFile(metadataPath, JSON.stringify(packageMetadata, null, 2));
-    if (verbose) {
-        console.log('Connector metadata generated successfully:');
-        console.dir(packageMetadata, { depth: 2, colors: true });
-    }
+    console.debug('Connector metadata generated successfully:', packageMetadata);
 }
 /** Returns a list of supported integration types. Checks AI function attributes for that. */
 function buildSupportedIntegrationTypesFromBundleData(bundleData) {
@@ -31220,12 +31446,20 @@ Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.deploy = deploy;
 const assertic_1 = __webpack_require__(3205);
 const fs = __importStar(__webpack_require__(1943));
+const logpipes_1 = __webpack_require__(6102);
 const communication_types_1 = __webpack_require__(3443);
+const enable_debug_decorator_utils_1 = __webpack_require__(8700);
+const global_utils_1 = __webpack_require__(6334);
 const http_1 = __webpack_require__(866);
 const shell_runner_1 = __webpack_require__(3089);
+const packageJson = __importStar(__webpack_require__(8330));
 const environment_1 = __webpack_require__(722);
 const process_utils_1 = __webpack_require__(8251);
+const version_check_1 = __webpack_require__(4827);
 async function deploy(consoleRegion, appId, bundlePath, apiKey, verbose, direct, isUserSpecifiedPath, skipBuild, internalApiKey, environmentId) {
+    (0, global_utils_1.enableDebugLogs)(verbose || (0, global_utils_1.isDebugEnabled)());
+    (0, logpipes_1.installConsoleOverrides)(enable_debug_decorator_utils_1.debugLogFilterPipe);
+    const versionCheckPromise = (0, version_check_1.checkCliVersion)(packageJson.version);
     if (!direct && !isUserSpecifiedPath && !skipBuild) {
         console.log('Building code bundle...');
         await (0, shell_runner_1.runInShell)('npm run build');
@@ -31240,9 +31474,7 @@ async function deploy(consoleRegion, appId, bundlePath, apiKey, verbose, direct,
         ? (0, http_1.getApplicationUrl)(consoleRegion, appIdWithEnvId, 'application/updateApplicationCode')
         : (0, http_1.getApplicationUrl)(consoleRegion, environment_1.environment.consoleAppId, 'webhooks/updateApplicationCode');
     console.log(`Deploying code bundle for appId '${appId}' to the '${environmentId}' environment...`);
-    if (verbose) {
-        console.log('Deploying bundle to:', updateCodeUrl);
-    }
+    console.debug('Deploying bundle to:', updateCodeUrl);
     try {
         const headers = new Headers();
         if (apiKey) {
@@ -31257,11 +31489,11 @@ async function deploy(consoleRegion, appId, bundlePath, apiKey, verbose, direct,
             (0, process_utils_1.exitWithError)('Unable to deploy bundle:', await response.text());
         }
         console.log('Code deployed');
+        await (0, version_check_1.displayVersionWarningIfOutdated)(versionCheckPromise);
     }
     catch (error) {
-        if (verbose) {
-            console.error('VERBOSE: error deploying bundle:', error);
-        }
+        await (0, version_check_1.displayVersionWarningIfOutdated)(versionCheckPromise);
+        console.debug('Error deploying bundle:', error);
         const errorMessage = (0, assertic_1.getMessageFromError)(error, '');
         (0, process_utils_1.exitWithError)('Unable to deploy bundle:', errorMessage || error);
     }
@@ -31472,6 +31704,7 @@ const init_webpack_1 = __webpack_require__(1134);
 const sample_1 = __webpack_require__(4328);
 const start_1 = __webpack_require__(496);
 const undeploy_1 = __webpack_require__(7097);
+const update_skills_1 = __webpack_require__(7286);
 const process_utils_1 = __webpack_require__(8251);
 const validate_1 = __webpack_require__(2246);
 function setupDotEnv(baseDir) {
@@ -31496,6 +31729,7 @@ function run() {
     setupInitWebpackCommand(yargs_1.default);
     setupStartCommand(yargs_1.default);
     setupUndeployCommand(yargs_1.default);
+    setupUpdateSkillsCommand(yargs_1.default);
     yargs_1.default.parse();
 }
 function setupStartCommand(yargs) {
@@ -31626,6 +31860,11 @@ function setupBuildCommand(yargs) {
         await (0, build_1.build)({ verbose: !!argv.verbose, dev: !!argv.dev, skipVersionCheck: !!argv['skip-version-check'] });
     });
 }
+function setupUpdateSkillsCommand(yargs) {
+    yargs.command('update-skills', 'Updates Squid Claude skills to the latest version', () => { }, async () => {
+        await (0, update_skills_1.updateSkills)();
+    });
+}
 run();
 function attachAppIdOption(yargs, demandOption) {
     yargs.option('appId', {
@@ -31755,6 +31994,39 @@ function getConsoleRegionFromAppRegion(appRegion) {
 
 "use strict";
 
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -31762,16 +32034,25 @@ Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.initSample = initSample;
 const assertic_1 = __webpack_require__(3205);
 const promises_1 = __importDefault(__webpack_require__(1943));
+const logpipes_1 = __webpack_require__(6102);
 const path_1 = __importDefault(__webpack_require__(6928));
 const communication_types_1 = __webpack_require__(3443);
 const utils_1 = __webpack_require__(1215);
+const enable_debug_decorator_utils_1 = __webpack_require__(8700);
+const global_utils_1 = __webpack_require__(6334);
 const shell_runner_1 = __webpack_require__(3089);
+const packageJson = __importStar(__webpack_require__(8330));
+const update_skills_1 = __webpack_require__(7286);
 const git_utils_1 = __webpack_require__(954);
 const logging_1 = __webpack_require__(443);
 const process_utils_1 = __webpack_require__(8251);
 const report_utils_1 = __webpack_require__(3066);
+const version_check_1 = __webpack_require__(4827);
 const ORG = 'squid-cloud-samples';
 async function initSample(consoleRegion, isOnPremConsole, dirPath, appId, apiKey, environmentId, squidDeveloperId, region, templateName, verbose = false) {
+    (0, global_utils_1.enableDebugLogs)(verbose || (0, global_utils_1.isDebugEnabled)());
+    (0, logpipes_1.installConsoleOverrides)(enable_debug_decorator_utils_1.debugLogFilterPipe);
+    const versionCheckPromise = (0, version_check_1.checkCliVersion)(packageJson.version);
     try {
         await promises_1.default.stat(path_1.default.resolve(dirPath));
         (0, process_utils_1.exitWithError)(`Project already exists: ${dirPath}`);
@@ -31791,42 +32072,25 @@ async function initSample(consoleRegion, isOnPremConsole, dirPath, appId, apiKey
     catch {
         (0, process_utils_1.exitWithError)(`Unable to download repository: ${templateRepoPath}`);
     }
-    // Copy the squid-development and squid-react-development skills if they do not already exist.
+    // Copy Squid skills if they don't already exist.
     const projectPath = path_1.default.resolve(dirPath);
     const skillsDir = path_1.default.join(projectPath, '.claude', 'skills');
-    const squidSkillSourcePath = path_1.default.join(__dirname, 'resources', 'claude', 'skills', 'squid-development');
-    const squidSkillDestPath = path_1.default.join(skillsDir, 'squid-development');
-    if (await (0, utils_1.checkFileOrDirExists)(squidSkillDestPath)) {
-        console.debug('Squid development skill already exists, skipping...');
-    }
-    else {
-        // Skill doesn't exist, copy it.
-        try {
-            await promises_1.default.mkdir(skillsDir, { recursive: true });
-            await promises_1.default.cp(squidSkillSourcePath, squidSkillDestPath, { recursive: true });
-            console.debug('Squid development skill copied successfully');
+    for (const skillName of update_skills_1.SQUID_SKILLS) {
+        const sourcePath = path_1.default.join(__dirname, 'resources', 'claude', 'skills', skillName);
+        const destPath = path_1.default.join(skillsDir, skillName);
+        if (await (0, utils_1.checkFileOrDirExists)(destPath)) {
+            console.debug(`${skillName} skill already exists, skipping...`);
         }
-        catch (error) {
-            // Non-fatal: log the error but continue with initialization.
-            console.debug(`Warning: Could not copy Squid development skill: ${(0, assertic_1.getMessageFromError)(error)}`);
-        }
-    }
-    // Copy the squid-react-development skill if it doesn't already exist.
-    const reactSkillSourcePath = path_1.default.join(__dirname, 'resources', 'claude', 'skills', 'squid-react-development');
-    const reactSkillDestPath = path_1.default.join(skillsDir, 'squid-react-development');
-    if (await (0, utils_1.checkFileOrDirExists)(reactSkillDestPath)) {
-        console.debug('Squid React development skill already exists, skipping...');
-    }
-    else {
-        // Skill doesn't exist, copy it.
-        try {
-            await promises_1.default.mkdir(skillsDir, { recursive: true });
-            await promises_1.default.cp(reactSkillSourcePath, reactSkillDestPath, { recursive: true });
-            console.debug('Squid React development skill copied successfully');
-        }
-        catch (error) {
-            // Non-fatal: log the error but continue with initialization.
-            console.debug(`Warning: Could not copy Squid React development skill: ${(0, assertic_1.getMessageFromError)(error)}`);
+        else {
+            try {
+                await promises_1.default.mkdir(skillsDir, { recursive: true });
+                await promises_1.default.cp(sourcePath, destPath, { recursive: true });
+                console.debug(`${skillName} skill copied successfully`);
+            }
+            catch (error) {
+                // Non-fatal: log the error but continue with initialization.
+                console.debug(`Warning: Could not copy ${skillName} skill: ${(0, assertic_1.getMessageFromError)(error)}`);
+            }
         }
     }
     console.log('Installing dependencies...');
@@ -31875,7 +32139,7 @@ ${(0, logging_1.primary)('Done. Now run:')}
   cd ${dirPath}
   npm run start
 `);
-        await (0, report_utils_1.reportLocalBackendInitialized)(consoleRegion, (0, communication_types_1.appIdWithEnvironmentIdAndDevId)(appId, environmentId, squidDeveloperId), apiKey, verbose);
+        await (0, report_utils_1.reportLocalBackendInitialized)(consoleRegion, (0, communication_types_1.appIdWithEnvironmentIdAndDevId)(appId, environmentId, squidDeveloperId), apiKey);
     }
     else {
         console.log((0, logging_1.link)('https://console.getsquid.ai'));
@@ -31889,6 +32153,7 @@ ${(0, logging_1.primary)('Done. Next steps:')}
   npm run start
 `);
     }
+    await (0, version_check_1.displayVersionWarningIfOutdated)(versionCheckPromise);
 }
 
 
@@ -31941,12 +32206,18 @@ const fs = __importStar(__webpack_require__(1943));
 const path_1 = __importDefault(__webpack_require__(6928));
 const resolve_1 = __webpack_require__(412);
 const shell_runner_1 = __webpack_require__(3089);
+const cliPackageJson = __importStar(__webpack_require__(8330));
+const update_skills_1 = __webpack_require__(7286);
 const logging_1 = __webpack_require__(443);
 const process_utils_1 = __webpack_require__(8251);
 const validate_1 = __webpack_require__(2246);
+const version_check_1 = __webpack_require__(4827);
 async function start() {
     const packageJson = await (0, validate_1.validateSquidProject)();
+    const versionCheckPromise = (0, version_check_1.checkCliVersion)(cliPackageJson.version);
     console.log((0, logging_1.primary)('Please note:'), 'to debug your application, you need to run the "start" npm script in your IDE in debug mode');
+    await (0, version_check_1.displayVersionWarningIfOutdated)(versionCheckPromise);
+    (0, update_skills_1.displaySkillsWarningIfOutdated)();
     console.log((0, logging_1.primary)('Starting...'));
     const modulePath = await (0, resolve_1.findModulePath)('@squidcloud/local-backend');
     if (!modulePath) {
@@ -32027,6 +32298,149 @@ async function undeploy(consoleRegion, appId, apiKey, environmentId) {
 }
 
 
+/***/ },
+
+/***/ 7286
+(__unused_webpack_module, exports, __webpack_require__) {
+
+"use strict";
+
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.SQUID_SKILLS = void 0;
+exports.getSkillsNeedingUpdate = getSkillsNeedingUpdate;
+exports.displaySkillsWarningIfOutdated = displaySkillsWarningIfOutdated;
+exports.updateSkills = updateSkills;
+const chalk_1 = __importDefault(__webpack_require__(7459));
+const fsSync = __importStar(__webpack_require__(9896));
+const fs = __importStar(__webpack_require__(1943));
+const path_1 = __importDefault(__webpack_require__(6928));
+const logging_1 = __webpack_require__(443);
+const validate_1 = __webpack_require__(2246);
+/** List of Squid-owned skills that can be copied/updated. */
+exports.SQUID_SKILLS = ['squid-development', 'squid-react-development'];
+/**
+ * Gets all files in a directory, sorted for consistent ordering.
+ */
+function getFilesSorted(dir) {
+    const files = fsSync.readdirSync(dir, { recursive: true });
+    return files.filter(file => fsSync.statSync(path_1.default.join(dir, file)).isFile()).sort();
+}
+/**
+ * Checks if a specific skill needs to be updated.
+ * Returns true if project is missing skill or any CLI file is missing/different.
+ * Extra files in project are ignored
+ */
+function skillNeedsUpdate(skillName) {
+    const projectSkillPath = path_1.default.join(process.cwd(), '.claude', 'skills', skillName);
+    const cliSkillPath = path_1.default.join(__dirname, 'resources', 'claude', 'skills', skillName);
+    // If CLI doesn't have this skill bundled, nothing to update.
+    if (!fsSync.existsSync(cliSkillPath)) {
+        return false;
+    }
+    // If project doesn't have this skill but CLI does, it needs to be added.
+    if (!fsSync.existsSync(projectSkillPath)) {
+        return true;
+    }
+    // Check each CLI file exists in project with same content.
+    const cliFiles = getFilesSorted(cliSkillPath);
+    for (const file of cliFiles) {
+        const cliFilePath = path_1.default.join(cliSkillPath, file);
+        const projectFilePath = path_1.default.join(projectSkillPath, file);
+        // Project missing a file that CLI has.
+        if (!fsSync.existsSync(projectFilePath)) {
+            return true;
+        }
+        // Content differs (normalize line endings for cross-platform compatibility).
+        const cliContent = fsSync.readFileSync(cliFilePath, 'utf8').replace(/\r\n/g, '\n');
+        const projectContent = fsSync.readFileSync(projectFilePath, 'utf8').replace(/\r\n/g, '\n');
+        if (cliContent !== projectContent) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Returns a list of skills that need to be updated (missing or outdated).
+ */
+function getSkillsNeedingUpdate() {
+    return exports.SQUID_SKILLS.filter(skillNeedsUpdate);
+}
+function displaySkillsWarningIfOutdated() {
+    try {
+        const skillsToUpdate = getSkillsNeedingUpdate();
+        if (skillsToUpdate.length > 0) {
+            console.warn(chalk_1.default.yellow(`⚠ Squid skills need updating (${skillsToUpdate.join(', ')}). Run: squid update-skills`));
+        }
+    }
+    catch (_ignored) { }
+}
+/**
+ * Updates all Squid-owned skills to the latest version bundled with the CLI.
+ */
+async function updateSkills() {
+    await (0, validate_1.validateSquidProject)();
+    const skillsToUpdate = getSkillsNeedingUpdate();
+    if (skillsToUpdate.length === 0) {
+        console.log(chalk_1.default.green('✓ Skills already up to date'));
+        return;
+    }
+    const skillsDir = path_1.default.join(process.cwd(), '.claude', 'skills');
+    let updatedCount = 0;
+    for (const skillName of skillsToUpdate) {
+        const cliSkillPath = path_1.default.join(__dirname, 'resources', 'claude', 'skills', skillName);
+        const projectSkillPath = path_1.default.join(skillsDir, skillName);
+        try {
+            await fs.mkdir(skillsDir, { recursive: true });
+            await fs.cp(cliSkillPath, projectSkillPath, { recursive: true });
+            console.log(`Updated ${(0, logging_1.primary)(skillName)} skill`);
+            updatedCount++;
+        }
+        catch (_error) {
+            console.warn(`Warning: Could not update ${skillName} skill`);
+        }
+    }
+    if (updatedCount > 0) {
+        console.log(chalk_1.default.green(`✓ ${updatedCount} skill(s) updated successfully`));
+    }
+}
+
+
 /***/ },
 
 /***/ 954
@@ -32169,11 +32583,9 @@ exports.reportLocalBackendInitialized = reportLocalBackendInitialized;
 const assertic_1 = __webpack_require__(3205);
 const http_1 = __webpack_require__(866);
 const environment_1 = __webpack_require__(722);
-async function reportLocalBackendInitialized(consoleRegion, appId, apiKey, verbose) {
+async function reportLocalBackendInitialized(consoleRegion, appId, apiKey) {
     const url = `${(0, http_1.getApplicationUrl)(consoleRegion, environment_1.environment.consoleAppId, 'webhooks/reportLocalBackendInitialized')}`;
-    if (verbose) {
-        console.log('Reporting backend initialization to Squid Console...', url);
-    }
+    console.debug('Reporting backend initialization to Squid Console...', url);
     try {
         const headers = new Headers();
         headers.append('Authorization', `ApiKey ${apiKey}`);
@@ -32284,6 +32696,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.checkCliVersion = checkCliVersion;
+exports.displayVersionWarningIfOutdated = displayVersionWarningIfOutdated;
 const assertic_1 = __webpack_require__(3205);
 const chalk_1 = __importDefault(__webpack_require__(7459));
 const time_units_1 = __webpack_require__(1929);
@@ -32360,6 +32773,15 @@ function parseVersion(version) {
 function formatWarningMessage(currentVersion, latestVersion) {
     return chalk_1.default.yellow(`⚠ Your @squidcloud/cli (${currentVersion}) is outdated. Latest: ${latestVersion}. Update: npm install -g @squidcloud/cli@latest`);
 }
+async function displayVersionWarningIfOutdated(versionCheckPromise) {
+    try {
+        const versionWarning = await versionCheckPromise;
+        if (versionWarning) {
+            console.warn(versionWarning);
+        }
+    }
+    catch (_ignored) { }
+}
 
 
 /***/ },
@@ -33982,6 +34404,14 @@ module.exports = require("assert");
 
 /***/ },
 
+/***/ 290
+(module) {
+
+"use strict";
+module.exports = require("async_hooks");
+
+/***/ },
+
 /***/ 181
 (module) {
 
@@ -36708,7 +37138,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.447","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.447","adm-zip":"^0.5.16","copy-webpack-plugin":"^12.0.2","decompress":"^4.2.1","nodemon":"^3.1.9","terser-webpack-plugin":"^5.3.10","ts-loader":"^9.5.1","ts-node":"^10.9.2","tsconfig-paths":"^4.2.0","tsconfig-paths-webpack-plugin":"^4.1.0","webpack":"^5.101.3","zip-webpack-plugin":"^4.0.1"},"devDependencies":{"@types/adm-zip":"^0.5.7","@types/decompress":"^4.2.7","@types/node":"^20.19.9","terminal-link":"^3.0.0"}}');
+module.exports = /*#__PURE__*/JSON.parse('{"name":"@squidcloud/cli","version":"1.0.450","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.450","adm-zip":"^0.5.16","copy-webpack-plugin":"^12.0.2","decompress":"^4.2.1","logpipes":"^1.11.0","nodemon":"^3.1.9","terser-webpack-plugin":"^5.3.10","ts-loader":"^9.5.1","ts-node":"^10.9.2","tsconfig-paths":"^4.2.0","tsconfig-paths-webpack-plugin":"^4.1.0","webpack":"^5.101.3","zip-webpack-plugin":"^4.0.1"},"devDependencies":{"@types/adm-zip":"^0.5.7","@types/decompress":"^4.2.7","@types/node":"^20.19.9","terminal-link":"^3.0.0"}}');
 
 /***/ }
 

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

@@ -18,7 +18,7 @@ Squid is a backend-as-a-service platform that provides:
 - **[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
-- **[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()
+- **[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, CLI, squid init, squid start, squid deploy, squid build, project structure
 - **[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

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

@@ -11,6 +11,7 @@ Squid provides database functionality similar to Firestore but more powerful, wi
 - OR Queries
 - Join Queries
 - Dereference
+- Field Projection
 - Pagination
 - Watch Changes
 - Transactions
@@ -314,6 +315,144 @@ const userData = await users.query()
 // - You need DocumentReference methods like .update() or .delete()
 ```
 
+## Field Projection
+
+Return only specific fields from queries to reduce bandwidth and improve performance.
+
+```typescript
+// Basic usage
+const results = await users.query()
+  .projectFields(['name', 'email'])
+  .dereference()
+  .snapshot();
+
+// Works with all query methods
+const results = await users.query()
+  .eq('status', 'active')
+  .sortBy('name')
+  .limit(50)
+  .projectFields(['name', 'email', 'status'])
+  .dereference()
+  .snapshot();
+```
+
+### Always-Included Fields
+
+These fields are **always** included in results regardless of projection:
+
+| Field | Present On | Description |
+|-------|------------|-------------|
+| `__docId__` | All integrations | JSON-stringified document identifier |
+| `__id` | `built_in_db` only | Primary key value |
+
+For **composite primary keys**, individual key fields are automatically spread to the top level:
+```typescript
+// Document with composite PK (pk1, pk2)
+// Result includes: { name: 'Alice', __docId__: '{"pk1":"a","pk2":1}', pk1: 'a', pk2: 1 }
+```
+
+### Nested Fields
+
+Use dot notation for nested paths:
+```typescript
+const results = await users.query()
+  .projectFields(['name', 'address.city', 'address.zip'])
+  .dereference()
+  .snapshot();
+// Result: { name: 'Alice', address: { city: 'NYC', zip: '10001' } }
+// Other address fields NOT included
+```
+
+### Validation Rules
+
+**Filter fields must be projected:**
+```typescript
+// ERROR: Cannot filter by 'email' not in projectFields
+users.query().eq('email', 'test@example.com').projectFields(['name']);
+
+// CORRECT: Include filter field
+users.query().eq('email', 'test@example.com').projectFields(['name', 'email']);
+```
+
+**Sort fields must be projected:**
+```typescript
+// ERROR: Cannot sort by 'email' not in projectFields
+users.query().sortBy('email').projectFields(['name']);
+
+// CORRECT: Include sort field
+users.query().sortBy('email').projectFields(['name', 'email']);
+```
+
+**Exception:** `__docId__` can always be used for filtering/sorting without being in projection:
+```typescript
+// ALLOWED: __docId__ is always available
+users.query().where('__docId__', '>=', 'user_100').projectFields(['name']);
+users.query().sortBy('__docId__').projectFields(['name']);
+```
+
+**Composite conditions must use projected fields:**
+```typescript
+// ERROR: Cannot filter by 'email' not in projectFields
+users.query().projectFields(['name']).addCompositeCondition([{ fieldName: 'email', operator: '>=', value: 'a' }]);
+
+// ALLOWED: __docId__ works without projection
+users.query().projectFields(['name']).addCompositeCondition([{ fieldName: '__docId__', operator: '>=', value: 'a' }]);
+```
+
+**Calling projectFields twice:** Second call must be a subset of the first:
+```typescript
+// ALLOWED: ['name'] is subset of ['name', 'age', 'email']
+users.query().projectFields(['name', 'age', 'email']).projectFields(['name']);
+
+// ERROR: 'email' was not in first projection
+users.query().projectFields(['name', 'age']).projectFields(['name', 'email']);
+```
+
+**Cloning:** `projectFields` returns a cloned QueryBuilder - original is unmodified:
+```typescript
+const base = collection.query().where('age', '>=', 18);
+const projected = base.projectFields(['name']);  // Returns clone
+// base still returns all fields, projected returns only 'name'
+```
+
+### Empty Array Behavior
+
+| Integration | Behavior |
+|-------------|----------|
+| `built_in_db` | Returns documents with only `__docId__` and `__id`, no user fields |
+| External DBs | **Throws error** - must specify at least one field |
+
+```typescript
+// built_in_db: returns { __docId__: '...', __id: '...' }
+await builtInCollection.query().projectFields([]).snapshot();
+
+// External DB: throws error
+await postgresCollection.query().projectFields([]); // Error!
+```
+
+### Edge Cases
+
+- **Non-existent fields:** Silently ignored, no error thrown
+- **Duplicate fields:** Handled gracefully, no duplication in results
+- **Including `__id` explicitly:** Not duplicated if already auto-included
+- **Optimistic updates:** Local updates respect the projection - document store only contains projected fields. Multiple subscriptions with different projections maintain isolated views of the same document.
+
+### Without dereference()
+
+When not using `dereference()`, you get `DocumentReference` objects. Access projected data via `.data`:
+```typescript
+const refs = await users.query().projectFields(['name']).snapshot();
+console.log(refs[0].data.name);  // Projected data on .data property
+```
+
+### Works With
+
+- One-time queries (`.snapshot()`)
+- Real-time subscriptions (`.snapshots()`)
+- Pagination (`.paginate()`)
+- Join queries
+- All database integrations (MongoDB, PostgreSQL, MySQL, ClickHouse, MS SQL, built_in_db)
+
 ## Pagination
 
 ```typescript

package/dist/resources/user-build.webpack.config.js

@@ -21,6 +21,15 @@ module.exports = function (env, argv) {
       'bufferutil': 'commonjs bufferutil',
       'utf-8-validate': 'commonjs utf-8-validate',
     },
+    // Suppress warnings from dependencies that use dynamic requires.
+    // These are typically dev dependencies used during build and don't affect runtime.
+    ignoreWarnings: [
+      { module: /tsoa/ },
+      { module: /@tsoa\/cli/ },
+      { module: /handlebars/ },
+      { module: /typescript/ },
+      { module: /yargs/ },
+    ],
     output: {
       path: path.resolve(process.cwd(), 'dist'),
       filename: 'index.js',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@squidcloud/cli",
-  "version": "1.0.447",
+  "version": "1.0.450",
   "description": "The Squid CLI",
   "main": "dist/index.js",
   "scripts": {
@@ -28,10 +28,11 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@squidcloud/local-backend": "^1.0.447",
+    "@squidcloud/local-backend": "^1.0.450",
     "adm-zip": "^0.5.16",
     "copy-webpack-plugin": "^12.0.2",
     "decompress": "^4.2.1",
+    "logpipes": "^1.11.0",
     "nodemon": "^3.1.9",
     "terser-webpack-plugin": "^5.3.10",
     "ts-loader": "^9.5.1",