@cometchat/skills-cli 2.2.0 → 2.3.0

package/dist/index.js

@@ -283,6 +283,9 @@ var init_state = __esm({
 // src/commands/detect.ts
 import { resolve } from "node:path";
 
+// src/detectors/framework.ts
+import { readdirSync } from "node:fs";
+
 // src/utils/version.ts
 function stripRange(versionRange) {
   return versionRange.replace(/^[\^~>=<\s]+/, "").trim();
@@ -312,7 +315,9 @@ var EMPTY = {
   env_prefix: null,
   expo_mode: null,
   expo_version: null,
-  react_native_version: null
+  react_native_version: null,
+  android_version: null,
+  flutter_version: null
 };
 function allDeps(pkg) {
   return {
@@ -434,6 +439,144 @@ function detectAstro(_root, deps) {
     env_prefix: "PUBLIC_"
   };
 }
+function detectIOS(root) {
+  let dirEntries = [];
+  try {
+    dirEntries = readdirSync(root);
+  } catch {
+  }
+  const hasXcode = dirEntries.some(
+    (n) => n.endsWith(".xcodeproj") || n.endsWith(".xcworkspace")
+  );
+  const podfile = readFileOrNull(p(root, "Podfile"));
+  const hasIOSPodfile = !!podfile && /platform\s+:ios/.test(podfile);
+  const packageSwift = readFileOrNull(p(root, "Package.swift"));
+  const hasIOSPackage = !!packageSwift && /\.iOS\s*\(/.test(packageSwift);
+  if (!hasXcode && !hasIOSPodfile && !hasIOSPackage) return null;
+  const podfileLock = readFileOrNull(p(root, "Podfile.lock")) ?? "";
+  const packageResolved = readFileOrNull(p(root, "Package.resolved")) ?? readFileOrNull(p(root, ".swiftpm/Package.resolved")) ?? "";
+  const cocoapodSources = (podfile ?? "") + podfileLock;
+  const spmSources = (packageSwift ?? "") + packageResolved;
+  let ios_version = null;
+  if (
+    // Podfile.lock: `- CometChatUIKitSwift (5.1.12)` / Podfile: `pod 'CometChatUIKitSwift', '~> 5.0'`
+    /CometChatUIKitSwift[^,\n]*?[\s'"(]5\./.test(cocoapodSources) || // Package.resolved: `"identity" : "cometchatuikitswift", ... "version" : "5.x.x"`
+    /cometchatuikitswift[\s\S]{0,300}"version"\s*:\s*"5\./i.test(spmSources) || // Package.swift: `.package(url: "https://github.com/cometchat/...CometChatUIKitSwift", from: "5.0.0")`
+    /CometChatUIKitSwift[\s\S]{0,200}from:\s*"5\./.test(spmSources)
+  ) {
+    ios_version = "v5";
+  }
+  return {
+    framework: "ios",
+    framework_version: null,
+    // Swift / iOS deployment target isn't load-bearing for the dispatcher
+    router: null,
+    bundler: null,
+    ssr_strategy: null,
+    env_prefix: "",
+    // No public-env-prefix; Secrets.swift / xcconfig is the convention
+    ios_version
+  };
+}
+function detectFlutter(root) {
+  const pubspecRaw = readFileOrNull(p(root, "pubspec.yaml"));
+  if (!pubspecRaw) return null;
+  const isFlutter = /\n\s*flutter:\s*\n\s*sdk:\s*flutter/.test(pubspecRaw) || /\n\s*flutter:\s*$/m.test(pubspecRaw) || /\n\s*flutter:\s*\n\s*uses-material-design/.test(pubspecRaw);
+  if (!isFlutter) return null;
+  let flutter_version = null;
+  if (/cometchat_chat_uikit\s*:\s*[\^~]?6\./.test(pubspecRaw)) {
+    flutter_version = "v6";
+  } else if (/cometchat_chat_uikit\s*:\s*[\^~]?5\./.test(pubspecRaw) || /cometchat_calls_uikit\s*:\s*[\^~]?5\./.test(pubspecRaw)) {
+    flutter_version = "v5";
+  }
+  const sdkMatch = pubspecRaw.match(/\n\s*environment:\s*\n\s*sdk:\s*['"]?([^'"\n]+)/);
+  const framework_version = sdkMatch ? sdkMatch[1].trim() : null;
+  return {
+    framework: "flutter",
+    framework_version,
+    router: null,
+    // Flutter routing is in code (Navigator/GoRouter); not modeled here
+    bundler: null,
+    // Dart compiler — no JS bundler
+    ssr_strategy: null,
+    env_prefix: "",
+    // No public-env-prefix; --dart-define or .env-derived constants
+    flutter_version
+  };
+}
+function detectAndroid(root) {
+  const hasSettingsGradle = pathExists(p(root, "settings.gradle")) || pathExists(p(root, "settings.gradle.kts"));
+  const hasBuildGradle = pathExists(p(root, "build.gradle")) || pathExists(p(root, "build.gradle.kts"));
+  if (!hasSettingsGradle && !hasBuildGradle) return null;
+  const hasAppModule = pathExists(p(root, "app/build.gradle")) || pathExists(p(root, "app/build.gradle.kts"));
+  const rootGradle = readFileOrNull(p(root, "build.gradle")) ?? readFileOrNull(p(root, "build.gradle.kts")) ?? "";
+  const settingsGradle = readFileOrNull(p(root, "settings.gradle")) ?? readFileOrNull(p(root, "settings.gradle.kts")) ?? "";
+  const hasAndroidPlugin = /com\.android\.(application|library)/.test(
+    rootGradle + settingsGradle
+  );
+  if (!hasAppModule && !hasAndroidPlugin) return null;
+  const buildFiles = [
+    "build.gradle",
+    "build.gradle.kts",
+    "app/build.gradle",
+    "app/build.gradle.kts"
+  ];
+  let allBuildContent = "";
+  for (const f of buildFiles) {
+    const c = readFileOrNull(p(root, f));
+    if (c) allBuildContent += "\n" + c;
+  }
+  let android_version = null;
+  if (/com\.cometchat:chatuikit-(compose|kotlin)-android:6/.test(allBuildContent)) {
+    android_version = "v6";
+  } else if (/com\.cometchat:chat-uikit-android:5/.test(allBuildContent)) {
+    android_version = "v5";
+  }
+  let android_language = null;
+  const usesKtsGradle = pathExists(p(root, "build.gradle.kts")) || pathExists(p(root, "app/build.gradle.kts")) || pathExists(p(root, "settings.gradle.kts"));
+  const hasKotlinPlugin = /(?:apply\s+plugin\s*:\s*['"]kotlin-android['"]|id\s*\(?\s*['"]org\.jetbrains\.kotlin\.android['"]|id\s*\(?\s*['"]kotlin-android['"])/.test(
+    allBuildContent
+  );
+  if (usesKtsGradle || hasKotlinPlugin) {
+    android_language = "kotlin";
+  } else {
+    const javaDir = p(root, "app/src/main/java");
+    const kotlinDir = p(root, "app/src/main/kotlin");
+    if (pathExists(kotlinDir)) android_language = "kotlin";
+    else if (pathExists(javaDir)) android_language = "java";
+  }
+  return {
+    framework: "android",
+    framework_version: null,
+    // Gradle/AGP version isn't load-bearing for the dispatcher
+    router: null,
+    bundler: null,
+    // No JS bundler for native Android
+    ssr_strategy: null,
+    env_prefix: "",
+    // No public-env-prefix — local.properties + BuildConfig is the convention
+    android_version,
+    android_language
+  };
+}
+function detectAngular(root, deps) {
+  const hasAngularJson = pathExists(p(root, "angular.json"));
+  const hasAngularCore = !!deps["@angular/core"];
+  if (!hasAngularJson && !hasAngularCore) return null;
+  const version = extractVersion(deps["@angular/core"] ?? "");
+  return {
+    framework: "angular",
+    framework_version: version,
+    router: null,
+    // Angular Router is a separate concern; not modeled here yet
+    bundler: "webpack",
+    // Angular CLI ships with webpack; esbuild for v17+ but irrelevant to integration
+    ssr_strategy: "spa-no-ssr",
+    // Angular Universal exists but the integration path is SPA
+    env_prefix: ""
+    // No public-env-prefix — environment.ts is the convention
+  };
+}
 function detectReactjs(root, deps) {
   if (!deps["react"]) return null;
   const version = extractVersion(deps["react"]);
@@ -465,10 +608,16 @@ function detectUsesJsx(root) {
   return false;
 }
 function detectFramework(root) {
+  const flutterInfo = detectFlutter(root);
+  if (flutterInfo) return flutterInfo;
+  const iosInfo = detectIOS(root);
+  if (iosInfo) return iosInfo;
+  const androidInfo = detectAndroid(root);
+  if (androidInfo) return androidInfo;
   const pkg = readJsonOrNull(p(root, "package.json"));
   if (!pkg) return EMPTY;
   const deps = allDeps(pkg);
-  return detectExpo(root, deps, pkg) ?? detectBareReactNative(root, deps) ?? detectNextjs(root, deps) ?? detectAstro(root, deps) ?? detectReactRouter(root, deps) ?? detectReactjs(root, deps) ?? EMPTY;
+  return detectExpo(root, deps, pkg) ?? detectBareReactNative(root, deps) ?? detectNextjs(root, deps) ?? detectAstro(root, deps) ?? detectReactRouter(root, deps) ?? detectAngular(root, deps) ?? detectReactjs(root, deps) ?? EMPTY;
 }
 
 // src/detectors/package-manager.ts
@@ -483,7 +632,7 @@ function detectPackageManager(root) {
 
 // src/detectors/credentials.ts
 init_fs();
-import { readdirSync, statSync } from "node:fs";
+import { readdirSync as readdirSync2, statSync } from "node:fs";
 import { join as join2, extname } from "node:path";
 function envVarsForPrefix(prefix) {
   const p2 = prefix ?? "";
@@ -551,7 +700,7 @@ function searchForInit(dir, maxDepth) {
   if (maxDepth < 0) return false;
   let entries;
   try {
-    entries = readdirSync(dir);
+    entries = readdirSync2(dir);
   } catch {
     return false;
   }
@@ -603,7 +752,7 @@ function detectCredentials(root, envPrefix) {
 }
 
 // src/detectors/integration.ts
-import { readdirSync as readdirSync2 } from "node:fs";
+import { readdirSync as readdirSync3 } from "node:fs";
 init_fs();
 function getInstalledVersion(root) {
   const pkg = readJsonOrNull(p(root, "package.json"));
@@ -626,7 +775,7 @@ function findCometchatDirs(root) {
     const fullPath = p(root, dir);
     if (!pathExists(fullPath)) continue;
     try {
-      const entries = readdirSync2(fullPath);
+      const entries = readdirSync3(fullPath);
       for (const entry of entries) {
         found.push(`${dir}/${entry}`);
       }
@@ -818,6 +967,34 @@ function detectArchitectureContext(root) {
   };
 }
 
+// src/detectors/project-name.ts
+init_fs();
+function detectProjectName(root) {
+  const pkg = readJsonOrNull(p(root, "package.json"));
+  if (pkg?.name) return cleanName(pkg.name);
+  const pubspec = readFileOrNull(p(root, "pubspec.yaml"));
+  if (pubspec) {
+    const m = pubspec.match(/^\s*name\s*:\s*['"]?([A-Za-z_][A-Za-z0-9_]*)['"]?\s*$/m);
+    if (m) return cleanName(m[1]);
+  }
+  const packageSwift = readFileOrNull(p(root, "Package.swift"));
+  if (packageSwift) {
+    const m = packageSwift.match(/Package\s*\(\s*name\s*:\s*"([^"]+)"/);
+    if (m) return cleanName(m[1]);
+  }
+  for (const file of ["settings.gradle.kts", "settings.gradle"]) {
+    const content = readFileOrNull(p(root, file));
+    if (!content) continue;
+    const m = content.match(/rootProject\.name\s*=\s*['"]([^'"\n]+)['"]/);
+    if (m) return cleanName(m[1]);
+  }
+  return null;
+}
+function cleanName(raw) {
+  const trimmed = raw.trim().slice(0, 64);
+  return trimmed.length > 0 ? trimmed : null;
+}
+
 // src/detectors/index.ts
 async function runDetectors(root) {
   const fw = detectFramework(root);
@@ -826,6 +1003,7 @@ async function runDetectors(root) {
   const existing_integration = detectExistingIntegration(root);
   const compatibility = computeCompatibility(fw);
   const architecture_context = detectArchitectureContext(root);
+  const project_name = detectProjectName(root);
   return {
     project_root: root,
     framework: fw.framework,
@@ -839,6 +1017,11 @@ async function runDetectors(root) {
     expo_mode: fw.expo_mode,
     expo_version: fw.expo_version,
     react_native_version: fw.react_native_version,
+    android_version: fw.android_version,
+    android_language: fw.android_language,
+    flutter_version: fw.flutter_version,
+    ios_version: fw.ios_version,
+    project_name,
     package_manager,
     credentials,
     existing_integration,
@@ -919,6 +1102,12 @@ function printHumanReadable(r) {
   if (r.react_native_version && r.framework === "expo") {
     lines.push(`  React Native:      ${r.react_native_version}`);
   }
+  if (r.framework === "android") {
+    lines.push(`  Android UIKit:     ${r.android_version ?? "(none yet \u2014 greenfield)"}`);
+  }
+  if (r.framework === "flutter") {
+    lines.push(`  Flutter UIKit:     ${r.flutter_version ?? "(none yet \u2014 greenfield)"}`);
+  }
   if (r.router !== null) lines.push(`  Router:            ${r.router}`);
   if (r.bundler !== null) lines.push(`  Bundler:           ${r.bundler}`);
   if (r.ssr_strategy !== null) lines.push(`  SSR strategy:      ${r.ssr_strategy}`);
@@ -3134,7 +3323,7 @@ function printHumanReadable5(r) {
 // src/commands/uninstall.ts
 init_state();
 init_fs();
-import { rmSync as rmSync2, statSync as statSync3, rmdirSync, readdirSync as readdirSync3 } from "node:fs";
+import { rmSync as rmSync2, statSync as statSync3, rmdirSync, readdirSync as readdirSync4 } from "node:fs";
 import { dirname as dirname6, join as join9, resolve as resolve7 } from "node:path";
 var HELP6 = `
 cometchat uninstall \u2014 remove the CometChat integration cleanly
@@ -3168,7 +3357,7 @@ function projectPath6(args) {
 }
 function maybeRemoveEmptyDir(dir) {
   try {
-    const entries = readdirSync3(dir);
+    const entries = readdirSync4(dir);
     if (entries.length === 0) {
       rmdirSync(dir);
       maybeRemoveEmptyDir(dirname6(dir));
@@ -3245,7 +3434,7 @@ async function uninstall(args) {
   try {
     const cometchatDir = p(root, ".cometchat");
     if (statSync3(cometchatDir).isDirectory()) {
-      const entries = readdirSync3(cometchatDir);
+      const entries = readdirSync4(cometchatDir);
       if (entries.length === 0) rmdirSync(cometchatDir);
     }
   } catch {
@@ -5191,8 +5380,19 @@ async function listApps(host, token) {
     const name = String(entry.name ?? id);
     const region = String(entry.region ?? "us");
     const plan = typeof entry.plan === "string" ? entry.plan : void 0;
-    const base = { id, name, region };
-    return plan ? { ...base, plan } : base;
+    const meta = entry.metadata && typeof entry.metadata === "object" ? entry.metadata : {};
+    const industry = typeof meta.industry === "string" ? meta.industry : void 0;
+    const technology = typeof meta.technology === "string" ? meta.technology : void 0;
+    const product = typeof meta.product === "string" ? meta.product : void 0;
+    const createdAtRaw = entry.createdAt ?? entry.created_at;
+    const createdAt = typeof createdAtRaw === "number" ? createdAtRaw : typeof createdAtRaw === "string" ? Number(new Date(createdAtRaw)) || void 0 : void 0;
+    const out = { id, name, region };
+    if (plan) out.plan = plan;
+    if (industry) out.industry = industry;
+    if (technology) out.technology = technology;
+    if (product) out.product = product;
+    if (createdAt !== void 0) out.createdAt = createdAt;
+    return out;
   });
 }
 async function getAppCredentials(host, token, appId) {
@@ -5219,6 +5419,40 @@ async function getAppCredentials(host, token, appId) {
   }
   return { appId: id, authKey, region };
 }
+async function getCurrentUser(host, token) {
+  const res = await request(host, "/me", {
+    method: "GET",
+    headers: { Authorization: `Bearer ${token}` }
+  });
+  const body = await parseBody(res);
+  if (!res.ok) {
+    const { code, message } = extractErrorCode(body);
+    if (res.status === 401) throw new Error("AUTH_FAILED");
+    throw new Error(`API_ERROR: ${code} ${message}`);
+  }
+  const data = body?.data;
+  if (!data || typeof data !== "object") {
+    throw new Error(`API_ERROR: UNEXPECTED_SHAPE ${JSON.stringify(body)}`);
+  }
+  return data;
+}
+async function getCurrentUserWithLastApp(host, token) {
+  const user = await getCurrentUser(host, token);
+  let last_app = null;
+  try {
+    const apps = await listApps(host, token);
+    if (apps.length > 0) {
+      const sorted = [...apps].sort((a, b) => {
+        const aT = a.createdAt ?? 0;
+        const bT = b.createdAt ?? 0;
+        return bT - aT;
+      });
+      last_app = sorted[0];
+    }
+  } catch {
+  }
+  return { ...user, last_app };
+}
 async function listInstalledExtensions(host, token, appId) {
   const res = await request(
     host,
@@ -5249,6 +5483,49 @@ async function toggleExtension(host, token, appId, extensionId, action) {
     throw new Error(`API_ERROR: ${code} ${message}`);
   }
 }
+async function toggleAiFeature(host, token, appId, featureKey, action) {
+  const path = `/apps/${encodeURIComponent(appId)}/features/ai.${encodeURIComponent(featureKey)}/enabled`;
+  const res = await request(host, path, {
+    method: action === "enable" ? "POST" : "DELETE",
+    headers: { Authorization: `Bearer ${token}` },
+    body: action === "enable" ? "{}" : void 0
+  });
+  if (!res.ok) {
+    const body = await parseBody(res);
+    const { code, message } = extractErrorCode(body);
+    if (res.status === 401) throw new Error("AUTH_FAILED");
+    throw new Error(`API_ERROR: ${code} ${message}`);
+  }
+}
+async function getAiSettings(host, token, appId) {
+  const res = await request(host, `/apps/${encodeURIComponent(appId)}/ai/settings`, {
+    method: "GET",
+    headers: { Authorization: `Bearer ${token}` }
+  });
+  const body = await parseBody(res);
+  if (!res.ok) {
+    const { code, message } = extractErrorCode(body);
+    if (res.status === 401) throw new Error("AUTH_FAILED");
+    if (res.status === 404) return null;
+    throw new Error(`API_ERROR: ${code} ${message}`);
+  }
+  const data = body?.data;
+  if (!data || typeof data !== "object") return null;
+  return data;
+}
+async function updateAiSettings(host, token, appId, settings) {
+  const res = await request(host, `/apps/${encodeURIComponent(appId)}/ai/settings`, {
+    method: "PUT",
+    headers: { Authorization: `Bearer ${token}` },
+    body: JSON.stringify(settings)
+  });
+  if (!res.ok) {
+    const body = await parseBody(res);
+    const { code, message } = extractErrorCode(body);
+    if (res.status === 401) throw new Error("AUTH_FAILED");
+    throw new Error(`API_ERROR: ${code} ${message}`);
+  }
+}
 async function createApp(host, token, params) {
   const res = await request(host, "/apps", {
     method: "POST",
@@ -5347,40 +5624,58 @@ function nextStepsForFeature(feature, framework = "reactjs") {
         feature.requires_dashboard_setup ? "Some features (like moderation) need rules configured in the CometChat dashboard before they activate. Check the dashboard." : "No code changes needed \u2014 it's already there.",
         ...feature.docs_topic ? [`For details, query the docs MCP for "${feature.docs_topic}" or visit https://www.cometchat.com/docs/ui-kit/react/${feature.docs_topic}`] : []
       ];
-    case "dashboard-toggle": {
+    case "extension": {
       const docsUrl = feature.docs_topic ? `https://www.cometchat.com/docs/ui-kit/react/${feature.docs_topic}` : "https://www.cometchat.com/docs/ui-kit/react/extensions";
       const lines = [];
       if (feature.auto_wired_in_uikit) {
         lines.push(
-          `${feature.name} is in the UI Kit's defaultExtensions[] \u2014 its UI decorator is attached automatically by initiateAfterLogin(). The only thing you need to do is flip the dashboard toggle.`,
+          `${feature.name} is in the UI Kit's defaultExtensions[] \u2014 its UI decorator is attached automatically by initiateAfterLogin().`,
           "",
           "Steps to enable:",
-          `  1. Go to https://app.cometchat.com and select your app`,
-          `  2. Navigate to: ${feature.dashboard_path ?? "Extensions \u2192 " + feature.name}`,
-          `     (this is a hint \u2014 if the dashboard UI has changed, see the canonical docs link below)`,
-          `  3. Toggle the feature on (and configure any required values)`,
-          `  4. Refresh your dev server \u2014 no code changes required`,
+          `  1. Run \`cometchat apply-feature ${feature.id}\` \u2014 the CLI flips the dashboard toggle via API.`,
+          `  2. Refresh your dev server \u2014 no code changes required.`,
           "",
-          `  \u{1F4D6} Canonical docs (always-current \u2014 use this if the dashboard navigation above doesn't match what you see):`,
-          `     ${docsUrl}`,
-          `     For exact, up-to-date integration steps, query the cometchat-docs MCP for "${feature.id}".`
+          `  Manual fallback (if API isn't available): https://app.cometchat.com \u2192 ${feature.dashboard_path ?? "Extensions \u2192 " + feature.name}`,
+          `  \u{1F4D6} Canonical docs: ${docsUrl}`
         );
       } else {
         lines.push(
           `${feature.name} is a dashboard-toggle extension that ALSO requires explicit registration in your UIKitSettingsBuilder. The UI Kit only auto-attaches the 7 extensions in defaultExtensions[]; this one is not in that list.`,
           "",
           "Steps to enable:",
-          `  1. Go to https://app.cometchat.com \u2192 ${feature.dashboard_path ?? "Extensions \u2192 " + feature.name}, toggle on`,
-          `     (dashboard hint \u2014 see canonical docs link below if the navigation has changed)`,
+          `  1. Run \`cometchat apply-feature ${feature.id}\` \u2014 the CLI flips the dashboard toggle via API.`,
           `  2. Register the extension via UIKitSettingsBuilder.setExtensions([...]) in your CometChat init.`,
           `     For the exact import path + extension class name + builder syntax, query the cometchat-docs MCP for "${feature.id}" \u2014 DO NOT invent the API from memory.`,
-          `  3. Restart your dev server`,
+          `  3. Restart your dev server.`,
           "",
           `  \u{1F4D6} Canonical docs: ${docsUrl}`
         );
       }
       return lines;
     }
+    case "ai-feature": {
+      const docsUrl = feature.docs_topic ? `https://www.cometchat.com/docs/ui-kit/react/${feature.docs_topic}` : "https://www.cometchat.com/docs/ui-kit/react/ai-features";
+      return [
+        `${feature.name} is an AI feature that requires an OpenAI API key on the app's AI settings.`,
+        "",
+        "Steps to enable:",
+        `  1. Run \`cometchat apply-feature ${feature.id} --openai-key sk-...\` \u2014 the CLI stores the key and flips the AI toggle via API.`,
+        `  2. Refresh your dev server.`,
+        "",
+        `  Get an OpenAI key: https://platform.openai.com/api-keys`,
+        `  \u{1F4D6} Canonical docs: ${docsUrl}`
+      ];
+    }
+    case "dashboard-only":
+      return [
+        `${feature.name} requires third-party config (API key, webhook, etc.) that only you can provide. The CLI cannot automate this.`,
+        "",
+        "Steps to enable:",
+        `  1. Open https://app.cometchat.com \u2192 ${feature.dashboard_path ?? "Extensions \u2192 " + feature.name}`,
+        `  2. Enter the required configuration values.`,
+        `  3. Toggle the feature on; refresh your dev server.`,
+        ...feature.docs_topic ? ["", `  \u{1F4D6} Canonical docs: https://www.cometchat.com/docs/ui-kit/react/${feature.docs_topic}`] : []
+      ];
     case "package-install": {
       const pkg = rn && feature.package_native ? feature.package_native : feature.package;
       const peers = rn ? feature.package_native_peers ?? [] : [];
@@ -5498,7 +5793,7 @@ async function featuresToggle(args, featureName, action) {
     if (json) {
       console.log(JSON.stringify({
         ...result2,
-        available: catalog.features.filter((f) => f.type === "dashboard-toggle").map((f) => f.id)
+        available: catalog.features.filter((f) => f.type === "extension").map((f) => f.id)
       }, null, 2));
     } else {
       console.error(`\u2717 Feature "${featureName}" not found.`);
@@ -5506,11 +5801,12 @@ async function featuresToggle(args, featureName, action) {
     }
     return 1;
   }
-  if (match.type !== "dashboard-toggle") {
+  if (match.type !== "extension") {
+    const hint = match.type === "ai-feature" ? `Use \`cometchat apply-feature ${match.id} --openai-key <sk-\u2026>\` to enable AI features.` : `Run \`cometchat features info ${match.id}\` for the right instructions.`;
     const result2 = {
       status: "unsupported-type",
       feature: match,
-      error: `"${match.name}" is type "${match.type}" \u2014 not a dashboard toggle. Run \`cometchat features info ${match.id}\` for the right instructions.`
+      error: `"${match.name}" is type "${match.type}" \u2014 not a dashboard toggle. ${hint}`
     };
     if (json) {
       console.log(JSON.stringify(result2, null, 2));
@@ -5651,7 +5947,9 @@ function featuresList(args) {
   }
   const order = [
     "default",
-    "dashboard-toggle",
+    "extension",
+    "ai-feature",
+    "dashboard-only",
     "package-install",
     "component-swap"
   ];
@@ -6804,21 +7102,52 @@ init_state();
 import { readFileSync as readFileSync12, writeFileSync as writeFileSync7 } from "node:fs";
 import { join as join15, resolve as resolve16 } from "node:path";
 var HELP15 = `
-cometchat apply-feature \u2014 apply a component-swap feature on an integration
+cometchat apply-feature \u2014 apply a feature on top of an existing integration
 
 Usage:
-  cometchat apply-feature <feature-id> [--path <p>] [--json]
+  cometchat apply-feature <feature-id> [--app-id <id>] [--openai-key <k>] [--path <p>] [--json]
 
 What this does:
-  Applies a component-swap feature (e.g. rich-text-formatting) on top of
-  an existing integration. Walks state.files_owned, runs a word-boundary
-  regex replace of swap_from \u2192 swap_to, updates checksums, and records the
-  feature id in state.applied_features. Idempotent.
+  Dispatches by feature type from the catalog:
+    extension       Calls the dashboard API to flip the toggle. No code change.
+    ai-feature      Same, plus prompts/accepts an OpenAI key once per app.
+    component-swap  Walks files_owned and runs a word-boundary identifier
+                    swap (e.g. CometChatMessageComposer \u2192
+                    CometChatCompactMessageComposer). Updates checksums.
+    default         No-op \u2014 feature is already enabled by the UI Kit.
+    dashboard-only  Prints the dashboard path. Cannot automate (third-party
+                    keys, multi-field config).
+    package-install Prints the npm install command. Cannot automate.
+
+  In stateful mode (default for web/RN where \`cometchat apply\` was run):
+    - Reads .cometchat/state.json
+    - Resolves the App ID from the project's env file
+    - Records applied features in state.json for idempotency
+
+  In stateless mode (\`--app-id\` passed; for native iOS/Android/Flutter/Angular
+  projects that don't go through \`cometchat apply\`):
+    - Skips state.json
+    - Uses the explicit --app-id value
+    - Skips applied_features recording (server-side toggles are idempotent)
+    - component-swap is unavailable (no files_owned to walk)
 
 Flags:
-  --path <p>  Project root (defaults to cwd).
-  --json      Machine-readable JSON output.
-  --help, -h  Show this help.
+  --app-id <id>     Stateless mode \u2014 toggle the feature on this app via the
+                    dashboard API without requiring \`cometchat apply\` to
+                    have been run first. Required for native cohorts
+                    (iOS / Android / Flutter / Angular).
+  --openai-key <k>  Pre-fill the OpenAI API key for ai-feature applies. If
+                    omitted, the command checks the app's existing AI
+                    settings; if no key is set, returns an error asking
+                    the user to pass --openai-key.
+  --path <p>        Project root (defaults to cwd).
+  --json            Machine-readable JSON output.
+  --help, -h        Show this help.
+
+Auth:
+  extension and ai-feature applies require a dashboard bearer token.
+  Run \`cometchat auth login\` first if you haven't already. The token is
+  stored in the OS keychain (or ~/.cometchat-cli/credentials.json fallback).
 `;
 function isJsonMode16(args) {
   return args.flags.json === true || args.flags.json === "true";
@@ -6834,6 +7163,24 @@ function catalogPath2() {
 function loadCatalog2() {
   return JSON.parse(readFileSync12(catalogPath2(), "utf8"));
 }
+function resolveAppId2(root, state2) {
+  const envFileName = envFileNameFor(state2.framework);
+  if (!envFileName) return null;
+  const envPath = join15(root, envFileName);
+  let content;
+  try {
+    content = readFileSync12(envPath, "utf8");
+  } catch {
+    return null;
+  }
+  const pairs = parseEnvPairs(content);
+  const prefix = state2.env_var_prefix ?? "";
+  const prefixed = pairs.get(`${prefix}COMETCHAT_APP_ID`);
+  const bare = pairs.get("COMETCHAT_APP_ID");
+  const value = (prefixed ?? bare ?? "").trim();
+  if (value.length === 0 || isPlaceholder(value)) return null;
+  return value;
+}
 function swapIdentifier(content, from, to) {
   const escaped = from.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
   const re = new RegExp(`\\b${escaped}\\b`, "g");
@@ -6862,15 +7209,22 @@ async function applyFeature(args) {
     result.error = "Usage: cometchat apply-feature <feature-id>";
     return outputResult11(args, result, 1);
   }
-  if (!hasState(root)) {
+  const appIdFlag = args.flags["app-id"];
+  const explicitAppId = typeof appIdFlag === "string" ? appIdFlag.trim() : "";
+  let state2 = null;
+  let stateless = false;
+  if (explicitAppId.length > 0) {
+    stateless = true;
+  } else if (hasState(root)) {
+    state2 = readState(root);
+    if (!state2) {
+      result.status = "error";
+      result.error = "state.json exists but could not be parsed (schema mismatch?)";
+      return outputResult11(args, result, 1);
+    }
+  } else {
     result.status = "no-integration";
-    result.error = "No CometChat integration found. Run `cometchat apply` first.";
-    return outputResult11(args, result, 1);
-  }
-  const state2 = readState(root);
-  if (!state2) {
-    result.status = "error";
-    result.error = "state.json exists but could not be parsed (schema mismatch?)";
+    result.error = "No CometChat integration found. Run `cometchat apply` first, or pass `--app-id <id>` for stateless API toggles (native cohorts: iOS/Android/Flutter/Angular).";
     return outputResult11(args, result, 1);
   }
   let catalog;
@@ -6887,26 +7241,192 @@ async function applyFeature(args) {
     result.error = `Feature "${featureId}" not in the catalog. Run \`cometchat features list\` to see available features.`;
     return outputResult11(args, result, 1);
   }
-  if (feature.type !== "component-swap") {
-    result.status = "unsupported-feature-type";
-    result.error = `Feature "${featureId}" is type "${feature.type}", not "component-swap". Only component-swap features can be applied via this command.`;
+  result.feature_type = feature.type;
+  if (state2?.applied_features?.includes(featureId)) {
+    result.status = "already-applied";
+    result.next_steps = [`${feature.name} is already applied to this integration.`];
+    return outputResult11(args, result, 0);
+  }
+  switch (feature.type) {
+    case "default":
+      return applyDefault(args, result, feature);
+    case "component-swap":
+      if (stateless || !state2) {
+        result.status = "state-required";
+        result.error = `Feature "${feature.id}" is type component-swap and requires \`cometchat apply\` to have run first (so we know which files to swap). \`--app-id\` mode does not support component-swap features.`;
+        return outputResult11(args, result, 1);
+      }
+      return applyComponentSwap(args, result, root, state2, feature);
+    case "extension":
+      return applyExtensionToggle(args, result, root, state2, explicitAppId, feature);
+    case "ai-feature":
+      return applyAiFeatureToggle(args, result, root, state2, explicitAppId, feature);
+    case "dashboard-only":
+      return applyDashboardOnly(args, result, feature);
+    case "package-install":
+      return applyPackageInstall(args, result, feature);
+    default: {
+      result.status = "unsupported-feature-type";
+      result.error = `Feature "${featureId}" has unknown type "${feature.type}".`;
+      return outputResult11(args, result, 1);
+    }
+  }
+}
+function applyDefault(args, result, feature) {
+  result.status = "already-applied";
+  result.next_steps = [
+    `${feature.name} is enabled by default in the UI Kit. No action needed.`,
+    ...feature.docs_topic ? [`Docs: https://www.cometchat.com/docs/ui-kit/react/${feature.docs_topic}`] : []
+  ];
+  return outputResult11(args, result, 0);
+}
+async function applyExtensionToggle(args, result, root, state2, explicitAppId, feature) {
+  const host = getApiHost();
+  const creds = await loadToken(host);
+  if (!creds) {
+    result.status = "auth-required";
+    result.error = "No dashboard bearer token found.";
     result.next_steps = [
-      feature.type === "default" ? `${feature.name} is already enabled \u2014 no action needed.` : feature.type === "dashboard-toggle" ? `${feature.name} is enabled in the CometChat dashboard, not via this command. Run \`cometchat features info ${featureId}\`.` : feature.type === "package-install" ? `${feature.name} requires \`npm install\` of an extra package. Run \`cometchat features info ${featureId}\`.` : `Run \`cometchat features info ${featureId}\` for instructions.`
+      "Run `cometchat auth login` to authorize the CLI, then re-run this command."
     ];
     return outputResult11(args, result, 1);
   }
-  if (!feature.swap_from || !feature.swap_to) {
+  const appId = explicitAppId || (state2 ? resolveAppId2(root, state2) : null);
+  if (!appId) {
     result.status = "error";
-    result.error = `Feature "${featureId}" is missing swap_from / swap_to in the catalog.`;
+    result.error = state2 ? "Could not read COMETCHAT_APP_ID from the project's env file." : "App ID is required. Pass `--app-id <id>`.";
+    result.next_steps = state2 ? [`Confirm \`${state2.env_var_prefix ?? ""}COMETCHAT_APP_ID\` is set in your env file.`] : ["Run `cometchat apply-feature <id> --app-id <your-app-id>`."];
     return outputResult11(args, result, 1);
   }
-  if (state2.applied_features?.includes(featureId)) {
-    result.status = "already-applied";
+  try {
+    await toggleExtension(host, creds.token, appId, feature.id, "enable");
+  } catch (err) {
+    return handleApiError(args, result, err, feature);
+  }
+  if (state2) {
+    state2.applied_features = [...state2.applied_features ?? [], feature.id];
+    writeState(root, state2);
+    appendAuditEntry(root, {
+      command: `apply-feature ${feature.id}`,
+      summary: `Enabled extension "${feature.name}" via dashboard API on app ${appId}`,
+      inputs: { feature: feature.id, appId },
+      decisions: {
+        api_endpoint: `POST /apps/${appId}/extensions { enabled: ["${feature.id}"] }`,
+        auto_wired: feature.auto_wired_in_uikit ? "yes" : "no"
+      },
+      files_modified: [],
+      next_actions: [`Refresh the chat in the browser. ${feature.name} is now active.`]
+    });
+  }
+  result.next_steps = [
+    `Enabled ${feature.name} on app ${appId}.`,
+    feature.auto_wired_in_uikit ? "The UI Kit's defaultExtensions[] picks this up automatically \u2014 refresh the browser." : "Refresh the chat in the browser. If the feature requires UIKitSettingsBuilder.setExtensions([...]), see the docs link below.",
+    ...feature.docs_topic ? [`Docs: https://www.cometchat.com/docs/ui-kit/react/${feature.docs_topic}`] : []
+  ];
+  return outputResult11(args, result, 0);
+}
+async function applyAiFeatureToggle(args, result, root, state2, explicitAppId, feature) {
+  if (!feature.ai_key) {
+    result.status = "error";
+    result.error = `Feature "${feature.id}" is type ai-feature but has no ai_key in the catalog.`;
+    return outputResult11(args, result, 1);
+  }
+  const host = getApiHost();
+  const creds = await loadToken(host);
+  if (!creds) {
+    result.status = "auth-required";
+    result.error = "No dashboard bearer token found.";
     result.next_steps = [
-      `${feature.name} is already applied to this integration.`,
-      `Files using ${feature.swap_to}: scan with \`grep -r "${feature.swap_to}" .\`.`
+      "Run `cometchat auth login` to authorize the CLI, then re-run this command."
     ];
-    return outputResult11(args, result, 0);
+    return outputResult11(args, result, 1);
+  }
+  const appId = explicitAppId || (state2 ? resolveAppId2(root, state2) : null);
+  if (!appId) {
+    result.status = "error";
+    result.error = state2 ? "Could not read COMETCHAT_APP_ID from the project's env file." : "App ID is required. Pass `--app-id <id>`.";
+    result.next_steps = state2 ? [`Confirm \`${state2.env_var_prefix ?? ""}COMETCHAT_APP_ID\` is set in your env file.`] : ["Run `cometchat apply-feature <id> --app-id <your-app-id> --openai-key <sk-\u2026>`."];
+    return outputResult11(args, result, 1);
+  }
+  const openaiFlag = args.flags["openai-key"];
+  const explicitKey = typeof openaiFlag === "string" ? openaiFlag.trim() : "";
+  let needsKeyWrite = false;
+  if (explicitKey.length > 0) {
+    needsKeyWrite = true;
+  } else {
+    let existing;
+    try {
+      existing = await getAiSettings(host, creds.token, appId);
+    } catch (err) {
+      return handleApiError(args, result, err, feature);
+    }
+    const currentKey = (existing?.openAIKey ?? "").trim();
+    if (currentKey.length === 0) {
+      result.status = "openai-key-required";
+      result.error = `${feature.name} requires an OpenAI API key. None is set on app ${appId}.`;
+      result.next_steps = [
+        "Pass `--openai-key <sk-\u2026>` to set the key and enable the feature in one step.",
+        "Get a key from https://platform.openai.com/api-keys"
+      ];
+      return outputResult11(args, result, 1);
+    }
+  }
+  try {
+    if (needsKeyWrite) {
+      await updateAiSettings(host, creds.token, appId, { openAIKey: explicitKey });
+    }
+    await toggleAiFeature(host, creds.token, appId, feature.ai_key, "enable");
+  } catch (err) {
+    return handleApiError(args, result, err, feature);
+  }
+  if (state2) {
+    state2.applied_features = [...state2.applied_features ?? [], feature.id];
+    writeState(root, state2);
+    appendAuditEntry(root, {
+      command: `apply-feature ${feature.id}`,
+      summary: `Enabled AI feature "${feature.name}" via dashboard API on app ${appId}`,
+      inputs: { feature: feature.id, appId, openai_key_written: needsKeyWrite },
+      decisions: {
+        settings_endpoint: needsKeyWrite ? `PUT /apps/${appId}/ai/settings { openAIKey: "(redacted)" }` : "skipped (key already set)",
+        toggle_endpoint: `POST /apps/${appId}/features/ai.${feature.ai_key}/enabled`
+      },
+      files_modified: [],
+      next_actions: [`Refresh the chat. AI ${feature.name} is now active.`]
+    });
+  }
+  result.next_steps = [
+    `Enabled ${feature.name} on app ${appId}.`,
+    needsKeyWrite ? "OpenAI key stored on the app's AI settings." : "OpenAI key was already set.",
+    "Refresh the chat in the browser to see the feature in action.",
+    ...feature.docs_topic ? [`Docs: https://www.cometchat.com/docs/ui-kit/react/${feature.docs_topic}`] : []
+  ];
+  return outputResult11(args, result, 0);
+}
+function applyDashboardOnly(args, result, feature) {
+  result.status = "manual-action-required";
+  result.error = `${feature.name} requires config beyond a boolean toggle (third-party API key or multi-field setup).`;
+  result.next_steps = [
+    feature.dashboard_path ? `In the dashboard at https://app.cometchat.com \u2192 ${feature.dashboard_path}` : `Open https://app.cometchat.com and configure ${feature.name} on the Extensions page.`,
+    ...feature.docs_topic ? [`Docs: https://www.cometchat.com/docs/ui-kit/react/${feature.docs_topic}`] : []
+  ];
+  return outputResult11(args, result, 1);
+}
+function applyPackageInstall(args, result, feature) {
+  result.status = "manual-action-required";
+  result.error = `${feature.name} requires installing an additional package.`;
+  const pkg = feature.package ?? "the calls SDK";
+  result.next_steps = [
+    `Run \`npm install ${pkg}\` and restart your dev server.`,
+    "The UI Kit's initiateAfterLogin() detects the SDK and wires up call buttons automatically.",
+    ...feature.docs_topic ? [`Docs: https://www.cometchat.com/docs/ui-kit/react/${feature.docs_topic}`] : []
+  ];
+  return outputResult11(args, result, 1);
+}
+function applyComponentSwap(args, result, root, state2, feature) {
+  if (!feature.swap_from || !feature.swap_to) {
+    result.status = "error";
+    result.error = `Feature "${feature.id}" is missing swap_from / swap_to in the catalog.`;
+    return outputResult11(args, result, 1);
   }
   const newChecksums = { ...state2.checksums };
   const modified = [];
@@ -6939,7 +7459,7 @@ async function applyFeature(args) {
   const nextState = {
     ...state2,
     checksums: newChecksums,
-    applied_features: [...state2.applied_features ?? [], featureId]
+    applied_features: [...state2.applied_features ?? [], feature.id]
   };
   writeState(root, nextState);
   result.files_modified = modified;
@@ -6950,9 +7470,9 @@ async function applyFeature(args) {
     ...feature.docs_topic ? [`Docs: https://www.cometchat.com/docs/ui-kit/react/${feature.docs_topic}`] : []
   ];
   appendAuditEntry(root, {
-    command: `apply-feature ${featureId}`,
+    command: `apply-feature ${feature.id}`,
     summary: `Applied component-swap feature "${feature.name}" \u2014 replaced ${feature.swap_from} with ${feature.swap_to} in ${modified.length} owned file(s)`,
-    inputs: { feature: featureId },
+    inputs: { feature: feature.id },
     decisions: {
       swap_target: `${feature.swap_from} \u2192 ${feature.swap_to} (canonical drop-in variant from @cometchat/chat-uikit-react)`,
       file_selection: `walked state.files_owned and ran a word-boundary regex replace; only files that contained the canonical token were touched`,
@@ -6963,6 +7483,24 @@ async function applyFeature(args) {
   });
   return outputResult11(args, result, 0);
 }
+function handleApiError(args, result, err, feature) {
+  const msg = err instanceof Error ? err.message : String(err);
+  if (msg === "AUTH_FAILED") {
+    result.status = "auth-required";
+    result.error = "Bearer token rejected (expired or invalid).";
+    result.next_steps = ["Run `cometchat auth login` to refresh the token, then re-run this command."];
+    return outputResult11(args, result, 1);
+  }
+  if (msg === "NETWORK") {
+    result.status = "error";
+    result.error = "Network error reaching the dashboard API.";
+    result.next_steps = ["Check your connection and re-run."];
+    return outputResult11(args, result, 1);
+  }
+  result.status = "error";
+  result.error = `Failed to enable ${feature.name}: ${msg}`;
+  return outputResult11(args, result, 1);
+}
 function outputResult11(args, result, exitCode) {
   if (isJsonMode16(args)) {
     console.log(JSON.stringify(enrichResultWithError(result), null, 2));
@@ -6976,9 +7514,11 @@ function printHumanReadable14(r) {
   lines.push("");
   if (r.status === "applied") {
     lines.push(`  \u2713 Applied feature: ${r.feature}`);
-    lines.push("");
-    lines.push("  Files modified:");
-    for (const f of r.files_modified) lines.push(`    ${f}`);
+    if (r.files_modified.length > 0) {
+      lines.push("");
+      lines.push("  Files modified:");
+      for (const f of r.files_modified) lines.push(`    ${f}`);
+    }
   } else if (r.status === "already-applied") {
     lines.push(`  \u25E6 ${r.feature} is already applied \u2014 nothing to do.`);
   } else {
@@ -7551,6 +8091,7 @@ Usage:
   cometchat auth login  [--token <bearer>] [--json]
   cometchat auth signup [--json]
   cometchat auth status [--json]
+  cometchat auth me     [--json]
   cometchat auth logout [--json]
 
 \`auth login\` and \`auth signup\` open your browser at the CometChat
@@ -7589,6 +8130,8 @@ async function auth(args) {
       return authLogin(args);
     case "status":
       return authStatus(args);
+    case "me":
+      return authMe(args);
     case "logout":
       return authLogout(args);
     case "signup":
@@ -7747,6 +8290,81 @@ async function authStatus(args) {
   console.log("");
   return 0;
 }
+async function authMe(args) {
+  const json = isJsonMode18(args);
+  const apiHost = getApiHost();
+  const creds = await loadToken(apiHost);
+  if (!creds) {
+    return printError(json, {
+      status: "logged-out",
+      error: "No bearer token found. Run `cometchat auth login` first."
+    });
+  }
+  let user;
+  try {
+    user = await getCurrentUserWithLastApp(apiHost, creds.token);
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    if (msg === "AUTH_FAILED") {
+      return printError(json, {
+        status: "auth-required",
+        error: "Bearer token rejected (expired or invalid).",
+        next_step: "Run `cometchat auth login` to refresh the token."
+      });
+    }
+    return printError(json, { status: "error", error: msg });
+  }
+  const meta = user.meta ?? {};
+  const lastApp = user.last_app ?? null;
+  const payload = {
+    status: "logged-in",
+    email: user.email ?? creds.email ?? null,
+    name: user.name ?? null,
+    role: typeof meta.role === "string" ? meta.role : null,
+    other_role: typeof meta.otherRole === "string" && meta.otherRole.length > 0 ? meta.otherRole : null,
+    intent: typeof meta.intent === "string" ? meta.intent : null,
+    last_app: lastApp ? {
+      id: lastApp.id,
+      name: lastApp.name,
+      region: lastApp.region,
+      industry: lastApp.industry ?? null,
+      technology: lastApp.technology ?? null,
+      product: lastApp.product ?? null
+    } : null
+  };
+  if (json) {
+    console.log(JSON.stringify(payload, null, 2));
+    return 0;
+  }
+  console.log("");
+  console.log(`  \u2713 ${payload.email ?? "(no email on profile)"}`);
+  if (payload.name) console.log(`    Name:   ${payload.name}`);
+  console.log(`    Role:   ${payload.role ?? "(not set)"}${payload.other_role ? ` (${payload.other_role})` : ""}`);
+  console.log(`    Intent: ${payload.intent ?? "(not set)"}`);
+  if (payload.last_app) {
+    const la = payload.last_app;
+    console.log(`    Last app: ${la.name} (${la.region})`);
+    if (la.industry || la.technology || la.product) {
+      const bits = [
+        la.industry && `industry=${la.industry}`,
+        la.technology && `tech=${la.technology}`,
+        la.product && `product=${la.product}`
+      ].filter(Boolean);
+      console.log(`              ${bits.join(", ")}`);
+    }
+  }
+  console.log("");
+  return 0;
+}
+function printError(json, payload) {
+  if (json) {
+    console.log(JSON.stringify(payload, null, 2));
+  } else {
+    console.error(`\u2717 ${payload.error ?? payload.status}`);
+    if (payload.next_step) console.error(`  ${payload.next_step}`);
+  }
+  return 1;
+}
 async function authLogout(args) {
   const json = isJsonMode18(args);
   const verbose = args.flags.verbose === true || args.flags.verbose === "true";
@@ -7934,7 +8552,7 @@ async function provisionSetup(args) {
     return 1;
   }
   if (!frameworkFlag) {
-    const msg = "Missing --framework. One of: reactjs, nextjs, react-router, astro, expo, react-native.";
+    const msg = "Missing --framework. One of: reactjs, nextjs, react-router, astro, expo, react-native, angular, android, flutter, ios.";
     if (json) return emitError(true, msg);
     console.error(msg);
     return 1;
@@ -8025,8 +8643,29 @@ var ENV_PREFIX_BY_FRAMEWORK = {
   "react-router": "VITE_",
   astro: "PUBLIC_",
   expo: "EXPO_PUBLIC_",
-  "react-native": ""
+  "react-native": "",
   // bare RN uses react-native-dotenv — no prefix
+  angular: "",
+  // Angular reads from src/environments/environment.ts; CLI writes
+  // a no-prefix .env as a credentials handoff, and the skill
+  // migrates the values into environment.ts during integration
+  android: "",
+  // Android reads from local.properties → BuildConfig at compile
+  // time. CLI writes a no-prefix .env handoff; the skill teaches
+  // the user to mirror values into local.properties + add
+  // buildConfigField entries to app/build.gradle.
+  flutter: "",
+  // Flutter has no runtime .env. Credentials come from
+  // --dart-define flags or a generated config Dart file. CLI
+  // writes a no-prefix .env handoff; the skill teaches the
+  // integration agent how to wire creds (typically a
+  // const-class file + runner script with --dart-define).
+  ios: ""
+  // iOS has no runtime .env. Credentials live in a
+  // Secrets.swift const file (gitignored) or get injected
+  // via xcconfig build settings. CLI writes a no-prefix
+  // .env handoff for the agent; the skill teaches the
+  // Secrets.swift / xcconfig migration.
 };
 async function provisionList(args) {
   const json = isJsonMode19(args);

package/dist/registry/v6/features/catalog.json

@@ -5,7 +5,9 @@
   "description": "Catalog of CometChat features available in the React UI Kit. Categorized by what work is needed to enable each one. NOTE: this catalog stores OUR taxonomy (default vs dashboard-toggle vs package-install vs component-swap) plus a `dashboard_path` HINT for navigation. The hint is short and intentionally fragile — the canonical source is always the docs URL constructed from `docs_topic`. Agents must query the cometchat-docs MCP at runtime for current dashboard navigation, prop signatures, builder methods, and SDK reference. This catalog is for routing, not for SDK reference.",
   "feature_types": {
     "default": "Already enabled by default in the UI Kit components your integration uses. Zero code changes needed — the skill just shows you which component renders it.",
-    "dashboard-toggle": "Requires flipping a toggle in the CometChat Dashboard at https://app.cometchat.com. Some have their UI decorator auto-attached by the UI Kit (auto_wired_in_uikit: true) — the dashboard flip is the only thing needed. Others additionally require passing the extension to UIKitSettingsBuilder.setExtensions([...]) before init.",
+    "extension": "Pure boolean toggle on a backend extension. The CLI's `apply-feature` command calls POST /apps/{appId}/extensions to enable, no further config needed. Some have their UI decorator auto-attached by the UI Kit (auto_wired_in_uikit: true). Others additionally require passing the extension to UIKitSettingsBuilder.setExtensions([...]) before init.",
+    "ai-feature": "Backend AI feature toggle. Requires an OpenAI API key (PUT /apps/{appId}/ai/settings) before the feature can be enabled (POST /apps/{appId}/features/ai.{ai_key}/enabled). The CLI prompts for the key once, stores it on the app's settings, then enables the feature. The `ai_key` field is the API suffix.",
+    "dashboard-only": "Requires entering third-party config the user has to fetch themselves (Giphy/Stipop/Tenor API key, Chatwoot webhook URL, Intercom token, etc.) or making a multi-field configuration choice (Disappearing Messages interval, Message Shortcuts list). The CLI cannot automate these — falls back to opening the dashboard. `dashboard_path` is load-bearing for these entries.",
     "package-install": "Requires installing an additional npm package. The UI Kit's initiateAfterLogin() auto-calls enableCalling() which detects the calls SDK and wires up call buttons. Currently calls only.",
     "component-swap": "Requires replacing one UI Kit component with a drop-in variant. One-line change. The SDK currently ships exactly one such variant (CometChatCompactMessageComposer for rich text formatting); more variants will become catalog entries here as the SDK adds them."
   },
@@ -126,7 +128,7 @@
     {
       "id": "bitly",
       "name": "Bitly URL Shortening",
-      "type": "dashboard-toggle",
+      "type": "extension",
       "description": "Automatically shorten long URLs in messages using Bitly.",
       "dashboard_path": "Extensions → Bitly → Toggle on",
       "docs_topic": "extensions#bitly"
@@ -134,7 +136,7 @@
     {
       "id": "link-preview",
       "name": "Link Preview",
-      "type": "dashboard-toggle",
+      "type": "extension",
       "auto_wired_in_uikit": true,
       "description": "Show URL previews with title, description, and thumbnail. UI decorator auto-attached by the UI Kit (in defaultExtensions[]).",
       "dashboard_path": "Extensions → Link Preview → Toggle on",
@@ -143,7 +145,7 @@
     {
       "id": "message-shortcuts",
       "name": "Message Shortcuts",
-      "type": "dashboard-toggle",
+      "type": "dashboard-only",
       "description": "Expand predefined short codes into full messages.",
       "dashboard_path": "Extensions → Message Shortcuts → Configure shortcuts",
       "docs_topic": "extensions#message-shortcuts"
@@ -151,7 +153,7 @@
     {
       "id": "pin-message",
       "name": "Pin Message",
-      "type": "dashboard-toggle",
+      "type": "extension",
       "description": "Pin important messages for easy access.",
       "dashboard_path": "Extensions → Pin Message → Toggle on",
       "docs_topic": "extensions#pin-message"
@@ -159,7 +161,7 @@
     {
       "id": "rich-media-preview",
       "name": "Rich Media Preview",
-      "type": "dashboard-toggle",
+      "type": "extension",
       "description": "Generate rich preview panels for URLs via iFramely.",
       "dashboard_path": "Extensions → Rich Media Preview → Toggle on",
       "docs_topic": "extensions#rich-media-preview"
@@ -167,7 +169,7 @@
     {
       "id": "save-message",
       "name": "Save Message",
-      "type": "dashboard-toggle",
+      "type": "extension",
       "description": "Bookmark messages privately for later.",
       "dashboard_path": "Extensions → Save Message → Toggle on",
       "docs_topic": "extensions#save-message"
@@ -175,7 +177,7 @@
     {
       "id": "thumbnail-generation",
       "name": "Thumbnail Generation",
-      "type": "dashboard-toggle",
+      "type": "extension",
       "auto_wired_in_uikit": true,
       "description": "Auto-generate thumbnails for shared media to reduce bandwidth. UI decorator auto-attached by the UI Kit (in defaultExtensions[]).",
       "dashboard_path": "Extensions → Thumbnail Generation → Toggle on",
@@ -184,7 +186,7 @@
     {
       "id": "tinyurl",
       "name": "TinyURL Shortening",
-      "type": "dashboard-toggle",
+      "type": "extension",
       "description": "Shorten URLs using TinyURL service.",
       "dashboard_path": "Extensions → TinyURL → Toggle on",
       "docs_topic": "extensions#tinyurl"
@@ -192,7 +194,7 @@
     {
       "id": "voice-transcription",
       "name": "Voice Transcription",
-      "type": "dashboard-toggle",
+      "type": "extension",
       "description": "Convert audio messages to text automatically.",
       "dashboard_path": "Extensions → Voice Transcription → Toggle on",
       "docs_topic": "extensions#voice-transcription"
@@ -200,7 +202,7 @@
     {
       "id": "giphy",
       "name": "Giphy GIFs",
-      "type": "dashboard-toggle",
+      "type": "dashboard-only",
       "description": "Search and share GIFs from Giphy.",
       "dashboard_path": "Extensions → Giphy → Configure API key",
       "docs_topic": "extensions#giphy"
@@ -208,7 +210,7 @@
     {
       "id": "message-translation",
       "name": "Message Translation",
-      "type": "dashboard-toggle",
+      "type": "extension",
       "auto_wired_in_uikit": true,
       "description": "Translate messages into the user's locale. UI decorator auto-attached by the UI Kit (in defaultExtensions[]).",
       "dashboard_path": "Extensions → Message Translation → Toggle on",
@@ -217,7 +219,7 @@
     {
       "id": "polls",
       "name": "Polls",
-      "type": "dashboard-toggle",
+      "type": "extension",
       "auto_wired_in_uikit": true,
       "description": "Create polls in group discussions with preset answers. UI decorator auto-attached by the UI Kit (in defaultExtensions[]).",
       "dashboard_path": "Extensions → Polls → Toggle on",
@@ -226,7 +228,7 @@
     {
       "id": "reminders",
       "name": "Reminders",
-      "type": "dashboard-toggle",
+      "type": "extension",
       "description": "Set message reminders or personal notifications via bot.",
       "dashboard_path": "Extensions → Reminders → Toggle on",
       "docs_topic": "extensions#reminders"
@@ -234,7 +236,7 @@
     {
       "id": "stickers",
       "name": "Stickers",
-      "type": "dashboard-toggle",
+      "type": "extension",
       "auto_wired_in_uikit": true,
       "description": "Send pre-designed stickers in conversations. UI decorator auto-attached by the UI Kit (in defaultExtensions[]).",
       "dashboard_path": "Extensions → Stickers → Toggle on",
@@ -243,7 +245,7 @@
     {
       "id": "stipop",
       "name": "Stipop Sticker Library",
-      "type": "dashboard-toggle",
+      "type": "dashboard-only",
       "description": "Integrates the Stipop sticker library.",
       "dashboard_path": "Extensions → Stipop → Configure API key",
       "docs_topic": "extensions#stipop"
@@ -251,7 +253,7 @@
     {
       "id": "tenor",
       "name": "Tenor GIFs",
-      "type": "dashboard-toggle",
+      "type": "dashboard-only",
       "description": "Search and share GIFs from Tenor.",
       "dashboard_path": "Extensions → Tenor → Configure API key",
       "docs_topic": "extensions#tenor"
@@ -259,7 +261,7 @@
     {
       "id": "collaborative-document",
       "name": "Collaborative Document",
-      "type": "dashboard-toggle",
+      "type": "extension",
       "auto_wired_in_uikit": true,
       "description": "Real-time shared document editing. UI decorator auto-attached by the UI Kit (in defaultExtensions[]).",
       "dashboard_path": "Extensions → Collaborative Document → Toggle on",
@@ -268,7 +270,7 @@
     {
       "id": "collaborative-whiteboard",
       "name": "Collaborative Whiteboard",
-      "type": "dashboard-toggle",
+      "type": "extension",
       "auto_wired_in_uikit": true,
       "description": "Shared whiteboard for drawing and brainstorming. UI decorator auto-attached by the UI Kit (in defaultExtensions[]).",
       "dashboard_path": "Extensions → Collaborative Whiteboard → Toggle on",
@@ -277,7 +279,7 @@
     {
       "id": "disappearing-messages",
       "name": "Disappearing Messages",
-      "type": "dashboard-toggle",
+      "type": "dashboard-only",
       "description": "Messages auto-delete after a specified interval.",
       "dashboard_path": "Extensions → Disappearing Messages → Configure interval",
       "docs_topic": "extensions#disappearing-messages"
@@ -285,7 +287,7 @@
     {
       "id": "chatwoot",
       "name": "Chatwoot Integration",
-      "type": "dashboard-toggle",
+      "type": "dashboard-only",
       "description": "Route messages to Chatwoot for customer support.",
       "dashboard_path": "Extensions → Chatwoot → Configure webhook",
       "docs_topic": "extensions#chatwoot"
@@ -293,7 +295,7 @@
     {
       "id": "intercom",
       "name": "Intercom Integration",
-      "type": "dashboard-toggle",
+      "type": "dashboard-only",
       "description": "Integrate Intercom for in-app customer support.",
       "dashboard_path": "Extensions → Intercom → Configure API key",
       "docs_topic": "extensions#intercom"
@@ -301,7 +303,9 @@
     {
       "id": "conversation-starter",
       "name": "AI Conversation Starter",
-      "type": "dashboard-toggle",
+      "type": "ai-feature",
+      "ai_key": "conversation-starter",
+      "requires": "openai-key",
       "description": "AI-generated opening messages for new chats.",
       "dashboard_path": "AI Features → Conversation Starter → Toggle on",
       "docs_topic": "ai-features#conversation-starter"
@@ -309,7 +313,9 @@
     {
       "id": "smart-replies",
       "name": "AI Smart Replies",
-      "type": "dashboard-toggle",
+      "type": "ai-feature",
+      "ai_key": "smart-replies",
+      "requires": "openai-key",
       "description": "AI-generated contextual response suggestions.",
       "dashboard_path": "AI Features → Smart Replies → Toggle on",
       "docs_topic": "ai-features#smart-replies"
@@ -317,7 +323,9 @@
     {
       "id": "conversation-summary",
       "name": "AI Conversation Summary",
-      "type": "dashboard-toggle",
+      "type": "ai-feature",
+      "ai_key": "conversation-summary",
+      "requires": "openai-key",
       "description": "AI-generated recaps of extended conversations.",
       "dashboard_path": "AI Features → Conversation Summary → Toggle on",
       "docs_topic": "ai-features#conversation-summary"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cometchat/skills-cli",
-  "version": "2.2.0",
-  "description": "CLI for the CometChat skills v3 architecture — auth, provision, detect, apply, verify CometChat integrations in React/Next.js/React-Router/Astro/Expo/React-Native projects.",
+  "version": "2.3.0",
+  "description": "CLI for the CometChat skills v3 architecture — auth, provision, detect, apply, verify CometChat integrations in React/Next.js/React-Router/Astro/Expo/React-Native/Angular/Android/iOS/Flutter projects.",
   "type": "module",
   "license": "MIT",
   "bin": {
@@ -31,8 +31,8 @@
     "node": ">=18.0.0"
   },
   "devDependencies": {
-    "@types/node": "^20.0.0",
-    "esbuild": "^0.25.0",
+    "@types/node": "^25.6.0",
+    "esbuild": "^0.28.0",
     "tsx": "^4.19.0",
     "typescript": "^5.6.0"
   },