windows-development-sandbox 1.4.1 → 1.4.3

package/dist/core/config/defaults.js

@@ -0,0 +1,203 @@
+export const DEFAULTS = {
+    defaultHarness: 'claude',
+    guestWorkspace: 'auto',
+    readOnly: false,
+    workspaceFilter: { enabled: false, exclude: [], include: [] },
+    audit: { enabled: false, days: 14, maxMb: 100, processes: true, files: true },
+    mappings: [],
+    sandbox: {
+        memoryMb: 'auto',
+        maxMemoryMb: 32768,
+        maxMemoryPercent: 80,
+        cpuLimit: 80,
+        pageFileMb: 16384,
+        reserveHostMb: 8192,
+        vGpu: false,
+        networking: true,
+        clipboard: true,
+        audioInput: false,
+        videoInput: false,
+        printerRedirection: false,
+        protectedClient: true,
+        headless: false,
+        keepAwake: true,
+    },
+    storage: {
+        root: '%LOCALAPPDATA%\\AgentSandbox',
+        persistAgentState: true,
+        dataName: 'default',
+        markSandboxFiles: true,
+        warnDataGb: 50,
+    },
+    network: { blockPrivateRanges: true, allowOnly: [], blockHosts: [], forwardPorts: [], dns: [], proxy: '' },
+    provisioning: {
+        copyFromHost: true,
+        fallbackToInstall: true,
+        refresh: false,
+        git: { enabled: true, access: 'full' },
+        terminal: { enabled: true },
+        conpty: { enabled: true },
+    },
+    downloads: { requireChecksum: false },
+    toolchains: {
+        node: { version: 'host', extraVersions: [], corepack: true, volta: 'auto', globalPackages: [] },
+        python: { enabled: 'auto', version: '3', python2: true, pyenv: 'auto', tools: [] },
+        rust: {
+            enabled: 'auto',
+            toolchain: 'stable',
+            host: 'auto',
+            components: [],
+            targets: [],
+            crates: [],
+            targetDir: 'separate',
+            linker: 'lld',
+            linkSlots: 'auto',
+        },
+        msvc: { enabled: 'auto', acceptLicense: false, msvcVersion: 'latest', sdkVersion: 'latest' },
+        cpp: { enabled: 'auto', flexBison: true },
+        dotnet: {
+            enabled: 'auto',
+            channels: ['LTS'],
+            tools: [],
+            workloads: [],
+            frameworkTargets: ['net48', 'net472'],
+            netfx35: false,
+        },
+        // Bigger downloads only for projects that use them.
+        go: { enabled: 'auto', version: 'stable', tools: [] },
+        java: { enabled: 'auto', version: 'lts', maven: true, gradle: true },
+        ruby: { enabled: 'auto', version: '3', gems: [] },
+        php: { enabled: 'auto', version: '8', composer: true },
+        deno: { enabled: 'auto' },
+        pwsh: { enabled: 'auto' },
+        cli: { gh: 'auto', zstd: false, openssl: 'auto' },
+        bun: { enabled: true },
+        uv: { enabled: true },
+        vcRuntime: { enabled: false },
+        mesa: { enabled: false, vulkan: false },
+        vscode: { enabled: true, setup: true, recommended: true, extensions: [] },
+        environment: {},
+    },
+    databases: {
+        postgres: { enabled: 'auto', version: 'latest', port: 5432 },
+        mysql: { enabled: 'auto', version: 'lts', port: 3306 },
+        mongodb: { enabled: 'auto', version: 'latest', port: 27017 },
+        redis: { enabled: 'auto', port: 6379 },
+        dynamodb: { enabled: 'auto', port: 8000, adminPort: 8001, admin: true },
+        sqlserver: { enabled: 'auto' },
+    },
+    attach: { enabled: true, reuseSession: true, auto: false, autoHide: false },
+    agentCommands: { enabled: false, agents: 'auto' },
+    secrets: { strip: true, allow: [], patterns: [], warnFiles: true },
+    personalization: { enabled: true },
+    apps: { install: [], custom: {} },
+    claudeProfile: {
+        enabled: true,
+        hostDir: 'auto',
+        include: ['settings.json', 'CLAUDE.md', 'commands', 'agents', 'skills', 'plugins'],
+        globalStateFile: 'auto',
+        copyCredentials: false,
+        overwrite: true,
+        syncHistory: true,
+        historyScope: 'project',
+        syncClaudeMem: true,
+        syncClaudeMemBack: false,
+    },
+    harnesses: {
+        claude: {
+            hostExecutable: 'claude.exe',
+            hostDir: 'auto',
+            npmPackage: '@anthropic-ai/claude-code@latest',
+            npmBin: 'claude',
+            arguments: [],
+            environment: { DISABLE_AUTOUPDATER: '1' },
+            resumeArguments: ['--continue'],
+        },
+        codex: {
+            npmPackage: '@openai/codex@latest',
+            npmBin: 'codex',
+            arguments: [],
+            environment: {},
+            resumeArguments: ['resume', '--last'],
+        },
+        gemini: {
+            npmPackage: '@google/gemini-cli@latest',
+            npmBin: 'gemini',
+            arguments: [],
+            environment: {},
+            resumeArguments: ['--resume'],
+        },
+        // Not tested by us; installed from each project's official npm / PyPI package.
+        opencode: {
+            npmPackage: 'opencode-ai@latest',
+            npmBin: 'opencode',
+            arguments: [],
+            environment: {},
+            resumeArguments: ['--continue'],
+        },
+        qwen: {
+            npmPackage: '@qwen-code/qwen-code@latest',
+            npmBin: 'qwen',
+            arguments: [],
+            environment: {},
+            resumeArguments: ['--continue'],
+        },
+        crush: {
+            npmPackage: '@charmland/crush@latest',
+            npmBin: 'crush',
+            arguments: [],
+            environment: {},
+            resumeArguments: ['--continue'],
+        },
+        copilot: {
+            npmPackage: '@github/copilot@latest',
+            npmBin: 'copilot',
+            arguments: [],
+            environment: {},
+            resumeArguments: ['--continue'],
+        },
+        kilo: {
+            npmPackage: '@kilocode/cli@latest',
+            npmBin: 'kilo',
+            arguments: [],
+            environment: {},
+            resumeArguments: ['--continue'],
+        },
+        amp: { npmPackage: '@ampcode/cli@latest', npmBin: 'amp', arguments: [], environment: {} },
+        cline: { npmPackage: 'cline@latest', npmBin: 'cline', arguments: [], environment: {} },
+        continue: {
+            npmPackage: '@continuedev/cli@latest',
+            npmBin: 'cn',
+            arguments: [],
+            environment: {},
+            resumeArguments: ['--resume'],
+        },
+        kimi: {
+            npmPackage: '@moonshot-ai/kimi-code@latest',
+            npmBin: 'kimi',
+            arguments: [],
+            environment: {},
+            resumeArguments: ['-c'],
+        },
+        // DeepSeek has no official coding CLI; these two community agents are built for it.
+        reasonix: { npmPackage: 'reasonix@latest', npmBin: 'reasonix', arguments: [], environment: {} },
+        deepseek: { npmPackage: 'codewhale@latest', npmBin: 'codewhale', arguments: [], environment: {} },
+        aider: {
+            uvPackage: 'aider-chat',
+            uvBin: 'aider',
+            arguments: [],
+            environment: {},
+            resumeArguments: ['--restore-chat-history'],
+        },
+    },
+    hooks: { failFast: false },
+    projects: {
+        all: false,
+        exclude: [],
+        roots: [],
+        askToAddRoot: true,
+        declinedRoots: [],
+        allowOutsideMappings: 'ask',
+        wsbShare: true,
+    },
+};

package/dist/core/config/index.d.ts

@@ -0,0 +1,2 @@
+export { DEFAULTS } from './defaults.js';
+export { userDir, userConfigPath, mergeConfig, validateConfig, loadConfig, assertNoGuestOverlap } from './loader.js';

package/dist/core/config/index.js

@@ -0,0 +1,3 @@
+// Built-in defaults and loading the user config (~/.agent-sandbox/config.json). Shapes live in schema.ts.
+export { DEFAULTS } from './defaults.js';
+export { userDir, userConfigPath, mergeConfig, validateConfig, loadConfig, assertNoGuestOverlap } from './loader.js';

package/dist/core/{config.d.ts → config/loader.d.ts}

@@ -1,5 +1,4 @@
-import type { Config, LoadedConfig } from './types.js';
-export declare const DEFAULTS: Config;
+import type { Config, LoadedConfig } from '../types.js';
 /** Per-user folder for config and hooks. Survives reinstalling the npm package. */
 export declare const userDir: () => string;
 export declare const userConfigPath: () => string;

package/dist/core/config/loader.js

@@ -0,0 +1,47 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import _ from 'lodash';
+import { ConfigSchema, describeIssues } from '../schema/index.js';
+import { fail, homeDir, readJsonc } from '../util/index.js';
+import { DEFAULTS } from './defaults.js';
+/** Per-user folder for config and hooks. Survives reinstalling the npm package. */
+export const userDir = () => process.env.AGENT_SANDBOX_HOME ?? path.join(homeDir(), '.agent-sandbox');
+export const userConfigPath = () => path.join(userDir(), 'config.json');
+/** Deep merge where arrays (and anything that is not a plain object) replace instead of merging element by element. */
+export const mergeConfig = (base, extra) => _.mergeWith(_.cloneDeep(base), extra, (_target, source) => Array.isArray(source) ? source : undefined);
+/** Validates a full config; throws one readable error listing every problem. */
+export const validateConfig = (config, source) => {
+    const parsed = ConfigSchema.safeParse(config);
+    if (!parsed.success)
+        fail(source + ' is not valid:\n  - ' + describeIssues(parsed.error).join('\n  - '));
+    return parsed.data;
+};
+/**
+ * Lookup order: --config, %AGENT_SANDBOX_CONFIG%, ~/.agent-sandbox/config.json, built-in defaults.
+ * Whatever file is found (JSON with comments) is merged over the defaults, so it only needs the keys you change.
+ */
+export const loadConfig = (explicitPath) => {
+    const requested = explicitPath ?? process.env.AGENT_SANDBOX_CONFIG;
+    const full = path.resolve(requested ?? userConfigPath());
+    if (!fs.existsSync(full)) {
+        if (requested)
+            fail('Config file not found: ' + full, 'Check the --config path or AGENT_SANDBOX_CONFIG, or create one with: sandbox config init');
+        return { config: structuredClone(DEFAULTS), configPath: null, base: userDir() };
+    }
+    return {
+        config: validateConfig(mergeConfig(DEFAULTS, readJsonc(full)), full),
+        configPath: full,
+        base: path.dirname(full),
+    };
+};
+export const assertNoGuestOverlap = (mappings) => {
+    const normal = mappings.map((m) => m.guest.replace(/\\+$/, '').toLowerCase());
+    normal.forEach((a, i) => normal.slice(i + 1).forEach((b, j) => {
+        if (a === b || a.startsWith(b + '\\') || b.startsWith(a + '\\'))
+            fail('Two folders map to overlapping places in the sandbox: ' +
+                mappings[i].guest +
+                ' and ' +
+                mappings[i + 1 + j].guest +
+                '.', 'Give each mapping its own guest folder (one must not be inside the other).');
+    }));
+};

package/dist/core/{detect-databases.js → detect/databases.js}

@@ -14,44 +14,92 @@ const infra = /^(serverless\.ya?ml|template\.ya?ml|[\w.-]+\.tf)$/i;
 const dep = (names) => new RegExp('["\'\\s/=]?(' + names + ')["\'\\s@=<>~^:,\\]\\n]', 'i');
 const RULES = {
     postgres: [
-        [compose, /image:\s*["']?[\w./-]{0,80}(postgres|postgis|timescaledb|supabase\/postgres|pgvector)[\w.-]{0,40}(:|\s|["']|$)/im, 'a compose service runs Postgres'],
-        [manifests, dep('pg|postgres|pg-promise|@neondatabase/serverless|@vercel/postgres|slonik|postgres-js|@electric-sql/pglite'), 'a Postgres driver in package.json'],
-        [python, dep('psycopg2?(-binary)?|psycopg\\[[\\w,]+\\]|asyncpg|pg8000|django\\.db\\.backends\\.postgresql'), 'a Postgres driver in the Python dependencies'],
+        [
+            compose,
+            /image:\s*["']?[\w./-]{0,80}(postgres|postgis|timescaledb|supabase\/postgres|pgvector)[\w.-]{0,40}(:|\s|["']|$)/im,
+            'a compose service runs Postgres',
+        ],
+        [
+            manifests,
+            dep('pg|postgres|pg-promise|@neondatabase/serverless|@vercel/postgres|slonik|postgres-js|@electric-sql/pglite'),
+            'a Postgres driver in package.json',
+        ],
+        [
+            python,
+            dep('psycopg2?(-binary)?|psycopg\\[[\\w,]+\\]|asyncpg|pg8000|django\\.db\\.backends\\.postgresql'),
+            'a Postgres driver in the Python dependencies',
+        ],
         [/^gemfile$/i, /gem\s+["']pg["']/, 'the pg gem'],
         [/^go\.mod$/i, /github\.com\/(jackc\/pgx|lib\/pq)/, 'a Postgres driver in go.mod'],
-        [/^cargo\.toml$/i, /tokio-postgres|postgres\s*=|sqlx[^\n]{0,200}postgres|diesel[^\n]{0,200}postgres|sea-orm[^\n]{0,200}postgres/i, 'a Postgres driver in Cargo.toml'],
+        [
+            /^cargo\.toml$/i,
+            /tokio-postgres|postgres\s*=|sqlx[^\n]{0,200}postgres|diesel[^\n]{0,200}postgres|sea-orm[^\n]{0,200}postgres/i,
+            'a Postgres driver in Cargo.toml',
+        ],
         [dotnet, /Npgsql/i, 'Npgsql in a .NET project'],
         [jvm, /org\.postgresql|postgresql:postgresql|r2dbc-postgresql/i, 'the Postgres JDBC driver'],
         [/^composer\.json$/i, /ext-pgsql|ext-pdo_pgsql/i, 'the PHP Postgres extension'],
         [/^mix\.exs$/i, /:postgrex/, 'Postgrex'],
         [/^schema\.prisma$/i, /provider\s*=\s*"(postgresql|postgres|cockroachdb)"/, 'Prisma uses PostgreSQL'],
-        [config, /postgres(ql)?(\+\w+)?:\/\/|DB_CONNECTION\s*=\s*pgsql|adapter:\s*postgres|\bHost=[^;\s]{1,200};\s*(Port=\d{1,5};\s*)?Database=|jdbc:postgresql:/i, 'a Postgres connection string'],
+        [
+            config,
+            /postgres(ql)?(\+\w+)?:\/\/|DB_CONNECTION\s*=\s*pgsql|adapter:\s*postgres|\bHost=[^;\s]{1,200};\s*(Port=\d{1,5};\s*)?Database=|jdbc:postgresql:/i,
+            'a Postgres connection string',
+        ],
     ],
     mysql: [
-        [compose, /image:\s*["']?[\w./-]{0,80}(mysql|mariadb|percona)[\w.-]{0,40}(:|\s|["']|$)/im, 'a compose service runs MySQL / MariaDB'],
+        [
+            compose,
+            /image:\s*["']?[\w./-]{0,80}(mysql|mariadb|percona)[\w.-]{0,40}(:|\s|["']|$)/im,
+            'a compose service runs MySQL / MariaDB',
+        ],
         [manifests, dep('mysql2?|mariadb|@planetscale/database'), 'a MySQL driver in package.json'],
-        [python, dep('pymysql|mysqlclient|mysql-connector-python|aiomysql|asyncmy|mariadb'), 'a MySQL driver in the Python dependencies'],
+        [
+            python,
+            dep('pymysql|mysqlclient|mysql-connector-python|aiomysql|asyncmy|mariadb'),
+            'a MySQL driver in the Python dependencies',
+        ],
         [/^gemfile$/i, /gem\s+["'](mysql2|trilogy)["']/, 'a MySQL gem'],
         [/^go\.mod$/i, /github\.com\/go-sql-driver\/mysql/, 'the MySQL driver in go.mod'],
-        [/^cargo\.toml$/i, /mysql_async|mysql\s*=|sqlx[^\n]{0,200}mysql|diesel[^\n]{0,200}mysql/i, 'a MySQL driver in Cargo.toml'],
+        [
+            /^cargo\.toml$/i,
+            /mysql_async|mysql\s*=|sqlx[^\n]{0,200}mysql|diesel[^\n]{0,200}mysql/i,
+            'a MySQL driver in Cargo.toml',
+        ],
         [dotnet, /MySqlConnector|MySql\.Data|Pomelo\.EntityFrameworkCore\.MySql/i, 'a MySQL driver in a .NET project'],
         [jvm, /mysql-connector|mariadb-java-client|com\.mysql/i, 'the MySQL JDBC driver'],
         [/^composer\.json$/i, /ext-mysqli|ext-pdo_mysql/i, 'the PHP MySQL extension'],
         [/^mix\.exs$/i, /:myxql/, 'MyXQL'],
         [/^schema\.prisma$/i, /provider\s*=\s*"mysql"/, 'Prisma uses MySQL'],
-        [config, /(mysql|mariadb)(\+\w+)?:\/\/|DB_CONNECTION\s*=\s*(mysql|mariadb)|adapter:\s*(mysql2|trilogy)|jdbc:(mysql|mariadb):/i, 'a MySQL connection string'],
+        [
+            config,
+            /(mysql|mariadb)(\+\w+)?:\/\/|DB_CONNECTION\s*=\s*(mysql|mariadb)|adapter:\s*(mysql2|trilogy)|jdbc:(mysql|mariadb):/i,
+            'a MySQL connection string',
+        ],
     ],
     sqlserver: [
-        [compose, /image:\s*["']?(mcr\.microsoft\.com\/(mssql|azure-sql-edge)|[\w./-]{0,80}mssql)[\w./:-]{0,80}/im, 'a compose service runs SQL Server'],
+        [
+            compose,
+            /image:\s*["']?(mcr\.microsoft\.com\/(mssql|azure-sql-edge)|[\w./-]{0,80}mssql)[\w./:-]{0,80}/im,
+            'a compose service runs SQL Server',
+        ],
         [manifests, dep('mssql|tedious|msnodesqlv8'), 'a SQL Server driver in package.json'],
         [python, dep('pyodbc|pymssql|aioodbc|mssql-django'), 'a SQL Server driver in the Python dependencies'],
         [/^go\.mod$/i, /(denisenkom|microsoft)\/go-mssqldb/, 'the SQL Server driver in go.mod'],
         [/^cargo\.toml$/i, /tiberius|sqlx[^\n]{0,200}mssql/i, 'a SQL Server driver in Cargo.toml'],
-        [dotnet, /Microsoft\.Data\.SqlClient|System\.Data\.SqlClient|EntityFrameworkCore\.SqlServer|Dapper\.SqlBuilder|LocalDb/i, 'SQL Server in a .NET project'],
+        [
+            dotnet,
+            /Microsoft\.Data\.SqlClient|System\.Data\.SqlClient|EntityFrameworkCore\.SqlServer|Dapper\.SqlBuilder|LocalDb/i,
+            'SQL Server in a .NET project',
+        ],
         [jvm, /mssql-jdbc|com\.microsoft\.sqlserver/i, 'the SQL Server JDBC driver'],
         [/^composer\.json$/i, /ext-sqlsrv|ext-pdo_sqlsrv/i, 'the PHP SQL Server extension'],
         [/^schema\.prisma$/i, /provider\s*=\s*"sqlserver"/, 'Prisma uses SQL Server'],
-        [config, /\(localdb\)|mssql(\+\w+)?:\/\/|sqlserver:\/\/|DB_CONNECTION\s*=\s*sqlsrv|jdbc:sqlserver:|Initial Catalog=|Trusted_Connection=|TrustServerCertificate=|Integrated Security=/i, 'a SQL Server connection string'],
+        [
+            config,
+            /\(localdb\)|mssql(\+\w+)?:\/\/|sqlserver:\/\/|DB_CONNECTION\s*=\s*sqlsrv|jdbc:sqlserver:|Initial Catalog=|Trusted_Connection=|TrustServerCertificate=|Integrated Security=/i,
+            'a SQL Server connection string',
+        ],
     ],
     mongodb: [
         [compose, /image:\s*["']?[\w./-]{0,80}mongo(db)?[\w.-]{0,40}(:|\s|["']|$)/im, 'a compose service runs MongoDB'],
@@ -66,25 +114,57 @@ const RULES = {
         [config, /mongodb(\+srv)?:\/\//i, 'a MongoDB connection string'],
     ],
     dynamodb: [
-        [compose, /image:\s*["']?(amazon\/dynamodb-local|[\w./-]{0,80}dynamodb-local|instructure\/dynamo-local-admin)[\w.:-]{0,40}/im, 'a compose service runs DynamoDB Local'],
-        [manifests, dep('@aws-sdk/client-dynamodb|@aws-sdk/lib-dynamodb|dynamoose|electrodb|dynamodb-toolbox|@typedorm/core|dynamodb-onetable'), 'a DynamoDB client in package.json'],
-        [python, dep('pynamodb|boto3-stubs\\[[^\\]]{0,80}dynamodb[^\\]]{0,80}\\]|types-aiobotocore-dynamodb|mypy-boto3-dynamodb|dynamorm'), 'a DynamoDB client in the Python dependencies'],
+        [
+            compose,
+            /image:\s*["']?(amazon\/dynamodb-local|[\w./-]{0,80}dynamodb-local|instructure\/dynamo-local-admin)[\w.:-]{0,40}/im,
+            'a compose service runs DynamoDB Local',
+        ],
+        [
+            manifests,
+            dep('@aws-sdk/client-dynamodb|@aws-sdk/lib-dynamodb|dynamoose|electrodb|dynamodb-toolbox|@typedorm/core|dynamodb-onetable'),
+            'a DynamoDB client in package.json',
+        ],
+        [
+            python,
+            dep('pynamodb|boto3-stubs\\[[^\\]]{0,80}dynamodb[^\\]]{0,80}\\]|types-aiobotocore-dynamodb|mypy-boto3-dynamodb|dynamorm'),
+            'a DynamoDB client in the Python dependencies',
+        ],
         [/^gemfile$/i, /gem\s+["'](aws-sdk-dynamodb|dynamoid|aws-record)["']/, 'a DynamoDB gem'],
         [/^go\.mod$/i, /aws-sdk-go-v2\/service\/dynamodb|github\.com\/guregu\/dynamo/, 'a DynamoDB client in go.mod'],
         [/^cargo\.toml$/i, /^\s*(aws-sdk-dynamodb|serde_dynamo|modyne)\s*=/m, 'a DynamoDB crate'],
         [dotnet, /AWSSDK\.DynamoDBv2/i, 'AWSSDK.DynamoDBv2 in a .NET project'],
-        [jvm, /software\.amazon\.awssdk[^\n]{0,200}dynamodb|aws-java-sdk-dynamodb|dynamodb-enhanced/i, 'the DynamoDB Java SDK'],
+        [
+            jvm,
+            /software\.amazon\.awssdk[^\n]{0,200}dynamodb|aws-java-sdk-dynamodb|dynamodb-enhanced/i,
+            'the DynamoDB Java SDK',
+        ],
         [infra, /AWS::DynamoDB::(Global)?Table|aws_dynamodb_table/, 'a DynamoDB table in the infrastructure code'],
-        [config, /AWS_ENDPOINT_URL_DYNAMODB|DYNAMO(DB)?_(ENDPOINT|URL|TABLE)|dynamodb\.[\w-]+\.amazonaws\.com|localhost:8000/i, 'DynamoDB settings in the config'],
+        [
+            config,
+            /AWS_ENDPOINT_URL_DYNAMODB|DYNAMO(DB)?_(ENDPOINT|URL|TABLE)|dynamodb\.[\w-]+\.amazonaws\.com|localhost:8000/i,
+            'DynamoDB settings in the config',
+        ],
     ],
     redis: [
-        [compose, /image:\s*["']?[\w./-]{0,80}(redis|valkey|keydb|dragonfly)[\w.-]{0,40}(:|\s|["']|$)/im, 'a compose service runs Redis'],
-        [manifests, dep('redis|ioredis|bullmq|bull|@upstash/redis|connect-redis|rate-limit-redis'), 'a Redis client in package.json'],
+        [
+            compose,
+            /image:\s*["']?[\w./-]{0,80}(redis|valkey|keydb|dragonfly)[\w.-]{0,40}(:|\s|["']|$)/im,
+            'a compose service runs Redis',
+        ],
+        [
+            manifests,
+            dep('redis|ioredis|bullmq|bull|@upstash/redis|connect-redis|rate-limit-redis'),
+            'a Redis client in package.json',
+        ],
         [python, dep('redis|aioredis|rq|celery\\[redis\\]|django-redis|arq'), 'a Redis client in the Python dependencies'],
         [/^gemfile$/i, /gem\s+["'](redis|sidekiq|resque)["']/, 'a Redis gem'],
         [/^go\.mod$/i, /github\.com\/(redis\/go-redis|go-redis\/redis|gomodule\/redigo)/, 'a Redis client in go.mod'],
         [/^cargo\.toml$/i, /^\s*(redis|deadpool-redis|bb8-redis)\s*=/m, 'a Redis crate'],
-        [dotnet, /StackExchange\.Redis|Microsoft\.Extensions\.Caching\.StackExchangeRedis/i, 'StackExchange.Redis in a .NET project'],
+        [
+            dotnet,
+            /StackExchange\.Redis|Microsoft\.Extensions\.Caching\.StackExchangeRedis/i,
+            'StackExchange.Redis in a .NET project',
+        ],
         [jvm, /jedis|lettuce-core|spring-boot-starter-data-redis|redisson/i, 'a Redis Java client'],
         [/^composer\.json$/i, /predis\/predis|ext-redis/i, 'a PHP Redis client'],
         [config, /rediss?:\/\/|REDIS_(URL|HOST)\s*=|CACHE_DRIVER\s*=\s*redis/i, 'a Redis connection string'],
@@ -111,12 +191,20 @@ const SQL = ['postgres', 'mysql', 'sqlserver'];
 /** Longest line and file looked at: bounded work per file whatever a (sandbox-written) file contains. */
 const MAX_LINE = 1000;
 const MAX_TEXT = 256 * 1024;
-const bounded = (text) => text.slice(0, MAX_TEXT).split('\n').filter((line) => line.length <= MAX_LINE).join('\n');
+const bounded = (text) => text
+    .slice(0, MAX_TEXT)
+    .split('\n')
+    .filter((line) => line.length <= MAX_LINE)
+    .join('\n');
 export const detectDatabases = (input, hostHas = []) => {
     const files = input.map((f) => ({ path: f.path, text: bounded(f.text) }));
     const found = new Map();
-    const add = (db, reason) => { const list = found.get(db) ?? []; if (!list.includes(reason))
-        list.push(reason); found.set(db, list); };
+    const add = (db, reason) => {
+        const list = found.get(db) ?? [];
+        if (!list.includes(reason))
+            list.push(reason);
+        found.set(db, list);
+    };
     for (const file of files) {
         const name = fileName(file.path);
         for (const db of DATABASES)

package/dist/core/detect/index.d.ts

@@ -0,0 +1,4 @@
+export * from './databases.js';
+export * from './toolchains.js';
+export * from './pwsh.js';
+export * from './versions.js';

package/dist/core/detect/index.js

@@ -0,0 +1,4 @@
+export * from './databases.js';
+export * from './toolchains.js';
+export * from './pwsh.js';
+export * from './versions.js';

package/dist/core/{detect-pwsh.d.ts → detect/pwsh.d.ts}

@@ -1,4 +1,4 @@
-import type { ProjectFile } from './detect-databases.js';
+import type { ProjectFile } from './databases.js';
 /** Scripts looked at: the workspace root and one folder down, at most this many, only their start. */
 export declare const PWSH_MAX_SCRIPTS = 40;
 export declare const PWSH_MAX_BYTES: number;

package/dist/core/{detect-pwsh.js → detect/pwsh.js}

@@ -31,7 +31,10 @@ const pwshLine = (raw) => {
             continue;
         if (line[end] !== ' ' && line[end] !== '\t')
             continue;
-        const next = line.slice(end, end + 80).trimStart().split(/\s/, 1)[0] ?? '';
+        const next = line
+            .slice(end, end + 80)
+            .trimStart()
+            .split(/\s/, 1)[0] ?? '';
         if (next.startsWith('-') || next.includes('.ps1'))
             return 'pwsh usage';
     }
@@ -73,27 +76,38 @@ const readStart = (file) => {
 };
 /** *.ps1 / *.psm1 / *.psd1 in the workspace root and its direct sub-folders (root first), capped. Links are skipped. */
 export const readPwshScripts = (root) => {
-    const list = (dir) => { try {
-        return fs.readdirSync(dir, { withFileTypes: true }).slice(0, 2000);
-    }
-    catch {
-        return [];
-    } };
+    const list = (dir) => {
+        try {
+            return fs.readdirSync(dir, { withFileTypes: true }).slice(0, 2000);
+        }
+        catch {
+            return [];
+        }
+    };
     const isScript = (d) => d.isFile() && /\.ps[dm]?1$/i.test(d.name);
     const top = list(root);
     const names = [
         ...top.filter(isScript).map((d) => d.name),
-        ...top.filter((d) => d.isDirectory() && !d.name.startsWith('.') && !SKIP.test(d.name)).slice(0, 200)
-            .flatMap((d) => list(path.join(root, d.name)).filter(isScript).map((f) => d.name + '/' + f.name)),
+        ...top
+            .filter((d) => d.isDirectory() && !d.name.startsWith('.') && !SKIP.test(d.name))
+            .slice(0, 200)
+            .flatMap((d) => list(path.join(root, d.name))
+            .filter(isScript)
+            .map((f) => d.name + '/' + f.name)),
     ].slice(0, PWSH_MAX_SCRIPTS);
-    return names.flatMap((name) => { const text = readStart(path.join(root, name)); return text === null ? [] : [{ path: name, text }]; });
+    return names.flatMap((name) => {
+        const text = readStart(path.join(root, name));
+        return text === null ? [] : [{ path: name, text }];
+    });
 };
 /** PowerShell 7 installed on this PC (the MSI's folder, or a pwsh.exe on PATH other than a Store alias). */
 export const pcHasPwsh = (env = process.env, exists = fs.existsSync) => {
     const programFiles = env.ProgramFiles ?? 'C:\\Program Files';
     if (exists(path.win32.join(programFiles, 'PowerShell', '7', 'pwsh.exe')))
         return true;
-    return (env.PATH ?? env.Path ?? '').split(';').some((d) => d && !/WindowsApps/i.test(d) && exists(path.win32.join(d, 'pwsh.exe')));
+    return (env.PATH ?? env.Path ?? '')
+        .split(';')
+        .some((d) => d && !/WindowsApps/i.test(d) && exists(path.win32.join(d, 'pwsh.exe')));
 };
 /**
  * The decision for toolchains.pwsh.enabled: true/false are kept; "auto" is on when a script needs PowerShell 7, or, in

package/dist/core/{detect-toolchains.d.ts → detect/toolchains.d.ts}

@@ -1,4 +1,4 @@
-import type { Toolchains } from './types.js';
+import type { Toolchains } from '../types.js';
 /** Files that show a project uses a language (looked for in the workspace and one folder down). */
 export declare const MARKERS: {
     readonly python: readonly ["pyproject.toml", "requirements.txt", "setup.py", "setup.cfg", "Pipfile", "uv.lock", "poetry.lock", ".python-version", "*.py", "*.ipynb"];

package/dist/core/{detect-toolchains.js → detect/toolchains.js}

@@ -1,13 +1,47 @@
-import { projectUses } from '../guest/toolchains/versions.js';
+import { projectUses } from './versions.js';
 /** Files that show a project uses a language (looked for in the workspace and one folder down). */
 export const MARKERS = {
-    python: ['pyproject.toml', 'requirements.txt', 'setup.py', 'setup.cfg', 'Pipfile', 'uv.lock', 'poetry.lock', '.python-version', '*.py', '*.ipynb'],
+    python: [
+        'pyproject.toml',
+        'requirements.txt',
+        'setup.py',
+        'setup.cfg',
+        'Pipfile',
+        'uv.lock',
+        'poetry.lock',
+        '.python-version',
+        '*.py',
+        '*.ipynb',
+    ],
     rust: ['Cargo.toml', 'rust-toolchain', 'rust-toolchain.toml'],
     msvc: ['*.vcxproj', 'CMakePresets.json', 'CMakeUserPresets.json'],
-    cpp: ['CMakeLists.txt', 'Makefile', 'meson.build', 'premake5.lua', 'Cargo.toml', '*.vcxproj', '*.c', '*.cpp', '*.cc', '*.h', '*.hpp'],
+    cpp: [
+        'CMakeLists.txt',
+        'Makefile',
+        'meson.build',
+        'premake5.lua',
+        'Cargo.toml',
+        '*.vcxproj',
+        '*.c',
+        '*.cpp',
+        '*.cc',
+        '*.h',
+        '*.hpp',
+    ],
     dotnet: ['*.sln', '*.slnx', '*.csproj', '*.fsproj', '*.vbproj', 'global.json', '*.cs'],
     go: ['go.mod', 'go.work', '*.go'],
-    java: ['pom.xml', 'build.gradle', 'build.gradle.kts', 'settings.gradle', 'settings.gradle.kts', 'mvnw', 'gradlew', '.java-version', '.sdkmanrc', '*.java'],
+    java: [
+        'pom.xml',
+        'build.gradle',
+        'build.gradle.kts',
+        'settings.gradle',
+        'settings.gradle.kts',
+        'mvnw',
+        'gradlew',
+        '.java-version',
+        '.sdkmanrc',
+        '*.java',
+    ],
     ruby: ['Gemfile', '*.gemspec', '.ruby-version', '*.rb'],
     php: ['composer.json', 'artisan', '.php-version', '*.php'],
     deno: ['deno.json', 'deno.jsonc', 'deno.lock'],
@@ -44,7 +78,10 @@ export const decideToolchains = (settings, entries, pcHas, hints = {}) => {
         result.msvc = { on: true, reason: 'Rust on this PC builds with MSVC' };
     // MSVC is a 1-2 GB licensed download: "auto" only installs it once its licence is accepted.
     if (settings.msvc.enabled === 'auto' && result.msvc.on && !settings.msvc.acceptLicense)
-        result.msvc = { on: false, reason: 'would be used (' + result.msvc.reason + '); set toolchains.msvc.acceptLicense to install it' };
+        result.msvc = {
+            on: false,
+            reason: 'would be used (' + result.msvc.reason + '); set toolchains.msvc.acceptLicense to install it',
+        };
     if (result.rust.on && !result.msvc.on && !result.cpp.on && settings.cpp.enabled !== false)
         result.cpp = { on: true, reason: 'the linker for Rust' };
     return result;