@agntk/cli 0.1.0

package/dist/args.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @fileoverview CLI argument parsing for agntk.
+ * Lightweight hand-rolled parser — keeps dependencies at zero.
+ */
+export interface ParsedArgs {
+    /** The prompt text (positional argument) */
+    prompt: string | null;
+    /** -i / --interactive */
+    interactive: boolean;
+    /** -r / --role <role> */
+    role: string | null;
+    /** -m / --model <model> */
+    model: string | null;
+    /** --memory */
+    memory: boolean;
+    /** --init */
+    init: boolean;
+    /** --tools <preset> */
+    tools: string | null;
+    /** --workspace <path> */
+    workspace: string | null;
+    /** --dry-run */
+    dryRun: boolean;
+    /** --verbose */
+    verbose: boolean;
+    /** --config <path> */
+    config: string | null;
+    /** --max-steps <n> */
+    maxSteps: number | null;
+    /** -v / --version */
+    version: boolean;
+    /** -h / --help */
+    help: boolean;
+}
+/**
+ * Parse CLI arguments into a typed structure.
+ * Supports: flags, flags with values, and a positional prompt.
+ */
+export declare function parseArgs(argv: string[]): ParsedArgs;
+//# sourceMappingURL=args.d.ts.map

package/dist/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,yBAAyB;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,yBAAyB;IACzB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,eAAe;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa;IACb,IAAI,EAAE,OAAO,CAAC;IACd,uBAAuB;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,yBAAyB;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gBAAgB;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,gBAAgB;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,sBAAsB;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,sBAAsB;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB;IAClB,IAAI,EAAE,OAAO,CAAC;CACf;AAWD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA+DpD"}

package/dist/args.js

@@ -0,0 +1,90 @@
+/**
+ * @fileoverview CLI argument parsing for agntk.
+ * Lightweight hand-rolled parser — keeps dependencies at zero.
+ */
+const FLAGS_WITH_VALUES = new Set([
+    '-r', '--role',
+    '-m', '--model',
+    '--tools',
+    '--workspace',
+    '--config',
+    '--max-steps',
+]);
+/**
+ * Parse CLI arguments into a typed structure.
+ * Supports: flags, flags with values, and a positional prompt.
+ */
+export function parseArgs(argv) {
+    const result = {
+        prompt: null,
+        interactive: false,
+        role: null,
+        model: null,
+        memory: false,
+        init: false,
+        tools: null,
+        workspace: null,
+        dryRun: false,
+        verbose: false,
+        config: null,
+        maxSteps: null,
+        version: false,
+        help: false,
+    };
+    const positionals = [];
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === '-i' || arg === '--interactive') {
+            result.interactive = true;
+        }
+        else if (arg === '-r' || arg === '--role') {
+            result.role = argv[++i] ?? null;
+        }
+        else if (arg === '-m' || arg === '--model') {
+            result.model = argv[++i] ?? null;
+        }
+        else if (arg === '--memory') {
+            result.memory = true;
+        }
+        else if (arg === '--init') {
+            result.init = true;
+        }
+        else if (arg === '--tools') {
+            result.tools = argv[++i] ?? null;
+        }
+        else if (arg === '--workspace') {
+            result.workspace = argv[++i] ?? null;
+        }
+        else if (arg === '--dry-run') {
+            result.dryRun = true;
+        }
+        else if (arg === '--verbose') {
+            result.verbose = true;
+        }
+        else if (arg === '--config') {
+            result.config = argv[++i] ?? null;
+        }
+        else if (arg === '--max-steps') {
+            const val = argv[++i];
+            result.maxSteps = val ? parseInt(val, 10) : null;
+        }
+        else if (arg === '-v' || arg === '--version') {
+            result.version = true;
+        }
+        else if (arg === '-h' || arg === '--help') {
+            result.help = true;
+        }
+        else if (arg.startsWith('-')) {
+            // Unknown flag — ignore for forward compatibility
+        }
+        else {
+            positionals.push(arg);
+        }
+    }
+    // Join all positionals as the prompt
+    if (positionals.length > 0) {
+        result.prompt = positionals.join(' ');
+    }
+    return result;
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview CLI entry point for agntk.
+ *
+ * Usage:
+ *   npx agntk "do something"
+ *   npx agntk --role coder "fix the tests"
+ *   npx agntk -i --memory
+ *   cat error.log | npx agntk "explain these errors"
+ */
+import 'dotenv/config';
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG;AAGH,OAAO,eAAe,CAAC"}

package/dist/cli.js

@@ -0,0 +1,126 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview CLI entry point for agntk.
+ *
+ * Usage:
+ *   npx agntk "do something"
+ *   npx agntk --role coder "fix the tests"
+ *   npx agntk -i --memory
+ *   cat error.log | npx agntk "explain these errors"
+ */
+// Load .env files before anything else reads process.env
+import 'dotenv/config';
+import { getVersion } from './version.js';
+import { parseArgs } from './args.js';
+import { resolveConfig } from './config.js';
+// Note: environment.js and runner.js are dynamically imported below
+// to avoid loading @agntk/core for --version and --help (fast paths)
+// ============================================================================
+// Help Text
+// ============================================================================
+function printHelp() {
+    const version = getVersion();
+    console.log(`
+  agntk v${version} — portable AI agent
+
+  Usage:
+    agntk [options] [prompt]
+
+  Options:
+    -i, --interactive     Interactive REPL mode
+    -r, --role <role>     Agent role (coder, researcher, analyst, generic)
+    -m, --model <model>   Model to use (provider:model format)
+    --memory              Enable persistent memory
+    --init                Initialize .agntk/ directory with templates
+    --tools <preset>      Tool preset (minimal, standard, full)
+    --workspace <path>    Workspace root (default: cwd)
+    --dry-run             Preview actions without executing
+    --verbose             Show detailed logging
+    --config <path>       Config file path
+    --max-steps <n>       Maximum agent steps
+    -v, --version         Show version
+    -h, --help            Show help
+
+  Examples:
+    agntk "organize this folder by date"
+    agntk -i --memory
+    agntk --role coder "fix the failing tests"
+    cat error.log | agntk "explain these errors"
+`);
+}
+// ============================================================================
+// Main
+// ============================================================================
+async function main() {
+    const args = parseArgs(process.argv.slice(2));
+    // Handle --version
+    if (args.version) {
+        console.log(`agntk v${getVersion()}`);
+        process.exit(0);
+    }
+    // Handle --help
+    if (args.help) {
+        printHelp();
+        process.exit(0);
+    }
+    // Resolve configuration
+    const config = resolveConfig(args);
+    // Handle --init: create .agntk/ directory with template files
+    if (config.init) {
+        const { initMemoryDirectory } = await import('./init.js');
+        await initMemoryDirectory(config.workspace);
+        process.exit(0);
+    }
+    // Handle interactive mode
+    if (config.interactive) {
+        const { detectEnvironment } = await import('./environment.js');
+        const { runRepl } = await import('./repl.js');
+        const environment = detectEnvironment(config.workspace);
+        const result = await runRepl({ config, environment });
+        process.exit(result.success ? 0 : 1);
+    }
+    // Quick "no prompt" check before loading heavy modules
+    // If stdin is a TTY and no prompt was given, bail early
+    if (!config.prompt && process.stdin.isTTY) {
+        console.error('Error: No prompt provided.\n' +
+            'Usage: agntk "your prompt here"\n' +
+            '       agntk -i  (for interactive mode)\n' +
+            '       agntk -h  (for help)');
+        process.exit(1);
+    }
+    // ── Lazy-load heavy modules (only when actually running an agent) ────
+    const { detectEnvironment } = await import('./environment.js');
+    const { runOneShot, readStdin } = await import('./runner.js');
+    // Build final prompt, combining piped input if available
+    let prompt = config.prompt;
+    const pipedInput = await readStdin();
+    if (pipedInput) {
+        if (prompt) {
+            prompt = `${pipedInput}\n\n${prompt}`;
+        }
+        else {
+            prompt = pipedInput;
+        }
+    }
+    if (!prompt) {
+        console.error('Error: No prompt provided.\n' +
+            'Usage: agntk "your prompt here"\n' +
+            '       agntk -i  (for interactive mode)\n' +
+            '       agntk -h  (for help)');
+        process.exit(1);
+    }
+    // Detect environment
+    const environment = detectEnvironment(config.workspace);
+    // Run the agent
+    const result = await runOneShot(prompt, { config, environment });
+    if (!result.success) {
+        console.error(`Error: ${result.error}`);
+        process.exit(1);
+    }
+    process.exit(0);
+}
+main().catch((err) => {
+    console.error('Fatal error:', err instanceof Error ? err.message : String(err));
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @fileoverview Config resolution for agntk CLI.
+ * Precedence: CLI flags > env vars > config file > defaults.
+ */
+import type { ParsedArgs } from './args.js';
+export interface ResolvedCLIConfig {
+    /** The prompt text to send to the agent */
+    prompt: string | null;
+    /** Whether to enter interactive REPL mode */
+    interactive: boolean;
+    /** Agent role */
+    role: string;
+    /** Model identifier (provider:model format) */
+    model: string | null;
+    /** Provider extracted from model or env vars */
+    provider: string | null;
+    /** API key for the resolved provider */
+    apiKey: string | null;
+    /** Enable persistent memory */
+    memory: boolean;
+    /** Run init wizard */
+    init: boolean;
+    /** Tool preset */
+    toolPreset: string;
+    /** Workspace root directory */
+    workspace: string;
+    /** Dry run mode */
+    dryRun: boolean;
+    /** Verbose logging */
+    verbose: boolean;
+    /** Max agent steps */
+    maxSteps: number;
+    /** Path to config file */
+    configPath: string | null;
+}
+interface ApiKeyResult {
+    provider: string;
+    apiKey: string;
+}
+/**
+ * Detect API key from environment variables.
+ * Returns the first found key with its provider.
+ */
+export declare function detectApiKey(): ApiKeyResult | null;
+interface ConfigFileData {
+    role?: string;
+    model?: string;
+    memory?: boolean;
+    tools?: string;
+    maxSteps?: number;
+    workspace?: string;
+}
+/**
+ * Load config file from the workspace directory.
+ * Tries multiple filenames, returns first found.
+ */
+export declare function loadConfigFile(workspace: string, explicitPath?: string | null): ConfigFileData;
+/**
+ * Resolve final config from CLI args, env vars, config file, and defaults.
+ */
+export declare function resolveConfig(args: ParsedArgs): ResolvedCLIConfig;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAM5C,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,6CAA6C;IAC7C,WAAW,EAAE,OAAO,CAAC;IACrB,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,wCAAwC;IACxC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,+BAA+B;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,sBAAsB;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,sBAAsB;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAMD,UAAU,YAAY;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAOD;;;GAGG;AACH,wBAAgB,YAAY,IAAI,YAAY,GAAG,IAAI,CAQlD;AAMD,UAAU,cAAc;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAOD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,cAAc,CA0B9F;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,iBAAiB,CAmCjE"}

package/dist/config.js

@@ -0,0 +1,96 @@
+/**
+ * @fileoverview Config resolution for agntk CLI.
+ * Precedence: CLI flags > env vars > config file > defaults.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+const API_KEY_ENV_VARS = [
+    { env: 'OPENROUTER_API_KEY', provider: 'openrouter' },
+    { env: 'OPENAI_API_KEY', provider: 'openai' },
+];
+/**
+ * Detect API key from environment variables.
+ * Returns the first found key with its provider.
+ */
+export function detectApiKey() {
+    for (const { env, provider } of API_KEY_ENV_VARS) {
+        const key = process.env[env];
+        if (key && key.trim().length > 0) {
+            return { provider, apiKey: key };
+        }
+    }
+    return null;
+}
+const CONFIG_FILENAMES = [
+    'agent-sdk.config.json',
+    '.agntkrc.json',
+];
+/**
+ * Load config file from the workspace directory.
+ * Tries multiple filenames, returns first found.
+ */
+export function loadConfigFile(workspace, explicitPath) {
+    if (explicitPath) {
+        if (!existsSync(explicitPath)) {
+            return {};
+        }
+        try {
+            const content = readFileSync(explicitPath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            return {};
+        }
+    }
+    for (const filename of CONFIG_FILENAMES) {
+        const filePath = join(workspace, filename);
+        if (existsSync(filePath)) {
+            try {
+                const content = readFileSync(filePath, 'utf-8');
+                return JSON.parse(content);
+            }
+            catch {
+                // Silently skip unparseable files
+            }
+        }
+    }
+    return {};
+}
+// ============================================================================
+// Config Resolution
+// ============================================================================
+/**
+ * Resolve final config from CLI args, env vars, config file, and defaults.
+ */
+export function resolveConfig(args) {
+    const workspace = args.workspace ?? process.cwd();
+    // Load config file (lowest precedence)
+    const fileConfig = loadConfigFile(workspace, args.config);
+    // Detect API key from env
+    const apiKeyResult = detectApiKey();
+    // Parse model string (e.g., "openrouter:anthropic/claude-sonnet-4")
+    let provider = apiKeyResult?.provider ?? null;
+    let model = args.model ?? fileConfig.model ?? null;
+    if (model && model.includes(':')) {
+        const [p, ...rest] = model.split(':');
+        provider = p;
+        model = rest.join(':');
+    }
+    return {
+        prompt: args.prompt,
+        interactive: args.interactive,
+        role: args.role ?? fileConfig.role ?? 'generic',
+        model,
+        provider,
+        apiKey: apiKeyResult?.apiKey ?? null,
+        memory: args.memory || (fileConfig.memory ?? false),
+        init: args.init,
+        toolPreset: args.tools ?? fileConfig.tools ?? 'standard',
+        workspace,
+        dryRun: args.dryRun,
+        verbose: args.verbose,
+        maxSteps: args.maxSteps ?? fileConfig.maxSteps ?? 10,
+        configPath: args.config,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/environment.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @fileoverview Environment detection for agntk.
+ * Detects OS, shell, project type, git repo, available commands, TTY, CI, etc.
+ * This is the "invisible awareness" from PLAN.md Section 3.3.
+ */
+export interface EnvironmentContext {
+    /** Operating system */
+    os: 'macos' | 'linux' | 'windows' | 'unknown';
+    /** Shell type */
+    shell: string;
+    /** Detected project type from manifest files */
+    projectType: string | null;
+    /** Detected package manager */
+    packageManager: string | null;
+    /** Whether cwd is inside a git repository */
+    isGitRepo: boolean;
+    /** Whether stdout is a terminal (interactive) */
+    isTTY: boolean;
+    /** Whether running in a CI environment */
+    isCI: boolean;
+    /** Whether running inside Docker */
+    isDocker: boolean;
+    /** Node.js version */
+    nodeVersion: string;
+    /** List of commonly useful commands that are available */
+    availableCommands: string[];
+}
+/**
+ * Detect the current environment context.
+ * All detection is synchronous and fast (<500ms typical).
+ */
+export declare function detectEnvironment(workspace?: string): EnvironmentContext;
+/**
+ * Format environment context as a string to inject into the agent's system prompt.
+ */
+export declare function formatEnvironmentPrompt(ctx: EnvironmentContext): string;
+//# sourceMappingURL=environment.d.ts.map

package/dist/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,MAAM,WAAW,kBAAkB;IACjC,uBAAuB;IACvB,EAAE,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IAC9C,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,+BAA+B;IAC/B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,6CAA6C;IAC7C,SAAS,EAAE,OAAO,CAAC;IACnB,iDAAiD;IACjD,KAAK,EAAE,OAAO,CAAC;IACf,0CAA0C;IAC1C,IAAI,EAAE,OAAO,CAAC;IACd,oCAAoC;IACpC,QAAQ,EAAE,OAAO,CAAC;IAClB,sBAAsB;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AA8HD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,GAAE,MAAsB,GAAG,kBAAkB,CAavF;AAMD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CA4BvE"}

package/dist/environment.js

@@ -0,0 +1,164 @@
+/**
+ * @fileoverview Environment detection for agntk.
+ * Detects OS, shell, project type, git repo, available commands, TTY, CI, etc.
+ * This is the "invisible awareness" from PLAN.md Section 3.3.
+ */
+import { existsSync } from 'node:fs';
+import { execSync } from 'node:child_process';
+import { join } from 'node:path';
+// ============================================================================
+// Detection Functions
+// ============================================================================
+function detectOS() {
+    switch (process.platform) {
+        case 'darwin': return 'macos';
+        case 'linux': return 'linux';
+        case 'win32': return 'windows';
+        default: return 'unknown';
+    }
+}
+function detectShell() {
+    // Check SHELL env var (Unix)
+    const shellEnv = process.env['SHELL'];
+    if (shellEnv) {
+        const shellName = shellEnv.split('/').pop();
+        if (shellName)
+            return shellName;
+    }
+    // Check ComSpec (Windows)
+    const comspec = process.env['ComSpec'];
+    if (comspec) {
+        if (comspec.toLowerCase().includes('powershell'))
+            return 'powershell';
+        if (comspec.toLowerCase().includes('cmd'))
+            return 'cmd';
+    }
+    // Fallback
+    return process.platform === 'win32' ? 'cmd' : 'sh';
+}
+const MANIFEST_FILES = [
+    { file: 'package.json', type: 'node' },
+    { file: 'Cargo.toml', type: 'rust' },
+    { file: 'pyproject.toml', type: 'python' },
+    { file: 'go.mod', type: 'go' },
+    { file: 'Gemfile', type: 'ruby' },
+    { file: 'build.gradle', type: 'java' },
+    { file: 'pom.xml', type: 'java' },
+    { file: 'composer.json', type: 'php' },
+    { file: 'mix.exs', type: 'elixir' },
+    { file: 'Makefile', type: 'make' },
+];
+function detectProjectType(workspace) {
+    for (const { file, type } of MANIFEST_FILES) {
+        if (existsSync(join(workspace, file))) {
+            return type;
+        }
+    }
+    return null;
+}
+const LOCKFILE_TO_PM = [
+    { file: 'pnpm-lock.yaml', pm: 'pnpm' },
+    { file: 'bun.lockb', pm: 'bun' },
+    { file: 'yarn.lock', pm: 'yarn' },
+    { file: 'package-lock.json', pm: 'npm' },
+];
+function detectPackageManager(workspace) {
+    for (const { file, pm } of LOCKFILE_TO_PM) {
+        if (existsSync(join(workspace, file))) {
+            return pm;
+        }
+    }
+    return null;
+}
+function detectGitRepo(workspace) {
+    return existsSync(join(workspace, '.git'));
+}
+function detectCI() {
+    return !!(process.env['CI'] ||
+        process.env['GITHUB_ACTIONS'] ||
+        process.env['GITLAB_CI'] ||
+        process.env['CIRCLECI'] ||
+        process.env['JENKINS_URL'] ||
+        process.env['BUILDKITE'] ||
+        process.env['TRAVIS']);
+}
+function detectDocker() {
+    if (existsSync('/.dockerenv'))
+        return true;
+    try {
+        const cgroup = execSync('cat /proc/1/cgroup 2>/dev/null', { encoding: 'utf-8', timeout: 1000 });
+        return cgroup.includes('docker') || cgroup.includes('containerd');
+    }
+    catch {
+        return false;
+    }
+}
+const USEFUL_COMMANDS = ['git', 'node', 'npm', 'pnpm', 'bun', 'python3', 'pip3', 'docker', 'curl', 'jq', 'at', 'crontab'];
+function detectAvailableCommands() {
+    const available = [];
+    const whichCmd = process.platform === 'win32' ? 'where' : 'which';
+    for (const cmd of USEFUL_COMMANDS) {
+        try {
+            execSync(`${whichCmd} ${cmd} 2>/dev/null`, { encoding: 'utf-8', timeout: 2000 });
+            available.push(cmd);
+        }
+        catch {
+            // Not available
+        }
+    }
+    return available;
+}
+// ============================================================================
+// Main Detection
+// ============================================================================
+/**
+ * Detect the current environment context.
+ * All detection is synchronous and fast (<500ms typical).
+ */
+export function detectEnvironment(workspace = process.cwd()) {
+    return {
+        os: detectOS(),
+        shell: detectShell(),
+        projectType: detectProjectType(workspace),
+        packageManager: detectPackageManager(workspace),
+        isGitRepo: detectGitRepo(workspace),
+        isTTY: !!process.stdout.isTTY,
+        isCI: detectCI(),
+        isDocker: detectDocker(),
+        nodeVersion: process.version,
+        availableCommands: detectAvailableCommands(),
+    };
+}
+// ============================================================================
+// System Prompt Formatting
+// ============================================================================
+/**
+ * Format environment context as a string to inject into the agent's system prompt.
+ */
+export function formatEnvironmentPrompt(ctx) {
+    const lines = ['## Environment'];
+    lines.push(`- OS: ${ctx.os}`);
+    lines.push(`- Shell: ${ctx.shell}`);
+    lines.push(`- Node: ${ctx.nodeVersion}`);
+    lines.push(`- Terminal: ${ctx.isTTY ? 'interactive' : 'non-interactive (piped)'}`);
+    if (ctx.projectType) {
+        lines.push(`- Project type: ${ctx.projectType}`);
+    }
+    if (ctx.packageManager) {
+        lines.push(`- Package manager: ${ctx.packageManager}`);
+    }
+    if (ctx.isGitRepo) {
+        lines.push(`- Git repository: yes`);
+    }
+    if (ctx.isCI) {
+        lines.push(`- Running in CI`);
+    }
+    if (ctx.isDocker) {
+        lines.push(`- Running in Docker`);
+    }
+    if (ctx.availableCommands.length > 0) {
+        lines.push(`- Available commands: ${ctx.availableCommands.join(', ')}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=environment.js.map