@agentuity/cli 3.0.0-alpha.4 → 3.0.0-alpha.7

package/src/utils/dependency-checker.ts

@@ -1,205 +0,0 @@
-import { $ } from 'bun';
-import { join } from 'node:path';
-import { readFileSync, writeFileSync } from 'node:fs';
-import { getVersion } from '../version';
-import type { Logger } from '../types';
-
-interface PackageJson {
-	dependencies?: Record<string, string>;
-	devDependencies?: Record<string, string>;
-}
-
-export interface UpgradeResult {
-	upgraded: string[];
-	skipped: string[];
-	failed: string[];
-}
-
-/**
- * Checks if a version specifier should be upgraded
- * @param specifier - The version specifier from package.json (e.g., "latest", "^1.0.0", "1.2.3")
- * @returns true if the package should be upgraded
- */
-export function shouldUpgradeVersion(specifier: string): boolean {
-	// Always upgrade "latest" and "*"
-	if (specifier === 'latest' || specifier === '*') {
-		return true;
-	}
-
-	// Skip pinned versions (exact semver like "1.2.3")
-	if (/^\d+\.\d+\.\d+(-[a-zA-Z0-9.-]+)?$/.test(specifier)) {
-		return false;
-	}
-
-	// Upgrade ranges (^1.0.0, ~1.0.0, >=1.0.0, etc.)
-	// Check if the specifier is a range pattern
-	if (/^[~^>=<]/.test(specifier)) {
-		return true;
-	}
-
-	// Default to not upgrading if we can't determine
-	return false;
-}
-
-/**
- * Check and upgrade @agentuity/* dependencies to match CLI version
- * @param projectDir - Root directory of the user's project
- * @param logger - Logger instance
- * @returns Result of the upgrade operation
- */
-export async function checkAndUpgradeDependencies(
-	projectDir: string,
-	logger: Logger
-): Promise<UpgradeResult> {
-	const result: UpgradeResult = {
-		upgraded: [],
-		skipped: [],
-		failed: [],
-	};
-
-	const cliVersion = getVersion();
-	logger.debug('CLI version: %s', cliVersion);
-
-	// check if this is a canary and if so, skip this check
-	if (cliVersion.includes('-')) {
-		return result;
-	}
-
-	const packageJsonPath = join(projectDir, 'package.json');
-	// Read package.json
-	let packageJson: PackageJson;
-	try {
-		packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
-	} catch (error) {
-		logger.debug('Failed to read package.json: %s', error);
-		return result;
-	}
-
-	// Collect all @agentuity/* packages and their original specifiers
-	const allDeps = {
-		...packageJson.dependencies,
-		...packageJson.devDependencies,
-	};
-
-	const agentuitPackages = Object.entries(allDeps)
-		.filter(([name]) => name.startsWith('@agentuity/'))
-		.map(([name, specifier]) => ({ name, specifier }));
-
-	if (agentuitPackages.length === 0) {
-		logger.debug('No @agentuity/* packages found in package.json');
-		return result;
-	}
-
-	// Check which packages need upgrading
-	const packagesToUpgrade = agentuitPackages.filter(({ specifier }) =>
-		shouldUpgradeVersion(specifier)
-	);
-
-	if (packagesToUpgrade.length === 0) {
-		logger.debug('All @agentuity/* packages are pinned, skipping upgrade');
-		for (const pkg of agentuitPackages) {
-			result.skipped.push(pkg.name);
-		}
-		return result;
-	}
-
-	// Check if CLI version is different from installed packages
-	let needsUpgrade = false;
-	for (const { name } of packagesToUpgrade) {
-		try {
-			const installedPackageJson = JSON.parse(
-				readFileSync(join(projectDir, 'node_modules', name, 'package.json'), 'utf-8')
-			);
-			const installedVersion: string = installedPackageJson.version;
-			if (installedVersion !== cliVersion) {
-				logger.debug(
-					'%s: installed=%s, cli=%s (needs upgrade)',
-					name,
-					installedVersion,
-					cliVersion
-				);
-				needsUpgrade = true;
-			} else {
-				logger.debug('%s: already at correct version %s', name, installedVersion);
-			}
-		} catch {
-			// Package not installed or can't read version - needs upgrade
-			logger.debug('%s: not installed or unreadable, needs upgrade', name);
-			needsUpgrade = true;
-		}
-	}
-
-	if (!needsUpgrade) {
-		logger.debug('All @agentuity/* packages are already at CLI version');
-		for (const pkg of packagesToUpgrade) {
-			result.skipped.push(pkg.name);
-		}
-		return result;
-	}
-
-	// Upgrade packages
-	logger.debug('Upgrading %d @agentuity/* package(s) to %s', packagesToUpgrade.length, cliVersion);
-
-	for (const { name } of packagesToUpgrade) {
-		try {
-			logger.debug('Installing %s@%s', name, cliVersion);
-			const installResult = await $`bun add ${name}@${cliVersion}`
-				.cwd(projectDir)
-				.quiet()
-				.nothrow();
-
-			if (installResult.exitCode !== 0) {
-				logger.error(
-					'Failed to install %s@%s: %s',
-					name,
-					cliVersion,
-					installResult.stderr.toString()
-				);
-				result.failed.push(name);
-			} else {
-				logger.debug('Successfully installed %s@%s', name, cliVersion);
-				result.upgraded.push(name);
-			}
-		} catch (_error) {
-			logger.error('Error installing %s: %s', name, _error);
-			result.failed.push(name);
-		}
-	}
-
-	// Restore original version specifiers in package.json
-	// (bun add replaces them with specific versions)
-	if (result.upgraded.length > 0) {
-		try {
-			const updatedPackageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
-			let modified = false;
-
-			for (const { name, specifier } of packagesToUpgrade) {
-				// Only restore if we successfully upgraded
-				if (!result.upgraded.includes(name)) {
-					continue;
-				}
-
-				// Check both dependencies and devDependencies
-				if (updatedPackageJson.dependencies?.[name]) {
-					updatedPackageJson.dependencies[name] = specifier;
-					modified = true;
-					logger.debug('Restored %s to "%s" in dependencies', name, specifier);
-				}
-				if (updatedPackageJson.devDependencies?.[name]) {
-					updatedPackageJson.devDependencies[name] = specifier;
-					modified = true;
-					logger.debug('Restored %s to "%s" in devDependencies', name, specifier);
-				}
-			}
-
-			if (modified) {
-				writeFileSync(packageJsonPath, JSON.stringify(updatedPackageJson, null, 2) + '\n');
-				logger.debug('Restored original version specifiers in package.json');
-			}
-		} catch (_error) {
-			logger.warn('Failed to restore version specifiers in package.json: %s', _error);
-		}
-	}
-
-	return result;
-}

package/src/utils/detectSubagent.ts

@@ -1,36 +0,0 @@
-import { toForwardSlash } from './normalize-path';
-
-/**
- * Detects if a file path represents a subagent based on path structure.
- *
- * Subagents follow the pattern: agent/parent/child/agent.ts or agent/parent/child/route.ts
- * The path structure is currently hardcoded to 4 segments but could be made configurable later.
- *
- * @param filePath - The file path to analyze (can include leading './')
- * @param srcDir - Optional source directory to strip from the path
- * @returns Object with isSubagent flag and parentName if detected
- */
-export function detectSubagent(
-	filePath: string,
-	srcDir?: string
-): { isSubagent: boolean; parentName: string | null } {
-	let normalizedPath = filePath;
-
-	// Strip srcDir if provided
-	if (srcDir && normalizedPath.startsWith(srcDir)) {
-		normalizedPath = normalizedPath.replace(srcDir, '');
-	}
-
-	// Normalize path separators for cross-platform compatibility
-	normalizedPath = toForwardSlash(normalizedPath);
-
-	// Strip leading './' and split into parts, filtering out empty segments
-	const pathParts = normalizedPath.replace(/^\.\//, '').split('/').filter(Boolean);
-
-	// Path structure assumption: ['agent', 'parent', 'child', 'agent.ts' | 'route.ts' | 'route']
-	// Currently hardcoded to 4 segments - consider making configurable in the future
-	const isSubagent = pathParts.length === 4 && pathParts[0] === 'agent';
-	const parentName = isSubagent ? (pathParts[1] ?? null) : null;
-
-	return { isSubagent, parentName };
-}

package/src/utils/stream-capture.ts

@@ -1,39 +0,0 @@
-import { createWriteStream } from 'node:fs';
-
-/**
- * Stream a ReadableStream of raw bytes to a file on disk.
- *
- * This mirrors the pattern used by the deploy fork wrapper to capture child
- * process stdout/stderr without accumulating the output in memory.  Returns
- * the total number of bytes written.
- */
-export async function captureStreamToFile(
-	stream: ReadableStream<Uint8Array>,
-	filePath: string
-): Promise<number> {
-	const writer = createWriteStream(filePath);
-	const reader = stream.getReader();
-	let totalBytes = 0;
-
-	try {
-		while (true) {
-			const { done, value } = await reader.read();
-			if (done) break;
-
-			const ok = writer.write(value);
-			totalBytes += value.byteLength;
-
-			// Respect backpressure: wait for drain when the internal buffer is full
-			if (!ok) {
-				await new Promise<void>((resolve) => writer.once('drain', resolve));
-			}
-		}
-	} finally {
-		await new Promise<void>((resolve, reject) => {
-			writer.once('error', reject);
-			writer.end(resolve);
-		});
-	}
-
-	return totalBytes;
-}

package/src/utils/string.ts

@@ -1,6 +0,0 @@
-/**
- * String utility functions for identifier conversion
- * Re-exported from @agentuity/core for convenience
- */
-
-export { toCamelCase, toPascalCase } from '@agentuity/core';

package/src/utils/version-mismatch.ts

@@ -1,204 +0,0 @@
-/**
- * Version mismatch detection for @agentuity/* packages.
- *
- * Detects when a project uses outdated v1 SDK packages while the CLI is v2,
- * and recommends running the migration tool.
- */
-
-import { existsSync, readFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { getVersion } from '../version';
-import type { Logger } from '../types';
-
-export interface VersionInfo {
-	name: string;
-	version: string;
-	major: number;
-}
-
-export interface VersionMismatchResult {
-	/** CLI major version */
-	cliMajor: number;
-	/** All @agentuity/* packages found */
-	packages: VersionInfo[];
-	/** Packages with major version mismatch */
-	mismatched: VersionInfo[];
-	/** Packages that are v1 when CLI is v2+ */
-	outdated: VersionInfo[];
-	/** Whether any v1 packages were found */
-	hasV1Packages: boolean;
-	/** Whether there are major version mismatches across packages */
-	hasMajorMismatches: boolean;
-}
-
-/**
- * Extract major version from semver string
- */
-function extractMajor(version: string): number {
-	// Handle ranges like ^1.0.0, ~2.0.0, >=1.0.0
-	const match = version.match(/(\d+)\.\d+\.\d+/);
-	if (match?.[1]) {
-		return parseInt(match[1], 10);
-	}
-	// Handle "latest" or "*"
-	if (version === 'latest' || version === '*') {
-		return 0; // Unknown major
-	}
-	return 0;
-}
-
-/**
- * Get installed version from node_modules
- */
-function getInstalledVersion(projectDir: string, packageName: string): string | null {
-	try {
-		const pkgPath = join(projectDir, 'node_modules', packageName, 'package.json');
-		if (!existsSync(pkgPath)) {
-			return null;
-		}
-		const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
-		return pkg.version || null;
-	} catch {
-		return null;
-	}
-}
-
-/**
- * Detect version mismatches in @agentuity/* packages.
- *
- * @param projectDir - Root directory of the user's project
- * @param logger - Logger instance
- * @returns Version mismatch detection result
- */
-export function detectVersionMismatch(projectDir: string, logger: Logger): VersionMismatchResult {
-	const cliVersion = getVersion();
-	const cliMajor = extractMajor(cliVersion);
-
-	const result: VersionMismatchResult = {
-		cliMajor,
-		packages: [],
-		mismatched: [],
-		outdated: [],
-		hasV1Packages: false,
-		hasMajorMismatches: false,
-	};
-
-	// Skip check for canary versions
-	if (cliVersion.includes('-')) {
-		logger.debug('Skipping version mismatch check for canary version: %s', cliVersion);
-		return result;
-	}
-
-	// Read package.json
-	const packageJsonPath = join(projectDir, 'package.json');
-	if (!existsSync(packageJsonPath)) {
-		logger.debug('No package.json found, skipping version mismatch check');
-		return result;
-	}
-
-	let packageJson: {
-		dependencies?: Record<string, string>;
-		devDependencies?: Record<string, string>;
-	};
-	try {
-		packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
-	} catch (error) {
-		logger.debug('Failed to read package.json: %s', error);
-		return result;
-	}
-
-	// Collect all @agentuity/* packages
-	const allDeps = {
-		...packageJson.dependencies,
-		...packageJson.devDependencies,
-	};
-
-	const agentuitPackages = Object.entries(allDeps)
-		.filter(([name]) => name.startsWith('@agentuity/'))
-		.map(([name, specifier]) => ({ name, specifier }));
-
-	if (agentuitPackages.length === 0) {
-		logger.debug('No @agentuity/* packages found in package.json');
-		return result;
-	}
-
-	// Check each package's installed version
-	for (const { name } of agentuitPackages) {
-		const installedVersion = getInstalledVersion(projectDir, name);
-		if (!installedVersion) {
-			logger.debug('%s: not installed, skipping', name);
-			continue;
-		}
-
-		const major = extractMajor(installedVersion);
-		const info: VersionInfo = {
-			name,
-			version: installedVersion,
-			major,
-		};
-
-		result.packages.push(info);
-
-		// Check if this is a v1 package when CLI is v2+
-		if (major === 1 && cliMajor >= 2) {
-			result.outdated.push(info);
-			result.hasV1Packages = true;
-		}
-	}
-
-	// Check for major version mismatches across installed packages
-	if (result.packages.length > 1) {
-		const majors = new Set(result.packages.map((p) => p.major));
-		if (majors.size > 1) {
-			result.hasMajorMismatches = true;
-			// Find packages that don't match the most common major version
-			const majorCounts = new Map<number, number>();
-			for (const pkg of result.packages) {
-				majorCounts.set(pkg.major, (majorCounts.get(pkg.major) || 0) + 1);
-			}
-			const mostCommonMajor =
-				[...majorCounts.entries()].sort((a, b) => b[1] - a[1])[0]?.[0] || cliMajor;
-
-			for (const pkg of result.packages) {
-				if (pkg.major !== mostCommonMajor) {
-					result.mismatched.push(pkg);
-				}
-			}
-		}
-	}
-
-	return result;
-}
-
-/**
- * Format a warning message for version mismatches.
- */
-export function formatVersionMismatchWarning(result: VersionMismatchResult): string {
-	const lines: string[] = [];
-
-	if (result.hasV1Packages) {
-		lines.push('You are using Agentuity SDK v1 packages, but v2 is now available.');
-		lines.push('');
-		lines.push('  Outdated packages:');
-		for (const pkg of result.outdated) {
-			lines.push(`    • ${pkg.name}@${pkg.version}`);
-		}
-		lines.push('');
-		lines.push('  → Run `npx @agentuity/migrate` to upgrade your project to v2.');
-		lines.push('    This will automatically update your code and dependencies.');
-		lines.push('');
-		lines.push('  See the migration guide: https://docs.agentuity.com/migration/v1-to-v2');
-	} else if (result.hasMajorMismatches) {
-		lines.push('Your project has mismatched major versions across @agentuity/* packages.');
-		lines.push('');
-		lines.push('  Packages:');
-		for (const pkg of result.packages) {
-			const marker = result.mismatched.includes(pkg) ? ' ⚠️' : '';
-			lines.push(`    • ${pkg.name}@${pkg.version} (v${pkg.major})${marker}`);
-		}
-		lines.push('');
-		lines.push('  → Run `bun install` to sync versions, or pin to the same major version.');
-	}
-
-	return lines.join('\n');
-}

package/src/utils/workbench-notify.ts

@@ -1,67 +0,0 @@
-/**
- * Utility to send notifications directly to workbench clients via WebSocket
- */
-
-export interface WorkbenchNotifyOptions {
-	port?: number;
-	message: 'restarting' | 'alive';
-}
-
-/**
- * Send a notification directly to workbench clients via WebSocket
- *
- * @param options - Configuration for the notification
- * @returns Promise that resolves when notification is sent
- *
- * @example
- * ```typescript
- * // Notify clients that server is restarting
- * await notifyWorkbenchClients({
- *   baseUrl: 'ws://localhost:3500',
- *   message: 'restarting'
- * });
- *
- * // Notify clients that server is alive
- * await notifyWorkbenchClients({
- *   message: 'alive'
- * });
- * ```
- */
-export async function notifyWorkbenchClients(options: WorkbenchNotifyOptions): Promise<void> {
-	const { port = 3500, message } = options;
-
-	const wsUrl = new URL(`ws://localhost:${port}`);
-
-	return new Promise((resolve) => {
-		try {
-			wsUrl.pathname = '/_agentuity/workbench/ws';
-
-			const ws = new WebSocket(wsUrl.toString());
-
-			// Set a timeout to avoid hanging
-			const timeout = setTimeout(() => {
-				ws.close();
-				resolve();
-			}, 2000);
-
-			ws.onopen = () => {
-				ws.send(message);
-				ws.close();
-			};
-
-			ws.onclose = () => {
-				clearTimeout(timeout);
-				resolve();
-			};
-
-			ws.onerror = () => {
-				clearTimeout(timeout);
-				ws.close();
-				resolve();
-			};
-		} catch (_error) {
-			// Silently fail - this ensures the CLI doesn't fail if the app server isn't running
-			resolve();
-		}
-	});
-}