@poppinss/utils 7.0.0-next.5 → 7.0.0-next.6

package/README.md

@@ -627,6 +627,52 @@ const rawValue = secret.release()
 rawValue === opaque_raw_token // true
 ```
 
+## AI Agent Detection
+
+Detect if your code is running inside an AI coding assistant. This is useful for adjusting application behavior when running under AI agents (e.g., disabling prompts, adjusting logging, or enabling special debugging modes).
+
+### detectAIAgent
+
+Returns the name of the detected AI agent or `null` if none is detected.
+
+```ts
+import { detectAIAgent } from '@poppinss/utils'
+
+const agent = detectAIAgent()
+
+if (agent === 'claude') {
+  console.log('Running in Claude Code')
+} else if (agent === 'copilot') {
+  console.log('Running in GitHub Copilot')
+}
+```
+
+**Supported agents:**
+
+| Agent           | Environment Variable(s)                                      | Return Value |
+| --------------- | ------------------------------------------------------------ | ------------ |
+| Claude Code     | `CLAUDECODE='1'`                                             | `'claude'`   |
+| Gemini          | `GEMINI_CLI='1'`                                             | `'gemini'`   |
+| GitHub Copilot  | `GITHUB_COPILOT_CLI_MODE='1'`                                | `'copilot'`  |
+| Windsurf        | `WINDSURF_SESSION='1'` or `TERM_PROGRAM='windsurf'`          | `'windsurf'` |
+| Codex           | `CODEX_CLI='1'` or `CODEX_SANDBOX='1'`                       | `'codex'`    |
+| OpenCode        | `OPENCODE='1'`                                               | `'opencode'` |
+| Cursor          | `CURSOR_AGENT='1'`                                           | `'cursor'`   |
+
+### isRunningInAIAgent
+
+Returns `true` if the code is running inside any AI coding agent.
+
+```ts
+import { isRunningInAIAgent } from '@poppinss/utils'
+
+if (isRunningInAIAgent()) {
+  // Disable interactive prompts
+  // Enable verbose logging
+  // Skip waiting for user input
+}
+```
+
 ## ImportsBag
 
 The `ImportsBag` class helps you manage and deduplicate import statements when generating code. It automatically merges imports from the same source and generates properly formatted import statements.

package/build/index.d.ts

@@ -8,3 +8,4 @@ export { importDefault } from './src/import_default.js';
 export { MessageBuilder } from './src/message_builder.js';
 export { ImportsBag, type ImportInfo } from './src/imports_bag.js';
 export { defineStaticProperty } from './src/define_static_property.js';
+export { detectAIAgent, isRunningInAIAgent } from './src/detect_ai_agent.js';

package/build/index.js

@@ -95,13 +95,19 @@ var ImportsBag = class {
 			if (imp.namedImports && imp.namedImports.length > 0) importParts.push(`{ ${imp.namedImports.join(", ")} }`);
 			parts.push(`import ${importParts.join(", ")} from '${imp.source}'`);
 		}
-		if (imp.typeImports && imp.typeImports.length > 0) parts.push(`import type { ${imp.typeImports.join(", ")} } from '${imp.source}'`);
+		if (imp.defaultTypeImport || imp.typeImports && imp.typeImports.length > 0) {
+			const typeImportParts = [];
+			if (imp.defaultTypeImport) typeImportParts.push(imp.defaultTypeImport);
+			if (imp.typeImports && imp.typeImports.length > 0) typeImportParts.push(`{ ${imp.typeImports.join(", ")} }`);
+			parts.push(`import type ${typeImportParts.join(", ")} from '${imp.source}'`);
+		}
 		return parts.join("\n");
 	}
 	add(importInfo) {
 		const existing = this.#imports.get(importInfo.source);
 		if (existing) {
 			if (importInfo.defaultImport) existing.defaultImport = importInfo.defaultImport;
+			if (importInfo.defaultTypeImport) existing.defaultTypeImport = importInfo.defaultTypeImport;
 			if (importInfo.namedImports) {
 				if (!existing.namedImports) existing.namedImports = [];
 				existing.namedImports.push(...importInfo.namedImports);
@@ -113,6 +119,7 @@ var ImportsBag = class {
 		} else this.#imports.set(importInfo.source, {
 			source: importInfo.source,
 			defaultImport: importInfo.defaultImport,
+			defaultTypeImport: importInfo.defaultTypeImport,
 			namedImports: importInfo.namedImports ? [...importInfo.namedImports] : void 0,
 			typeImports: importInfo.typeImports ? [...importInfo.typeImports] : void 0
 		});
@@ -122,6 +129,7 @@ var ImportsBag = class {
 		return Array.from(this.#imports.values()).map((imp) => ({
 			source: imp.source,
 			defaultImport: imp.defaultImport,
+			defaultTypeImport: imp.defaultTypeImport,
 			namedImports: imp.namedImports ? [...new Set(imp.namedImports)] : void 0,
 			typeImports: imp.typeImports ? [...new Set(imp.typeImports)] : void 0
 		}));
@@ -151,4 +159,17 @@ function defineStaticProperty(self, propertyName, { initialValue, strategy }) {
 		});
 	}
 }
-export { ImportsBag, MessageBuilder, Secret, compose, defineStaticProperty, flatten, importDefault, isScriptFile, naturalSort, safeEqual };
+function detectAIAgent() {
+	if (process.env.CLAUDECODE === "1") return "claude";
+	if (process.env.GEMINI_CLI === "1") return "gemini";
+	if (process.env.GITHUB_COPILOT_CLI_MODE === "1") return "copilot";
+	if (process.env.WINDSURF_SESSION === "1" || process.env.TERM_PROGRAM === "windsurf") return "windsurf";
+	if (process.env.CODEX_CLI === "1" || process.env.CODEX_SANDBOX === "1") return "codex";
+	if (process.env.OPENCODE === "1") return "opencode";
+	if (process.env.CURSOR_AGENT === "1") return "cursor";
+	return null;
+}
+function isRunningInAIAgent() {
+	return detectAIAgent() !== null;
+}
+export { ImportsBag, MessageBuilder, Secret, compose, defineStaticProperty, detectAIAgent, flatten, importDefault, isRunningInAIAgent, isScriptFile, naturalSort, safeEqual };

package/build/src/detect_ai_agent.d.ts

@@ -0,0 +1,18 @@
+type AIAgent = 'claude' | 'cursor' | 'opencode' | 'gemini' | 'copilot' | 'windsurf' | 'codex';
+/**
+ * Detects which AI coding agent the code is running under.
+ * Checks for environment variables set by different AI coding assistants:
+ * - CLAUDECODE='1' for Claude Code
+ * - GEMINI_CLI='1' for Gemini
+ * - GITHUB_COPILOT_CLI_MODE='1' for GitHub Copilot
+ * - WINDSURF_SESSION='1' or TERM_PROGRAM='windsurf' for Windsurf
+ * - CODEX_CLI='1' or CODEX_SANDBOX='1' for Codex
+ * - OPENCODE='1' for OpenCode
+ * - CURSOR_AGENT='1' for Cursor
+ */
+export declare function detectAIAgent(): AIAgent | null;
+/**
+ * Returns true if the code is running within any AI coding agent.
+ */
+export declare function isRunningInAIAgent(): boolean;
+export {};

package/build/src/imports_bag.d.ts

@@ -1,6 +1,7 @@
 export type ImportInfo = {
     source: string;
     defaultImport?: string;
+    defaultTypeImport?: string;
     namedImports?: string[];
     typeImports?: string[];
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poppinss/utils",
-  "version": "7.0.0-next.5",
+  "version": "7.0.0-next.6",
   "description": "Handy utilities for repetitive work",
   "main": "build/index.js",
   "type": "module",