@agentuity/cli 0.1.37 → 0.1.38

package/bin/cli.ts

@@ -19,6 +19,12 @@ import { closeDatabase } from '../src/cache';
 import { createInternalLogger } from '../src/internal-logger';
 import { createCompositeLogger } from '../src/composite-logger';
 import { getAuth } from '../src/config';
+import {
+	startAgentDetection,
+	isExecutingFromAgent,
+	onAgentDetected,
+	flushAgentDetection,
+} from '../src/agent-detection';
 
 /**
  * Extract --dir flag from process.argv before command parsing
@@ -80,6 +86,10 @@ process.on('SIGTERM', () => {
 validateRuntime();
 await ensureBunOnPath();
 
+// Start agent detection early (non-blocking) so it runs in the background
+// while the rest of CLI initialization happens
+startAgentDetection();
+
 // Preprocess arguments to convert --help=json to --help json
 // Commander.js doesn't support --option=value syntax for optional values
 const preprocessedArgs = process.argv.slice(2).flatMap((arg) => {
@@ -217,6 +227,13 @@ if (shouldSkipInternalLogging) {
 
 	// Set session ID in environment so forked child processes can share the same log file
 	process.env.AGENTUITY_INTERNAL_SESSION_ID = internalLogger.getSessionId();
+
+	// Register callback to update session with detected agent (non-blocking)
+	onAgentDetected((agent) => {
+		if (agent) {
+			internalLogger.setDetectedAgent(agent);
+		}
+	});
 }
 
 // Create composite logger that writes to both console and internal log
@@ -243,6 +260,7 @@ const ctx = {
 	config,
 	logger,
 	options: earlyOpts,
+	isExecutingFromAgent,
 };
 
 // Set global output options for utilities to use
@@ -275,6 +293,8 @@ await registerCommands(program, commands, ctx as unknown as CommandContext);
 
 try {
 	await program.parseAsync(process.argv);
+	// Flush agent detection to ensure it's written to session logs before exit
+	await flushAgentDetection();
 } catch (error) {
 	// eslint-disable-next-line @typescript-eslint/no-explicit-any
 	const exit = (globalThis as any).AGENTUITY_PROCESS_EXIT || process.exit;

package/dist/agent-detection.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Map of process names to internal agent short names.
+ * The key is the process name (or substring) that appears in the parent process command line.
+ * The value is the internal short name used to identify the agent.
+ *
+ * Process names verified via `agentuity cloud sandbox run --runtime <agent>:latest`:
+ * - opencode: binary 'opencode' (from bun install -g opencode-ai)
+ * - codex: binary 'codex' (from npm install -g @openai/codex)
+ * - cursor: binary 'cursor-agent' (from curl installer)
+ * - claude-code: binary 'claude', shows as 'node /usr/local/bin/claude'
+ * - copilot: binary 'copilot', shows as 'node /usr/local/bin/copilot' and spawns native binary
+ * - gemini: binary 'gemini', shows as 'node /usr/local/bin/gemini'
+ * - amp: binary 'amp', shows as 'node --no-warnings /usr/local/bin/amp'
+ *
+ * IMPORTANT: Order matters! More specific patterns should come before less specific ones.
+ * For example, 'opencode' must be checked before 'code' to avoid false matches.
+ */
+export declare const KNOWN_AGENTS: [string, string][];
+export type KnownAgent = (typeof KNOWN_AGENTS)[number][1];
+/**
+ * Start agent detection immediately (non-blocking).
+ * Call this early in CLI startup to begin detection in the background.
+ */
+export declare function startAgentDetection(): void;
+/**
+ * Register a callback to be invoked when agent detection completes.
+ * If detection has already completed, the callback is invoked immediately.
+ * This is non-blocking and does not return a promise.
+ *
+ * @example
+ * ```typescript
+ * onAgentDetected((agent) => {
+ *   if (agent) {
+ *     console.log(`Detected agent: ${agent}`);
+ *   }
+ * });
+ * ```
+ */
+export declare function onAgentDetected(callback: (agent: string | undefined) => void): void;
+/**
+ * Get the cached detection result synchronously.
+ * Returns undefined if detection hasn't completed yet or no agent was detected.
+ * Returns null if detection hasn't started or completed yet.
+ *
+ * Use this for synchronous access when you don't want to wait for detection.
+ */
+export declare function getDetectedAgent(): string | undefined | null;
+/**
+ * Wait for agent detection to complete and ensure all callbacks have been invoked.
+ * Call this before CLI exit to ensure the detected agent is written to session logs.
+ *
+ * This is a no-op if detection hasn't started or has already completed.
+ */
+export declare function flushAgentDetection(): Promise<void>;
+/**
+ * Check if the CLI is being executed from a known coding agent.
+ * Returns the agent name if detected, undefined otherwise.
+ *
+ * This function returns immediately if detection has already completed,
+ * otherwise it awaits the detection promise started by startAgentDetection().
+ *
+ * @example
+ * ```typescript
+ * const agent = await isExecutingFromAgent();
+ * if (agent) {
+ *   logger.debug(`Running from agent: ${agent}`);
+ * }
+ * ```
+ */
+export declare function isExecutingFromAgent(): Promise<string | undefined>;
+//# sourceMappingURL=agent-detection.d.ts.map

package/dist/agent-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-detection.d.ts","sourceRoot":"","sources":["../src/agent-detection.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAgB1C,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAwH1D;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAkB1C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,GAAG,IAAI,CAanF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,SAAS,GAAG,IAAI,CAE5D;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAIzD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAaxE"}

package/dist/agent-detection.js

@@ -0,0 +1,232 @@
+import { spawn } from 'node:child_process';
+/**
+ * Map of process names to internal agent short names.
+ * The key is the process name (or substring) that appears in the parent process command line.
+ * The value is the internal short name used to identify the agent.
+ *
+ * Process names verified via `agentuity cloud sandbox run --runtime <agent>:latest`:
+ * - opencode: binary 'opencode' (from bun install -g opencode-ai)
+ * - codex: binary 'codex' (from npm install -g @openai/codex)
+ * - cursor: binary 'cursor-agent' (from curl installer)
+ * - claude-code: binary 'claude', shows as 'node /usr/local/bin/claude'
+ * - copilot: binary 'copilot', shows as 'node /usr/local/bin/copilot' and spawns native binary
+ * - gemini: binary 'gemini', shows as 'node /usr/local/bin/gemini'
+ * - amp: binary 'amp', shows as 'node --no-warnings /usr/local/bin/amp'
+ *
+ * IMPORTANT: Order matters! More specific patterns should come before less specific ones.
+ * For example, 'opencode' must be checked before 'code' to avoid false matches.
+ */
+export const KNOWN_AGENTS = [
+    // Verified via cloud sandbox runtime - most specific patterns first
+    ['opencode', 'opencode'],
+    ['codex', 'codex'],
+    ['cursor-agent', 'cursor'],
+    ['claude', 'claude-code'],
+    ['copilot', 'copilot'],
+    ['gemini', 'gemini'],
+    ['cline', 'cline'],
+    ['roo-code', 'roo'],
+    ['windsurf', 'windsurf'],
+    ['zed', 'zed'],
+    ['amp', 'amp'],
+    // TODO: VSCode Agent Mode detection - need to find a reliable way to detect
+    // when VSCode's built-in agent (Copilot Chat) is running commands vs just
+    // running in VSCode's integrated terminal. May need env var detection.
+];
+/**
+ * Promise for the detection result (set when detection starts)
+ */
+let detectionPromise = null;
+/**
+ * Cached result after detection completes (null = not yet resolved)
+ */
+let cachedResult = null;
+/**
+ * Callbacks to invoke when agent detection completes
+ */
+const detectionCallbacks = [];
+/**
+ * Get the command line and parent PID for a given PID in a single ps call
+ */
+function getProcessInfo(pid) {
+    return new Promise((resolve) => {
+        const ps = spawn('ps', ['-p', String(pid), '-o', 'ppid=,command='], {
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+        let output = '';
+        ps.stdout.on('data', (data) => {
+            output += data.toString();
+        });
+        ps.on('close', () => {
+            const trimmed = output.trim();
+            if (!trimmed) {
+                resolve(undefined);
+                return;
+            }
+            // Output format: "  PPID COMMAND" (ppid is right-aligned, then space, then command)
+            const match = trimmed.match(/^\s*(\d+)\s+(.+)$/);
+            if (!match) {
+                resolve(undefined);
+                return;
+            }
+            const ppid = parseInt(match[1], 10);
+            const command = match[2].toLowerCase();
+            if (isNaN(ppid) || ppid <= 1 || !command) {
+                resolve(undefined);
+                return;
+            }
+            resolve({ command, ppid });
+        });
+        ps.on('error', () => {
+            resolve(undefined);
+        });
+    });
+}
+/**
+ * Check if a command matches any known agent
+ */
+function matchAgent(command) {
+    for (const [processName, agentName] of KNOWN_AGENTS) {
+        if (command.includes(processName)) {
+            return agentName;
+        }
+    }
+    return undefined;
+}
+/**
+ * Detect the parent process command and check if it matches a known agent.
+ * Walks up the process tree to find the first matching agent.
+ */
+function detectParentAgent() {
+    return new Promise((resolve) => {
+        // TODO: Implement Windows support using wmic or PowerShell
+        if (process.platform === 'win32') {
+            resolve(undefined);
+            return;
+        }
+        const maxDepth = 10; // Limit how far up we walk the tree
+        async function walkTree(pid, depth) {
+            if (depth >= maxDepth || pid <= 1) {
+                return undefined;
+            }
+            // Get both command and parent PID in a single ps call
+            const info = await getProcessInfo(pid);
+            if (!info) {
+                return undefined;
+            }
+            // Check if this process matches a known agent
+            const agent = matchAgent(info.command);
+            if (agent) {
+                return agent;
+            }
+            // Walk up to parent
+            return walkTree(info.ppid, depth + 1);
+        }
+        const ppid = process.ppid;
+        if (!ppid) {
+            resolve(undefined);
+            return;
+        }
+        walkTree(ppid, 0).then(resolve).catch(() => resolve(undefined));
+    });
+}
+/**
+ * Start agent detection immediately (non-blocking).
+ * Call this early in CLI startup to begin detection in the background.
+ */
+export function startAgentDetection() {
+    if (detectionPromise !== null) {
+        // Already started
+        return;
+    }
+    detectionPromise = detectParentAgent().then((result) => {
+        cachedResult = result;
+        // Invoke all registered callbacks
+        for (const callback of detectionCallbacks) {
+            try {
+                callback(result);
+            }
+            catch {
+                // Ignore callback errors
+            }
+        }
+        return result;
+    });
+}
+/**
+ * Register a callback to be invoked when agent detection completes.
+ * If detection has already completed, the callback is invoked immediately.
+ * This is non-blocking and does not return a promise.
+ *
+ * @example
+ * ```typescript
+ * onAgentDetected((agent) => {
+ *   if (agent) {
+ *     console.log(`Detected agent: ${agent}`);
+ *   }
+ * });
+ * ```
+ */
+export function onAgentDetected(callback) {
+    // If detection already completed, invoke immediately
+    if (cachedResult !== null) {
+        try {
+            callback(cachedResult);
+        }
+        catch {
+            // Ignore callback errors
+        }
+        return;
+    }
+    // Otherwise, register for later invocation
+    detectionCallbacks.push(callback);
+}
+/**
+ * Get the cached detection result synchronously.
+ * Returns undefined if detection hasn't completed yet or no agent was detected.
+ * Returns null if detection hasn't started or completed yet.
+ *
+ * Use this for synchronous access when you don't want to wait for detection.
+ */
+export function getDetectedAgent() {
+    return cachedResult;
+}
+/**
+ * Wait for agent detection to complete and ensure all callbacks have been invoked.
+ * Call this before CLI exit to ensure the detected agent is written to session logs.
+ *
+ * This is a no-op if detection hasn't started or has already completed.
+ */
+export async function flushAgentDetection() {
+    if (detectionPromise !== null) {
+        await detectionPromise;
+    }
+}
+/**
+ * Check if the CLI is being executed from a known coding agent.
+ * Returns the agent name if detected, undefined otherwise.
+ *
+ * This function returns immediately if detection has already completed,
+ * otherwise it awaits the detection promise started by startAgentDetection().
+ *
+ * @example
+ * ```typescript
+ * const agent = await isExecutingFromAgent();
+ * if (agent) {
+ *   logger.debug(`Running from agent: ${agent}`);
+ * }
+ * ```
+ */
+export async function isExecutingFromAgent() {
+    // Return cached result if detection has completed
+    if (cachedResult !== null) {
+        return cachedResult;
+    }
+    // If detection hasn't started yet, start it now
+    if (detectionPromise === null) {
+        startAgentDetection();
+    }
+    // Wait for detection to complete
+    return detectionPromise;
+}
+//# sourceMappingURL=agent-detection.js.map

package/dist/agent-detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-detection.js","sourceRoot":"","sources":["../src/agent-detection.ts"],"names":[],"mappings":"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"}

package/dist/cache/index.d.ts

@@ -1,2 +1,3 @@
 export { getResourceInfo, getResourceRegion, setResourceInfo, setResourceRegion, deleteResourceRegion, clearProfileCache, closeDatabase, type ResourceType, type ResourceInfo, } from './resource-region';
+export { getCachedProject, setCachedProject, clearProjectCache } from './project-cache';
 //# sourceMappingURL=index.d.ts.map

package/dist/cache/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,YAAY,GACjB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,YAAY,GACjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/cache/index.js

@@ -1,2 +1,3 @@
 export { getResourceInfo, getResourceRegion, setResourceInfo, setResourceRegion, deleteResourceRegion, clearProfileCache, closeDatabase, } from './resource-region';
+export { getCachedProject, setCachedProject, clearProjectCache } from './project-cache';
 //# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,GAGb,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,GAGb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/cache/project-cache.d.ts

@@ -0,0 +1,16 @@
+import type { Project } from '@agentuity/server';
+/**
+ * Get a cached project by profile and project ID.
+ * Returns null if not found in cache.
+ */
+export declare function getCachedProject(profile: string, projectId: string): Project | null;
+/**
+ * Store a project in the cache.
+ */
+export declare function setCachedProject(profile: string, projectId: string, project: Project): void;
+/**
+ * Clear all cached projects.
+ * Useful for testing or when switching contexts.
+ */
+export declare function clearProjectCache(): void;
+//# sourceMappingURL=project-cache.d.ts.map

package/dist/cache/project-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-cache.d.ts","sourceRoot":"","sources":["../../src/cache/project-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAiBjD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAGnF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAG3F;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/cache/project-cache.js

@@ -0,0 +1,36 @@
+/**
+ * In-memory cache for project data to avoid duplicate API calls within a single CLI command execution.
+ * This cache is NOT persisted to disk - it only lives for the duration of the CLI process.
+ *
+ * The cache key is `{profile}:{projectId}` to ensure proper isolation between profiles.
+ */
+const projectCache = new Map();
+/**
+ * Generate a cache key from profile and project ID
+ */
+function getCacheKey(profile, projectId) {
+    return `${profile}:${projectId}`;
+}
+/**
+ * Get a cached project by profile and project ID.
+ * Returns null if not found in cache.
+ */
+export function getCachedProject(profile, projectId) {
+    const key = getCacheKey(profile, projectId);
+    return projectCache.get(key) ?? null;
+}
+/**
+ * Store a project in the cache.
+ */
+export function setCachedProject(profile, projectId, project) {
+    const key = getCacheKey(profile, projectId);
+    projectCache.set(key, project);
+}
+/**
+ * Clear all cached projects.
+ * Useful for testing or when switching contexts.
+ */
+export function clearProjectCache() {
+    projectCache.clear();
+}
+//# sourceMappingURL=project-cache.js.map

package/dist/cache/project-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-cache.js","sourceRoot":"","sources":["../../src/cache/project-cache.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,YAAY,GAAG,IAAI,GAAG,EAAmB,CAAC;AAEhD;;GAEG;AACH,SAAS,WAAW,CAAC,OAAe,EAAE,SAAiB;IACtD,OAAO,GAAG,OAAO,IAAI,SAAS,EAAE,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,SAAiB;IAClE,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC5C,OAAO,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,SAAiB,EAAE,OAAgB;IACpF,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC5C,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAChC,YAAY,CAAC,KAAK,EAAE,CAAC;AACtB,CAAC"}

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EACX,iBAAiB,EAEjB,cAAc,EAQd,MAAM,SAAS,CAAC;AAgcjB,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA4MjE;AA6jCD,wBAAsB,gBAAgB,CACrC,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,OAAO,EAAE,cAAc,GACrB,OAAO,CAAC,IAAI,CAAC,CAiOf"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EACX,iBAAiB,EAEjB,cAAc,EAQd,MAAM,SAAS,CAAC;AAicjB,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA4MjE;AAokCD,wBAAsB,gBAAgB,CACrC,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,OAAO,EAAE,cAAc,GACrB,OAAO,CAAC,IAAI,CAAC,CAiOf"}

package/dist/cli.js

@@ -15,6 +15,7 @@ import { getCommand } from './command-prefix';
 import { isValidateMode, outputValidation } from './output';
 import { StructuredError } from '@agentuity/core';
 import { setProgram } from './program-ref';
+import { getCachedProject, setCachedProject } from './cache';
 /**
  * Check if an error is a CLI input validation error (Zod error from schema parsing),
  * and not an API response validation error (ValidationOutputError).
@@ -835,8 +836,15 @@ async function registerSubcommand(parent, subcommand, baseCtx, hidden) {
                             },
                         };
                         const apiClient = createAPIClient(baseCtx, configWithAuth);
-                        const { projectGet } = await import('@agentuity/server');
-                        const projectDetails = await projectGet(apiClient, { id: projectId, mask: true });
+                        // Check cache first to avoid duplicate API calls
+                        const profile = baseCtx.config?.name ?? 'default';
+                        let projectDetails = getCachedProject(profile, projectId);
+                        if (!projectDetails) {
+                            const { projectGet } = await import('@agentuity/server');
+                            // Use keys: false to match other callers and ensure cache consistency
+                            projectDetails = await projectGet(apiClient, { id: projectId, keys: false });
+                            setCachedProject(profile, projectId, projectDetails);
+                        }
                         project = {
                             projectId: projectDetails.id,
                             orgId: projectDetails.orgId,