@adaptabletools/adaptable-mcp 0.1.0-canary.0 → 0.1.0-canary.2

package/dist/core/packages/load-entry.js

@@ -0,0 +1,123 @@
+/**
+ * Loads a library entry (`aql`, `upgrade`) from a resolved package. The
+ * published package is bundler-only ESM (extensionless relative imports), so
+ * each entry is bundled once per version with esbuild into
+ * `entries/<version>/<entry>.mjs` and imported from there (plan §7.3).
+ *
+ * `ADAPTABLE_MCP_ADAPTABLE_SRC` points at an AdapTable source folder instead
+ * (e.g. `packages/adaptable` in the AdapTable repo); source bundles are never
+ * cached because they change with every edit.
+ */
+import { createHash } from 'node:crypto';
+import { existsSync, mkdirSync, readFileSync, statSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { build } from 'esbuild';
+import { entriesCacheDir } from './cache.js';
+import { entryNodePaths } from './prepare.js';
+export const SOURCE_ENV = 'ADAPTABLE_MCP_ADAPTABLE_SRC';
+/** The source override, when `ADAPTABLE_MCP_ADAPTABLE_SRC` is set */
+export function sourceOverride() {
+    const dir = process.env[SOURCE_ENV];
+    return dir ? { kind: 'source', dir } : undefined;
+}
+export const packageLocation = (pkg) => ({
+    kind: 'package',
+    version: pkg.version,
+    dir: pkg.dir,
+});
+function entryFile(location, name) {
+    if (location.kind === 'source') {
+        const entry = join(location.dir, `${name}.ts`);
+        const tsconfig = join(location.dir, 'tsconfig.cjs.json');
+        return existsSync(entry) ? { entry, tsconfig: existsSync(tsconfig) ? tsconfig : undefined } : undefined;
+    }
+    const entry = join(location.dir, `${name}.js`);
+    return existsSync(entry) ? { entry } : undefined;
+}
+function sourceStamp(dir) {
+    // a source entry changes with every edit to the files it imports: never reuse a bundle
+    return createHash('sha256').update(dir).update(`${process.pid}-${Date.now()}`).digest('hex').slice(0, 16);
+}
+function packageVersionAt(dir) {
+    try {
+        return JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8')).version;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function bundle(entry, outfile, tsconfig, nodePaths) {
+    mkdirSync(join(outfile, '..'), { recursive: true });
+    await build({
+        entryPoints: [entry],
+        bundle: true,
+        platform: 'node',
+        format: 'esm',
+        outfile,
+        tsconfig,
+        nodePaths,
+        logLevel: 'silent',
+    });
+}
+const loaded = new Map();
+async function loadUncached(location, name) {
+    const found = entryFile(location, name);
+    if (!found) {
+        const where = location.kind === 'source' ? location.dir : `${location.dir} (version ${location.version})`;
+        return {
+            ok: false,
+            reason: `${where} has no ${name} entry point; it ships with @adaptabletools/adaptable 24 and later.`,
+        };
+    }
+    let outfile;
+    let cacheable;
+    if (location.kind === 'source') {
+        outfile = join(tmpdir(), `adaptable-${name}-${sourceStamp(location.dir)}.mjs`);
+        cacheable = false;
+    }
+    else {
+        // the folder is keyed by the declared version; the file name also carries the
+        // entry's mtime so a re-fetched or edited package of the same version is rebundled
+        const version = packageVersionAt(location.dir) ?? location.version;
+        const stamp = createHash('sha256')
+            .update(found.entry)
+            .update(String(statSync(found.entry).mtimeMs))
+            .digest('hex')
+            .slice(0, 8);
+        outfile = join(entriesCacheDir(version), `${name}-${stamp}.mjs`);
+        cacheable = true;
+    }
+    try {
+        if (!cacheable || !existsSync(outfile)) {
+            await bundle(found.entry, outfile, found.tsconfig, location.kind === 'package' ? entryNodePaths(location.dir) : undefined);
+        }
+        const module = await import(pathToFileURL(outfile).href);
+        return { ok: true, module, source: found.entry, bundle: outfile };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        const unresolved = [...message.matchAll(/Could not resolve "([^"]+)"/g)].map((m) => m[1]);
+        const hint = unresolved.length && location.kind === 'package'
+            ? ` The package folder lacks ${[...new Set(unresolved)].join(', ')}; re-run \`adaptable cache add ${location.version}\` on a connected machine to install the entry dependencies.`
+            : '';
+        return { ok: false, reason: `Could not load ${found.entry}: ${message}${hint}` };
+    }
+}
+/** Loads `name` from `location`, bundling it first when needed; memoised per process */
+export function loadEntry(location, name) {
+    const key = `${location.kind}:${location.dir}:${name}`;
+    let result = loaded.get(key);
+    if (!result) {
+        result = loadUncached(location, name);
+        result.then((r) => {
+            if (!r.ok) {
+                loaded.delete(key);
+            }
+        });
+        loaded.set(key, result);
+    }
+    return result;
+}
+//# sourceMappingURL=load-entry.js.map

package/dist/core/packages/load-entry.js.map

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

package/dist/core/packages/prepare.js

@@ -0,0 +1,122 @@
+/**
+ * Makes an extracted library package usable on its own. A tarball has no
+ * `node_modules`, but the `aql` and `upgrade` entries import a few runtime
+ * dependencies (`date-fns`, `uuid`, `react`, …) that esbuild must resolve when
+ * it bundles them. Rather than installing the library's ~30 dependencies, the
+ * bundle itself is the oracle: try it, install exactly the packages it could
+ * not resolve into a private `.deps/` folder (pinned to the ranges the library
+ * declares), and try again until it builds. Transitive peers (`react` for
+ * `react-toastify`) surface in the second round.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { build } from 'esbuild';
+import { exec, NPM } from './exec.js';
+export const ENTRY_FILES = ['aql.js', 'upgrade.js'];
+/**
+ * Folder, inside a cached package, holding only the dependencies its entries need.
+ * It has its own `package.json`, so npm installs exactly that set instead of
+ * reconciling the library's full dependency tree; esbuild reaches it through
+ * `nodePaths` (`entryNodePaths`).
+ */
+export const DEPS_DIR = '.deps';
+export const entryNodePaths = (packageDir) => [join(packageDir, DEPS_DIR, 'node_modules')];
+/** `@scope/name` or `name` from an import specifier */
+export function packageNameOf(specifier) {
+    const parts = specifier.split('/');
+    return specifier.startsWith('@') ? parts.slice(0, 2).join('/') : parts[0];
+}
+/** Package names an esbuild failure message could not resolve */
+export function unresolvedPackages(message) {
+    const names = new Set();
+    for (const match of message.matchAll(/Could not resolve "([^"]+)"/g)) {
+        const specifier = match[1];
+        if (!specifier.startsWith('.') && !specifier.startsWith('/') && !specifier.startsWith('node:')) {
+            names.add(packageNameOf(specifier));
+        }
+    }
+    return [...names].sort();
+}
+/** Packages a bundle of `entryFile` cannot resolve; empty when it builds */
+export async function probeUnresolved(entryFile, nodePaths) {
+    try {
+        await build({
+            entryPoints: [entryFile],
+            bundle: true,
+            write: false,
+            platform: 'node',
+            format: 'esm',
+            nodePaths,
+            logLevel: 'silent',
+        });
+        return [];
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        const names = unresolvedPackages(message);
+        if (!names.length) {
+            throw error;
+        }
+        return names;
+    }
+}
+function declaredRanges(dir) {
+    try {
+        const pkg = JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8'));
+        return { ...(pkg.peerDependencies ?? {}), ...(pkg.dependencies ?? {}) };
+    }
+    catch {
+        return {};
+    }
+}
+function depsManifest(depsDir) {
+    try {
+        return JSON.parse(readFileSync(join(depsDir, 'package.json'), 'utf8'))
+            .dependencies ?? {};
+    }
+    catch {
+        return {};
+    }
+}
+/** Adds `names` to `<packageDir>/.deps` and installs it, pinned to the ranges the package declares */
+export async function installEntryDependencies(packageDir, names, timeoutMs = 300_000) {
+    if (!names.length) {
+        return;
+    }
+    const ranges = declaredRanges(packageDir);
+    const depsDir = join(packageDir, DEPS_DIR);
+    mkdirSync(depsDir, { recursive: true });
+    const dependencies = { ...depsManifest(depsDir) };
+    for (const name of names) {
+        dependencies[name] = ranges[name] ?? '*';
+    }
+    writeFileSync(join(depsDir, 'package.json'), JSON.stringify({
+        name: 'adaptable-mcp-entry-deps',
+        private: true,
+        description: 'Runtime dependencies of the aql and upgrade entries, installed by @adaptabletools/adaptable-mcp',
+        dependencies: Object.fromEntries(Object.entries(dependencies).sort(([a], [b]) => a.localeCompare(b))),
+    }, null, 2));
+    await exec(NPM, ['install', '--prefix', depsDir, '--no-package-lock', '--ignore-scripts', '--omit=dev', '--omit=peer', '--no-audit', '--no-fund', '--silent'], { cwd: depsDir, timeoutMs });
+}
+const MAX_ROUNDS = 5;
+/** Installs whatever the package's entries need to bundle; no-op for packages without entries */
+export async function prepareEntries(packageDir) {
+    const entries = ENTRY_FILES.filter((file) => existsSync(join(packageDir, file)));
+    const installed = [];
+    const nodePaths = entryNodePaths(packageDir);
+    for (const entry of entries) {
+        for (let round = 0;; round++) {
+            const missing = await probeUnresolved(join(packageDir, entry), nodePaths);
+            if (!missing.length) {
+                break;
+            }
+            if (round >= MAX_ROUNDS) {
+                throw new Error(`${entry} still cannot resolve ${missing.join(', ')} after ${MAX_ROUNDS} install rounds.`);
+            }
+            await installEntryDependencies(packageDir, missing);
+            installed.push(...missing);
+        }
+    }
+    return { entries: [...entries], installed };
+}
+//# sourceMappingURL=prepare.js.map

package/dist/core/packages/prepare.js.map

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

package/dist/core/packages/registry.js

@@ -0,0 +1,75 @@
+/**
+ * The npm registry as the resolver sees it (plan §7.3, step 3): list the
+ * library's versions, `npm pack` one into the cache and make its entries
+ * bundle-able (`prepare.ts`). Goes through the `npm` CLI so `HTTPS_PROXY` and
+ * `.npmrc` (registry, auth) are honoured without reimplementing them; `tar`
+ * extracts the tarball.
+ */
+import { mkdirSync, mkdtempSync, renameSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { LIBRARY_PACKAGE } from '../constants.js';
+import { CapabilityError } from '../envelope.js';
+import { packageCacheDir } from './cache.js';
+import { exec, NPM } from './exec.js';
+import { prepareEntries } from './prepare.js';
+function networkError(action, error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    return new CapabilityError('NETWORK_REQUIRED', `Could not ${action} from the npm registry: ${detail}`, 'Check registry access (HTTPS_PROXY, .npmrc), or run `adaptable cache add <major>` on a connected machine and copy the cache.');
+}
+/** The real registry, through the npm CLI */
+export function npmRegistry(options = {}) {
+    const execOptions = { cwd: options.cwd, timeoutMs: options.timeoutMs ?? 120_000 };
+    return {
+        async view() {
+            let raw;
+            try {
+                raw = await exec(NPM, ['view', LIBRARY_PACKAGE, 'versions', 'dist-tags', '--json'], execOptions);
+            }
+            catch (error) {
+                throw networkError(`read the versions of ${LIBRARY_PACKAGE}`, error);
+            }
+            const parsed = JSON.parse(raw);
+            const versions = Array.isArray(parsed.versions) ? parsed.versions : parsed.versions ? [parsed.versions] : [];
+            return { versions, distTags: parsed['dist-tags'] ?? {} };
+        },
+        async fetch(version) {
+            const target = packageCacheDir(version);
+            const staging = mkdtempSync(join(tmpdir(), 'adaptable-pack-'));
+            try {
+                let raw;
+                try {
+                    raw = await exec(NPM, ['pack', `${LIBRARY_PACKAGE}@${version}`, '--pack-destination', staging, '--json', '--silent'], execOptions);
+                }
+                catch (error) {
+                    throw networkError(`download ${LIBRARY_PACKAGE}@${version}`, error);
+                }
+                const [{ filename }] = JSON.parse(raw);
+                const extracted = join(staging, 'pkg');
+                mkdirSync(extracted);
+                try {
+                    await exec('tar', ['-xzf', join(staging, filename), '-C', extracted, '--strip-components=1'], execOptions);
+                }
+                catch (error) {
+                    throw new CapabilityError('PACKAGE_REQUIRED', `Downloaded ${LIBRARY_PACKAGE}@${version} but could not extract it: ${error instanceof Error ? error.message : String(error)}`, 'A `tar` executable is needed on PATH; alternatively run `npm i -D @adaptabletools/adaptable@<major>` in the project.');
+                }
+                // install the entries' runtime dependencies while still in staging, so a
+                // half-prepared package never lands in the cache
+                try {
+                    await prepareEntries(extracted);
+                }
+                catch (error) {
+                    throw networkError(`install the dependencies of ${LIBRARY_PACKAGE}@${version}'s entries`, error);
+                }
+                mkdirSync(dirname(target), { recursive: true });
+                rmSync(target, { recursive: true, force: true });
+                renameSync(extracted, target);
+                return target;
+            }
+            finally {
+                rmSync(staging, { recursive: true, force: true });
+            }
+        },
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/core/packages/registry.js.map

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

package/dist/core/packages/resolve.js

@@ -0,0 +1,94 @@
+/**
+ * Code truth (plan §7.3): which `@adaptabletools/adaptable` a call uses.
+ *
+ * Two requirements exist. The *types* package is the major being checked (its
+ * `types.d.ts` describes that version). The *engine* package is any major ≥ 24,
+ * because the `aql` and `upgrade` entries exist only there — a 23 project never
+ * uses its own package as the engine. Resolution for either, in order:
+ *   1. the project's installed package when it satisfies the requirement   (codeSource: installed)
+ *   2. the newest satisfying version in the cache                            (codeSource: cached)
+ *   3. unless --offline, the newest satisfying version from the registry     (codeSource: cached)
+ *   4. PACKAGE_REQUIRED
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { ENGINE_FLOOR, LIBRARY_PACKAGE } from '../constants.js';
+import { CapabilityError } from '../envelope.js';
+import { listCachedPackages } from './cache.js';
+import { npmRegistry } from './registry.js';
+import { majorOfVersion, newestSatisfying } from './versions.js';
+export function requirementSatisfied(requirement, major) {
+    return requirement.kind === 'types' ? major === requirement.major : major >= ENGINE_FLOOR;
+}
+export function describeRequirement(requirement) {
+    return requirement.kind === 'types'
+        ? `${LIBRARY_PACKAGE} ${requirement.major}.x (the types of the checked major)`
+        : `${LIBRARY_PACKAGE} ${ENGINE_FLOOR} or later (the engine with the aql and upgrade entries)`;
+}
+/** The library installed for a project: the nearest `node_modules/@adaptabletools/adaptable` at or above it */
+export function findInstalledLibrary(projectDir) {
+    let dir = resolve(projectDir);
+    for (;;) {
+        const candidate = join(dir, 'node_modules', LIBRARY_PACKAGE);
+        if (existsSync(join(candidate, 'package.json'))) {
+            try {
+                const { version } = JSON.parse(readFileSync(join(candidate, 'package.json'), 'utf8'));
+                if (version) {
+                    return { version, dir: candidate };
+                }
+            }
+            catch {
+                // unreadable package.json: keep walking
+            }
+        }
+        const parent = dirname(dir);
+        if (parent === dir) {
+            return undefined;
+        }
+        dir = parent;
+    }
+}
+export async function resolvePackage(requirement, options = {}) {
+    const installed = options.installed !== undefined
+        ? options.installed ?? undefined
+        : options.projectDir
+            ? findInstalledLibrary(options.projectDir)
+            : undefined;
+    const installedMajor = installed ? majorOfVersion(installed.version) : undefined;
+    if (installed && installedMajor !== undefined && requirementSatisfied(requirement, installedMajor)) {
+        return { name: LIBRARY_PACKAGE, ...installed, source: 'installed' };
+    }
+    const cached = listCachedPackages();
+    const cachedVersion = newestSatisfying(cached.map((p) => p.version), (major) => requirementSatisfied(requirement, major));
+    if (cachedVersion) {
+        const hit = cached.find((p) => p.version === cachedVersion);
+        return { name: LIBRARY_PACKAGE, version: hit.version, dir: hit.dir, source: 'cached' };
+    }
+    const hint = requirement.kind === 'types'
+        ? `Run \`adaptable cache add ${requirement.major}\` (needs registry access) or \`npm i -D ${LIBRARY_PACKAGE}@${requirement.major}\`.`
+        : `Run \`adaptable cache add ${ENGINE_FLOOR}\` (needs registry access) or \`npm i -D ${LIBRARY_PACKAGE}@${ENGINE_FLOOR}\`.`;
+    const have = installed ? `the installed ${installed.version} does not satisfy it` : 'nothing is installed';
+    if (options.offline) {
+        throw new CapabilityError('PACKAGE_REQUIRED', `No ${describeRequirement(requirement)} is installed or cached (${have}), and --offline prevents fetching one.`, hint);
+    }
+    const registry = options.registry ?? npmRegistry({ cwd: options.projectDir });
+    const view = await registry.view();
+    const version = newestSatisfying(view.versions, (major) => requirementSatisfied(requirement, major));
+    if (!version) {
+        throw new CapabilityError('PACKAGE_REQUIRED', `The npm registry has no ${describeRequirement(requirement)} (${have}).`, hint);
+    }
+    const dir = await registry.fetch(version);
+    return { name: LIBRARY_PACKAGE, version, dir, source: 'cached' };
+}
+/** `cache add <major|version|dist-tag>`: the version to download for a user-supplied spec */
+export function pickVersion(spec, view) {
+    if (/^\d+$/.test(spec)) {
+        const major = Number(spec);
+        return newestSatisfying(view.versions, (m) => m === major);
+    }
+    if (view.versions.includes(spec)) {
+        return spec;
+    }
+    return view.distTags[spec];
+}
+//# sourceMappingURL=resolve.js.map

package/dist/core/packages/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../src/core/packages/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,WAAW,EAAwB,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAwBjE,MAAM,UAAU,oBAAoB,CAAC,WAA+B,EAAE,KAAa;IACjF,OAAO,WAAW,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,KAAK,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,YAAY,CAAC;AAC5F,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,WAA+B;IACjE,OAAO,WAAW,CAAC,IAAI,KAAK,OAAO;QACjC,CAAC,CAAC,GAAG,eAAe,IAAI,WAAW,CAAC,KAAK,qCAAqC;QAC9E,CAAC,CAAC,GAAG,eAAe,IAAI,YAAY,yDAAyD,CAAC;AAClG,CAAC;AAED,+GAA+G;AAC/G,MAAM,UAAU,oBAAoB,CAAC,UAAkB;IACrD,IAAI,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC9B,SAAS,CAAC;QACR,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,eAAe,CAAC,CAAC;QAC7D,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;YAChD,IAAI,CAAC;gBACH,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAyB,CAAC;gBAC9G,IAAI,OAAO,EAAE,CAAC;oBACZ,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC;gBACrC,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,wCAAwC;YAC1C,CAAC;QACH,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,WAA+B,EAC/B,UAA0B,EAAE;IAE5B,MAAM,SAAS,GACb,OAAO,CAAC,SAAS,KAAK,SAAS;QAC7B,CAAC,CAAC,OAAO,CAAC,SAAS,IAAI,SAAS;QAChC,CAAC,CAAC,OAAO,CAAC,UAAU;YAClB,CAAC,CAAC,oBAAoB,CAAC,OAAO,CAAC,UAAU,CAAC;YAC1C,CAAC,CAAC,SAAS,CAAC;IAElB,MAAM,cAAc,GAAG,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACjF,IAAI,SAAS,IAAI,cAAc,KAAK,SAAS,IAAI,oBAAoB,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,CAAC;QACnG,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,GAAG,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACtE,CAAC;IAED,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;IACpC,MAAM,aAAa,GAAG,gBAAgB,CACpC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAC5B,CAAC,KAAK,EAAE,EAAE,CAAC,oBAAoB,CAAC,WAAW,EAAE,KAAK,CAAC,CACpD,CAAC;IACF,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,aAAa,CAAE,CAAC;QAC7D,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IACzF,CAAC;IAED,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,KAAK,OAAO;QACvC,CAAC,CAAC,6BAA6B,WAAW,CAAC,KAAK,4CAA4C,eAAe,IAAI,WAAW,CAAC,KAAK,KAAK;QACrI,CAAC,CAAC,6BAA6B,YAAY,4CAA4C,eAAe,IAAI,YAAY,KAAK,CAAC;IAC9H,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,iBAAiB,SAAS,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAC,sBAAsB,CAAC;IAE3G,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,eAAe,CACvB,kBAAkB,EAClB,MAAM,mBAAmB,CAAC,WAAW,CAAC,4BAA4B,IAAI,yCAAyC,EAC/G,IAAI,CACL,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,WAAW,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC9E,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,oBAAoB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;IACrG,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,eAAe,CACvB,kBAAkB,EAClB,2BAA2B,mBAAmB,CAAC,WAAW,CAAC,KAAK,IAAI,IAAI,EACxE,IAAI,CACL,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC1C,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AACnE,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,IAA8D;IACtG,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,gBAAgB,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC"}

package/dist/core/packages/versions.js

@@ -0,0 +1,71 @@
+/** Just enough semver for choosing between library versions (prereleases sort below their release). */
+export function parseSemver(version) {
+    const match = version.trim().match(/^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/);
+    if (!match) {
+        return undefined;
+    }
+    return {
+        major: Number(match[1]),
+        minor: Number(match[2]),
+        patch: Number(match[3]),
+        prerelease: match[4] ? match[4].split('.').map((p) => (/^\d+$/.test(p) ? Number(p) : p)) : [],
+    };
+}
+function comparePrerelease(a, b) {
+    if (!a.length && !b.length) {
+        return 0;
+    }
+    if (!a.length) {
+        return 1; // a release is newer than any of its prereleases
+    }
+    if (!b.length) {
+        return -1;
+    }
+    for (let i = 0; i < Math.max(a.length, b.length); i++) {
+        if (a[i] === undefined) {
+            return -1;
+        }
+        if (b[i] === undefined) {
+            return 1;
+        }
+        if (a[i] === b[i]) {
+            continue;
+        }
+        if (typeof a[i] === 'number' && typeof b[i] === 'number') {
+            return a[i] - b[i];
+        }
+        if (typeof a[i] === 'number') {
+            return -1;
+        }
+        if (typeof b[i] === 'number') {
+            return 1;
+        }
+        return String(a[i]) < String(b[i]) ? -1 : 1;
+    }
+    return 0;
+}
+/** Negative when `a` is older than `b`; unparsable versions sort first */
+export function compareSemver(a, b) {
+    const pa = parseSemver(a);
+    const pb = parseSemver(b);
+    if (!pa || !pb) {
+        return Number(!!pa) - Number(!!pb);
+    }
+    return pa.major - pb.major || pa.minor - pb.minor || pa.patch - pb.patch || comparePrerelease(pa.prerelease, pb.prerelease);
+}
+export const isPrerelease = (version) => (parseSemver(version)?.prerelease.length ?? 0) > 0;
+export const majorOfVersion = (version) => parseSemver(version)?.major;
+/**
+ * The newest version satisfying `predicate`: the newest stable one, else the
+ * newest prerelease (so a major that only has canaries so far is still usable).
+ */
+export function newestSatisfying(versions, predicate) {
+    const candidates = versions.filter((v) => {
+        const major = majorOfVersion(v);
+        return major !== undefined && predicate(major);
+    });
+    const sorted = [...candidates].sort(compareSemver);
+    const stable = sorted.filter((v) => !isPrerelease(v));
+    return (stable.length ? stable : sorted).at(-1);
+}
+//# sourceMappingURL=versions.js.map

package/dist/core/packages/versions.js.map

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

package/dist/core/ping.js

@@ -0,0 +1,22 @@
+/**
+ * Hidden capability used by the registry, binding and parity tests: echoes its
+ * input together with the resolved context, so every transport can be checked
+ * end to end without a real capability.
+ */
+import { z } from 'zod';
+import { registerCapability } from './capabilities.js';
+import { ok } from './envelope.js';
+registerCapability({
+    name: 'ping',
+    description: 'Echoes a message with the resolved context. Test-only.',
+    cli: { command: ['ping'], positionals: ['message'] },
+    mcp: null,
+    hidden: true,
+    input: z.object({ message: z.string().default('pong') }),
+    output: z.object({ message: z.string(), cwd: z.string() }),
+    run: async (input, ctx) => {
+        const { context, warnings } = await ctx.resolveContext();
+        return ok({ message: input.message, cwd: ctx.cwd }, { resolvedContext: context, warnings });
+    },
+});
+//# sourceMappingURL=ping.js.map

package/dist/core/ping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ping.js","sourceRoot":"","sources":["../../src/core/ping.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AAEnC,kBAAkB,CAAC;IACjB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,wDAAwD;IACrE,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC,SAAS,CAAC,EAAE;IACpD,GAAG,EAAE,IAAI;IACT,MAAM,EAAE,IAAI;IACZ,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;IACxD,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;IAC1D,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACxB,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,GAAG,CAAC,cAAc,EAAE,CAAC;QACzD,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,EAAE,EAAE,eAAe,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC9F,CAAC;CACF,CAAC,CAAC"}

package/dist/core/register.js

@@ -0,0 +1,18 @@
+/**
+ * Side-effect imports that populate the registry. Every capability module
+ * registers itself on import; add new ones here so `src/core/index.ts` sees them.
+ */
+import './anonymise/capabilities.js';
+import './aql/capabilities.js';
+import './changes/capabilities.js';
+import './compat/capabilities.js';
+import './context/capabilities.js';
+import './convert/capabilities.js';
+import './docs/capabilities.js';
+import './migrate/capabilities.js';
+import './packages/capabilities.js';
+import './ping.js';
+import './scaffold/capabilities.js';
+import './setup/capabilities.js';
+import './state/capabilities.js';
+//# sourceMappingURL=register.js.map

package/dist/core/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../src/core/register.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,6BAA6B,CAAC;AACrC,OAAO,uBAAuB,CAAC;AAC/B,OAAO,2BAA2B,CAAC;AACnC,OAAO,0BAA0B,CAAC;AAClC,OAAO,2BAA2B,CAAC;AACnC,OAAO,2BAA2B,CAAC;AACnC,OAAO,wBAAwB,CAAC;AAChC,OAAO,2BAA2B,CAAC;AACnC,OAAO,4BAA4B,CAAC;AACpC,OAAO,WAAW,CAAC;AACnB,OAAO,4BAA4B,CAAC;AACpC,OAAO,yBAAyB,CAAC;AACjC,OAAO,yBAAyB,CAAC"}