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

package/dist/core/migrate/state.js

@@ -0,0 +1,295 @@
+/**
+ * `migrate state` (plan §8.8): the engine package's `upgrade` entry — always a
+ * ≥ 24 package, resolved independently of the project's major (plan §7.3) —
+ * runs `AdaptableUpgradeHelper.migrateAdaptableState(state, { fromVersion, toVersion })`
+ * on the extracted State; the result is checked for leftovers against the
+ * target major's types and run through `check state --major <to>`.
+ *
+ * Source-file inputs: the extractor stubs functions and other unverifiable
+ * values as `null`. Each stub is replaced by a sentinel before the engine runs,
+ * found again afterwards at its (possibly moved) path, and reported — as a
+ * readable placeholder in the migrated State and as a line of `unverifiable[]`
+ * naming where the original code is; a sentinel the engine dropped is listed
+ * as such. Transport-free; `capabilities.ts` binds it.
+ */
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { basename, dirname, resolve } from 'node:path';
+import { ENGINE_FLOOR, LIBRARY_PACKAGE, MIGRATION_FLOOR } from '../constants.js';
+import { bundledRenamesFor } from '../changes/records.js';
+import { CapabilityError } from '../envelope.js';
+import { childPath, indexPath } from '../extract/line-map.js';
+import { loadEntry, packageLocation, sourceOverride } from '../packages/load-entry.js';
+import { resolvePackage } from '../packages/resolve.js';
+import { checkState, extractQuietly, readState } from '../state/check.js';
+import { isObj } from '../state/expressions.js';
+import { findLeftovers, getAt, leftoverIssue, setAt } from './leftovers.js';
+/** Oldest major `migrate state` targets (plan §1 decision 2: 22, 23 or 24) */
+export const MIGRATION_TARGET_FLOOR = 22;
+const upgrades = new Map();
+/** The engine's `upgrade` entry, bundled and imported once per location per process */
+function loadUpgrade(location) {
+    const key = location.kind === 'source' ? `source:${location.dir}` : `package:${location.version}:${location.dir}`;
+    let pending = upgrades.get(key);
+    if (!pending) {
+        pending = loadEntry(location, 'upgrade');
+        upgrades.set(key, pending);
+    }
+    return pending;
+}
+/** Resolves the engine (plan §7.3: newest ≥ 24, never the project's own pre-24 package) and loads its `upgrade` entry */
+export async function resolveUpgradeEngine(deps) {
+    const override = sourceOverride();
+    const resolved = override ? undefined : await resolvePackage({ kind: 'engine' }, deps);
+    const location = override ?? packageLocation(resolved);
+    const loaded = await loadUpgrade(location);
+    if (!loaded.ok) {
+        throw new CapabilityError('PACKAGE_REQUIRED', `The migration engine could not be loaded: ${loaded.reason}`, `Run \`adaptable cache add ${ENGINE_FLOOR}\` on a connected machine (or \`npm i -D ${LIBRARY_PACKAGE}@${ENGINE_FLOOR}\`) and retry.`);
+    }
+    const major = loaded.module.AdaptableUpgradeHelper.getCurrentMajorVersion();
+    return {
+        module: loaded.module,
+        location,
+        ...(resolved ? { resolved } : {}),
+        info: resolved
+            ? { version: resolved.version, source: resolved.source, major, label: `${resolved.version} (${resolved.source})` }
+            : { version: 'source', source: 'source', major, label: `source@${location.dir}` },
+    };
+}
+const SENTINEL = (index) => `__adaptable_mcp_unverifiable_${index}__`;
+const SENTINEL_PATTERN = /__adaptable_mcp_unverifiable_(\d+)__/g;
+/** Kinds whose value the extractor stubbed as `null` (the other two annotate a container) */
+const stubsValue = (u) => u.kind !== 'spread' && u.kind !== 'computed-key';
+const placeholderFor = (u) => `<unverifiable: ${u.kind} at ${basename(u.file)}:${u.line}:${u.column}>`;
+/** Every sentinel in `value`, by index → where it is and whether the string is the sentinel alone or contains it */
+function findSentinels(value, path = '', found = new Map()) {
+    if (typeof value === 'string') {
+        for (const match of value.matchAll(SENTINEL_PATTERN)) {
+            found.set(Number(match[1]), { path, exact: match[0] === value });
+        }
+    }
+    else if (Array.isArray(value)) {
+        value.forEach((item, index) => findSentinels(item, indexPath(path, index), found));
+    }
+    else if (isObj(value)) {
+        for (const [key, child] of Object.entries(value)) {
+            findSentinels(child, childPath(path, key), found);
+        }
+    }
+    return found;
+}
+/** JSON with object keys sorted at every level, for an order-insensitive comparison */
+export function stableStringify(value) {
+    if (Array.isArray(value)) {
+        return `[${value.map(stableStringify).join(',')}]`;
+    }
+    if (isObj(value)) {
+        return `{${Object.keys(value)
+            .sort()
+            .map((key) => `${JSON.stringify(key)}:${stableStringify(value[key])}`)
+            .join(',')}}`;
+    }
+    return JSON.stringify(value) ?? 'null';
+}
+function usage(message, hint) {
+    return new CapabilityError('USAGE', message, hint);
+}
+/** The `--from` / `--to` rules shared by `migrate state` and `migrate expression` (plan §8.8, §8.9, §1 decision 2) */
+export function validateRange(input, deps, engine) {
+    const to = input.to ?? engine.major;
+    const from = input.from ?? deps.projectMajor;
+    if (from === undefined) {
+        throw usage('The major the State was written for could not be determined.', 'Pass `--from <major>` (the AdapTable version the State comes from), or run inside the project that owns it.');
+    }
+    if (!Number.isInteger(from) || !Number.isInteger(to)) {
+        throw usage('`--from` and `--to` must be whole major versions (e.g. 22).', 'Example: `adaptable migrate state state.json --from 22 --to 24`.');
+    }
+    if (from < MIGRATION_FLOOR) {
+        throw usage(`\`--from ${from}\` is below ${MIGRATION_FLOOR}, the oldest major the migration engine knows.`, `State older than ${MIGRATION_FLOOR} is migrated as ${MIGRATION_FLOOR}: pass \`--from ${MIGRATION_FLOOR}\`.`);
+    }
+    if (to < MIGRATION_TARGET_FLOOR) {
+        throw usage(`\`--to ${to}\` is below ${MIGRATION_TARGET_FLOOR}, the oldest major a migration targets.`, `Targets are ${MIGRATION_TARGET_FLOOR} to ${engine.major} with this engine.`);
+    }
+    if (to > engine.major) {
+        throw new CapabilityError('VERSION_NOT_SUPPORTED', `\`--to ${to}\` is beyond the migration engine's own major (${engine.label} migrates up to ${engine.major}).`, `Run \`adaptable cache add ${to}\` once a ${to} package exists, or pass \`--to ${engine.major}\`.`);
+    }
+    if (from >= to) {
+        throw usage(from === to ? `Nothing to migrate: \`--from\` and \`--to\` are both ${from}.` : `\`--from ${from}\` must be lower than \`--to ${to}\`.`, input.from === undefined
+            ? `The project's major (${from}) was taken as \`--from\`; pass \`--from <older major>\` for the version the State was written for.`
+            : 'Pass `--to <newer major>`, or omit it to target the engine\'s major.');
+    }
+    return { from, to };
+}
+function outPath(input) {
+    if (!input.out) {
+        return undefined;
+    }
+    const out = resolve(input.out);
+    if (input.file && input.file !== '-' && resolve(input.file) === out) {
+        throw usage(`\`--out\` names the input file (${basename(out)}); \`migrate state\` never overwrites its input.`, 'Write the migrated State to another file, or omit `--out` and read it from the output.');
+    }
+    return out;
+}
+export async function migrateState(input, deps) {
+    const warnings = [];
+    const kind = input.kind ?? 'initial';
+    const { extraction, sourceText } = readState(input);
+    if (!isObj(extraction.value)) {
+        const root = extraction.unverifiable.find((u) => u.path === '');
+        throw new CapabilityError('EXTRACTION_FAILED', root
+            ? `The State in ${basename(extraction.source.file)} is not visible statically: ${root.reason}.`
+            : `The State in ${basename(extraction.source.file)} is not an object.`, root
+            ? 'Export the State of the running grid with `getPersistentState()` (DevTools) and migrate that JSON, or declare the State as a literal.'
+            : 'Adaptable State is a JSON object whose keys are module names (`Layout`, `FormatColumn`, …).');
+    }
+    const out = outPath(input);
+    const engine = await resolveUpgradeEngine(deps);
+    const { from, to } = validateRange(input, deps, engine.info);
+    // sentinels in place of the extractor's null stubs, so moved values can be found again
+    const prepared = structuredClone(extraction.value);
+    const stubbed = extraction.unverifiable.filter(stubsValue);
+    stubbed.forEach((u, index) => {
+        if (getAt(prepared, u.path) === null) {
+            setAt(prepared, u.path, SENTINEL(index));
+        }
+    });
+    const log = [];
+    const logger = {
+        success: (message) => log.push({ level: 'success', message: String(message) }),
+        info: (message) => log.push({ level: 'info', message: String(message) }),
+        warn: (message) => log.push({ level: 'warn', message: String(message) }),
+        error: (message) => log.push({ level: 'error', message: String(message) }),
+    };
+    let output;
+    try {
+        output = engine.module.AdaptableUpgradeHelper.migrateAdaptableState(prepared, { fromVersion: from, toVersion: to, logger });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`The migration engine (${engine.info.label}) threw while migrating ${basename(extraction.source.file)} from ${from} to ${to}: ${message}`, { cause: error });
+    }
+    // re-attach: placeholders in the reported State, nulls (with remapped paths) for the check
+    const migrated = structuredClone(output);
+    const forCheck = structuredClone(output);
+    const sentinels = findSentinels(output);
+    const remapped = [];
+    const outcomes = extraction.unverifiable.map((u) => {
+        if (!stubsValue(u)) {
+            return { ...u, outcome: 'container' };
+        }
+        const index = stubbed.indexOf(u);
+        const hit = sentinels.get(index);
+        if (!hit) {
+            return { ...u, outcome: 'dropped' };
+        }
+        const placeholder = placeholderFor(u);
+        if (!hit.exact) {
+            // folded into a longer string (e.g. a predicate input inside the expression the engine built)
+            const replaceIn = (target) => {
+                const current = getAt(target, hit.path);
+                if (typeof current === 'string') {
+                    setAt(target, hit.path, current.replaceAll(SENTINEL(index), placeholder));
+                }
+            };
+            replaceIn(migrated);
+            replaceIn(forCheck);
+            return { ...u, outcome: 'embedded', migratedPath: hit.path, placeholder };
+        }
+        setAt(migrated, hit.path, placeholder);
+        setAt(forCheck, hit.path, null);
+        remapped.push({ ...u, path: hit.path });
+        return { ...u, outcome: 'reattached', migratedPath: hit.path, placeholder };
+    });
+    const dropped = outcomes.filter((o) => o.outcome === 'dropped');
+    if (dropped.length) {
+        warnings.push(`${dropped.length} value${dropped.length === 1 ? '' : 's'} that could not be read statically ${dropped.length === 1 ? 'was' : 'were'} removed by the migration and could not be re-attached: ${dropped.map((d) => `\`${d.path}\` (${d.kind}, ${basename(d.file)}:${d.line})`).join(', ')}. Carry ${dropped.length === 1 ? 'it' : 'them'} over by hand if ${dropped.length === 1 ? 'it is' : 'they are'} still meaningful in ${to}.`);
+    }
+    const embedded = outcomes.filter((o) => o.outcome === 'embedded');
+    if (embedded.length) {
+        warnings.push(`${embedded.length} value${embedded.length === 1 ? '' : 's'} that could not be read statically ${embedded.length === 1 ? 'was' : 'were'} folded into a string by the migration: ${embedded.map((e) => `\`${e.path}\` (${e.kind}, ${basename(e.file)}:${e.line}) → \`${e.migratedPath}\``).join(', ')}. Replace the placeholder inside that string with the value the code produces.`);
+    }
+    const changed = stableStringify(forCheck) !== stableStringify(extraction.value);
+    // the engine's log names values by content; a stub shows up as its sentinel
+    for (const line of log) {
+        stubbed.forEach((u, index) => {
+            line.message = line.message.replaceAll(SENTINEL(index), placeholderFor(u));
+        });
+        // a parser excerpt may cut a sentinel short
+        line.message = line.message.replace(/__adaptable_mcp_unve\w*/g, '<unverifiable>');
+    }
+    const isStubbed = (path) => remapped.some((u) => path === u.path || path.startsWith(`${u.path}.`) || path.startsWith(`${u.path}[`));
+    // the target major's types (plan §7.3), for the leftover walk; PACKAGE_REQUIRED propagates
+    const override = sourceOverride();
+    const resolvedTypes = override ? undefined : await resolvePackage({ kind: 'types', major: to }, deps);
+    const types = override ?? packageLocation(resolvedTypes);
+    const found = await findLeftovers({
+        migrated: forCheck,
+        input: extraction.value,
+        lineMap: extraction.lineMap,
+        types,
+        type: kind === 'persistent' ? 'AdaptablePersistentState' : 'InitialState',
+        to,
+        renames: deps.renames ?? bundledRenamesFor(to),
+    });
+    if (!found.ok) {
+        warnings.push(`Leftover properties were not checked against the ${to} types: ${found.reason}`);
+    }
+    // a leftover at a stubbed value is about the stub, not the user's code (same rule as the shape layer)
+    const leftovers = found.leftovers.filter((l) => !isStubbed(l.path));
+    // the post-migration check (plan §8.8): check state --major <to> on the migrated State
+    const options = extractQuietly(sourceText, input.file, 'options');
+    const check = await checkState({
+        state: forCheck,
+        file: extraction.source.file,
+        unverifiable: remapped,
+        kind,
+        columns: input.columns,
+        columnsValue: input.columnsValue ?? (input.columns ? undefined : sameFileColumns(sourceText, input.file)),
+        ...(options && isObj(options.value) ? { optionsValue: options.value } : {}),
+    }, { major: to, projectDir: deps.projectDir, offline: deps.offline, installed: deps.installed, renames: deps.renames ?? bundledRenamesFor(to) });
+    warnings.push(...check.warnings);
+    // a leftover supersedes the check's finding at the same path (the shape layer's unknown key, `state/unknown-section`)
+    const leftoverPaths = new Set(leftovers.map((l) => l.path));
+    const checkIssues = check.issues
+        .filter((issue) => issue.path === undefined || !leftoverPaths.has(issue.path))
+        .map((issue) => {
+        // positions refer to the input: the migrated value has none of its own
+        const entry = issue.path !== undefined && issue.file === undefined ? extraction.lineMap[issue.path] : undefined;
+        if (!entry) {
+            return issue;
+        }
+        const at = issue.code === 'shape/unknown-key' ? entry.key ?? entry.value : entry.value;
+        return { ...issue, file: at.file, line: at.line, column: at.column };
+    });
+    const issues = [...leftovers.map((l) => leftoverIssue(l, to)), ...checkIssues];
+    let wrote;
+    if (out) {
+        mkdirSync(dirname(out), { recursive: true });
+        writeFileSync(out, `${JSON.stringify(migrated, null, 2)}\n`);
+        wrote = out;
+    }
+    return {
+        data: {
+            from,
+            to,
+            source: { file: extraction.source.file, locatedBy: extraction.source.locatedBy, line: extraction.source.line, column: extraction.source.column },
+            engine: engine.info,
+            migrated,
+            changed,
+            log,
+            leftovers,
+            unverifiable: outcomes,
+            check: { checked: check.data.checked, rules: check.data.rules, stats: check.data.stats, requiresAnotherCheckAfterFix: check.data.requiresAnotherCheckAfterFix, issues: checkIssues.length },
+            ...(wrote ? { wrote } : {}),
+        },
+        issues,
+        warnings,
+        ...(resolvedTypes ? { codeSource: resolvedTypes.source } : {}),
+        ...(engine.resolved ? { engine: { version: engine.resolved.version, source: engine.resolved.source } } : {}),
+    };
+}
+/** The `columnDefs` of a source-file input, when it declares them, for the post-migration check */
+function sameFileColumns(sourceText, file) {
+    const columns = extractQuietly(sourceText, file, 'columnDefs');
+    return columns && Array.isArray(columns.value) ? columns.value : undefined;
+}
+//# sourceMappingURL=state.js.map

package/dist/core/migrate/state.js.map

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

package/dist/core/packages/cache.js

@@ -0,0 +1,139 @@
+/**
+ * The on-disk cache (plan §7.1): `~/.cache/adaptable-mcp/` — `$XDG_CACHE_HOME`
+ * honoured, `ADAPTABLE_MCP_CACHE_DIR` overrides — with
+ *   pkgs/@adaptabletools/adaptable@<version>/   extracted library packages (§7.3)
+ *   entries/<version>/<entry>.mjs               esbuild bundles of a package's entries
+ *   docs/<host>/<manifest hash>/                docs corpora (A1.1)
+ */
+import { existsSync, mkdirSync, readdirSync, rmSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { LIBRARY_PACKAGE } from '../constants.js';
+import { compareSemver } from './versions.js';
+export function getCacheRoot() {
+    return (process.env.ADAPTABLE_MCP_CACHE_DIR ||
+        join(process.env.XDG_CACHE_HOME || join(homedir(), '.cache'), 'adaptable-mcp'));
+}
+/** A cache folder, created on demand */
+export function getCacheDir(...segments) {
+    const dir = join(getCacheRoot(), ...segments);
+    mkdirSync(dir, { recursive: true });
+    return dir;
+}
+export const PKGS_DIR = 'pkgs';
+export const ENTRIES_DIR = 'entries';
+export const DOCS_DIR = 'docs';
+/** Folder a cached library version lives in (its `package.json` is directly inside) */
+export function packageCacheDir(version) {
+    return join(getCacheRoot(), PKGS_DIR, `${LIBRARY_PACKAGE}@${version}`);
+}
+export function entriesCacheDir(version) {
+    return join(getCacheRoot(), ENTRIES_DIR, version);
+}
+/** Cached library packages, oldest first */
+export function listCachedPackages() {
+    const scopeDir = join(getCacheRoot(), PKGS_DIR, LIBRARY_PACKAGE.split('/')[0]);
+    const prefix = `${LIBRARY_PACKAGE.split('/')[1]}@`;
+    let names;
+    try {
+        names = readdirSync(scopeDir);
+    }
+    catch {
+        return [];
+    }
+    return names
+        .filter((name) => name.startsWith(prefix) && existsSync(join(scopeDir, name, 'package.json')))
+        .map((name) => ({ version: name.slice(prefix.length), dir: join(scopeDir, name) }))
+        .sort((a, b) => compareSemver(a.version, b.version));
+}
+function folderSize(dir) {
+    let total = 0;
+    const walk = (path) => {
+        let entries;
+        try {
+            entries = readdirSync(path, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const full = join(path, entry.name);
+            if (entry.isDirectory()) {
+                walk(full);
+            }
+            else if (entry.isFile()) {
+                try {
+                    total += statSync(full).size;
+                }
+                catch {
+                    // removed meanwhile
+                }
+            }
+        }
+    };
+    walk(dir);
+    return total;
+}
+function ageDays(path) {
+    try {
+        // a folder written in the same tick can carry an mtime a fraction of a millisecond ahead of now
+        return Math.max(0, Math.floor((Date.now() - statSync(path).mtimeMs) / 86_400_000));
+    }
+    catch {
+        return undefined;
+    }
+}
+/** What `cache list` shows: packages, entry bundles and docs corpora with sizes and ages */
+export function summarizeCache() {
+    const root = getCacheRoot();
+    const packages = listCachedPackages().map(({ version, dir }) => ({
+        version,
+        bytes: folderSize(dir),
+        ageDays: ageDays(dir),
+    }));
+    const entriesRoot = join(root, ENTRIES_DIR);
+    const entries = (existsSync(entriesRoot) ? readdirSync(entriesRoot) : [])
+        .filter((version) => statSync(join(entriesRoot, version)).isDirectory())
+        .sort(compareSemver)
+        .map((version) => ({
+        version,
+        files: readdirSync(join(entriesRoot, version)).sort(),
+        bytes: folderSize(join(entriesRoot, version)),
+    }));
+    const docsRoot = join(root, DOCS_DIR);
+    const docs = [];
+    if (existsSync(docsRoot)) {
+        for (const host of readdirSync(docsRoot).sort()) {
+            const hostDir = join(docsRoot, host);
+            if (!statSync(hostDir).isDirectory()) {
+                continue;
+            }
+            for (const hash of readdirSync(hostDir).sort()) {
+                const dir = join(hostDir, hash);
+                if (statSync(dir).isDirectory()) {
+                    docs.push({ host, hash, bytes: folderSize(dir), ageDays: ageDays(dir) });
+                }
+            }
+        }
+    }
+    return { root, packages, entries, docs };
+}
+/** Removes docs corpora and/or packages (with their entry bundles); everything when neither flag is set */
+export function clearCache(options = {}) {
+    const all = !options.docs && !options.pkgs;
+    const root = getCacheRoot();
+    const removed = [];
+    const targets = [
+        ...(all || options.docs ? [DOCS_DIR] : []),
+        ...(all || options.pkgs ? [PKGS_DIR, ENTRIES_DIR] : []),
+    ];
+    for (const target of targets) {
+        const dir = join(root, target);
+        if (existsSync(dir)) {
+            rmSync(dir, { recursive: true, force: true });
+            removed.push(target);
+        }
+    }
+    return { removed };
+}
+//# sourceMappingURL=cache.js.map

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

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

package/dist/core/packages/capabilities.js

@@ -0,0 +1,95 @@
+/**
+ * `adaptable cache add <major|version|tag>` · `cache list` · `cache clear [--docs|--pkgs]` (plan §8.13).
+ * CLI only: an MCP client has no business filling a user's cache.
+ */
+import { z } from 'zod';
+import { registerCapability } from '../capabilities.js';
+import { LIBRARY_PACKAGE } from '../constants.js';
+import { CapabilityError, ok } from '../envelope.js';
+import { clearCache, listCachedPackages, summarizeCache } from './cache.js';
+import { npmRegistry } from './registry.js';
+import { pickVersion } from './resolve.js';
+/** Tests swap the registry; production uses npm */
+let registryFactory = (cwd) => npmRegistry({ cwd });
+export function setPackageRegistryFactory(factory) {
+    registryFactory = factory;
+}
+const formatBytes = (bytes) => bytes >= 1_048_576 ? `${(bytes / 1_048_576).toFixed(1)} MB` : `${Math.ceil(bytes / 1024)} kB`;
+registerCapability({
+    name: 'cache-add',
+    description: `Downloads a ${LIBRARY_PACKAGE} version into the cache so checks and migrations for that major work offline.`,
+    cli: { command: ['cache', 'add'], positionals: ['spec'] },
+    mcp: null,
+    input: z.object({
+        spec: z.string().describe('A major (23), an exact version (23.1.1) or a dist-tag (canary)'),
+    }),
+    output: z.object({
+        version: z.string(),
+        dir: z.string(),
+        status: z.enum(['downloaded', 'already-cached']),
+    }),
+    run: async (input, ctx) => {
+        if (ctx.globals.offline) {
+            throw new CapabilityError('NETWORK_REQUIRED', '`cache add` downloads from the npm registry and cannot run with --offline.', 'Drop --offline, or run the command on a connected machine and copy the cache folder.');
+        }
+        const registry = registryFactory(ctx.cwd);
+        const view = await registry.view();
+        const version = pickVersion(input.spec, view);
+        if (!version) {
+            throw new CapabilityError('VERSION_NOT_SUPPORTED', `The npm registry has no ${LIBRARY_PACKAGE} matching "${input.spec}".`, `Pass a published major (${[...new Set(view.versions.map((v) => v.split('.')[0]))].slice(-4).join(', ')}), an exact version or a dist-tag (${Object.keys(view.distTags).join(', ')}).`);
+        }
+        const cached = listCachedPackages().find((p) => p.version === version);
+        if (cached) {
+            return ok({ version, dir: cached.dir, status: 'already-cached' });
+        }
+        const dir = await registry.fetch(version);
+        return ok({ version, dir, status: 'downloaded' });
+    },
+    markdown: (data) => data.status === 'downloaded'
+        ? `Cached ${LIBRARY_PACKAGE}@${data.version} at \`${data.dir}\`.`
+        : `${LIBRARY_PACKAGE}@${data.version} was already cached at \`${data.dir}\`.`,
+});
+registerCapability({
+    name: 'cache-list',
+    description: 'Shows cached library packages, bundled entries and docs corpora with sizes and ages.',
+    cli: { command: ['cache', 'list'] },
+    mcp: null,
+    input: z.object({}),
+    output: z.object({
+        root: z.string(),
+        packages: z.array(z.object({ version: z.string(), bytes: z.number(), ageDays: z.number().optional() })),
+        entries: z.array(z.object({ version: z.string(), files: z.array(z.string()), bytes: z.number() })),
+        docs: z.array(z.object({ host: z.string(), hash: z.string(), bytes: z.number(), ageDays: z.number().optional() })),
+    }),
+    run: async () => ok(summarizeCache()),
+    markdown: (data) => {
+        const lines = [`Cache: \`${data.root}\``, ''];
+        lines.push(`## Packages (${data.packages.length})`, '');
+        for (const p of data.packages) {
+            lines.push(`- ${LIBRARY_PACKAGE}@${p.version} — ${formatBytes(p.bytes)}${p.ageDays !== undefined ? `, ${p.ageDays} d old` : ''}`);
+        }
+        lines.push('', `## Entry bundles (${data.entries.length})`, '');
+        for (const e of data.entries) {
+            lines.push(`- ${e.version}: ${e.files.join(', ')} — ${formatBytes(e.bytes)}`);
+        }
+        lines.push('', `## Docs corpora (${data.docs.length})`, '');
+        for (const d of data.docs) {
+            lines.push(`- ${d.host} (${d.hash}) — ${formatBytes(d.bytes)}${d.ageDays !== undefined ? `, ${d.ageDays} d old` : ''}`);
+        }
+        return lines.join('\n');
+    },
+});
+registerCapability({
+    name: 'cache-clear',
+    description: 'Removes cached docs corpora and/or library packages (with their entry bundles); everything when no flag is given.',
+    cli: { command: ['cache', 'clear'] },
+    mcp: null,
+    input: z.object({
+        docs: z.boolean().optional().describe('Remove docs corpora only'),
+        pkgs: z.boolean().optional().describe('Remove packages and entry bundles only'),
+    }),
+    output: z.object({ removed: z.array(z.string()) }),
+    run: async (input) => ok(clearCache(input)),
+    markdown: (data) => (data.removed.length ? `Removed: ${data.removed.join(', ')}.` : 'Nothing to remove.'),
+});
+//# sourceMappingURL=capabilities.js.map

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

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

package/dist/{adaptable/types.js → core/packages/entry-types.js}

@@ -10,4 +10,4 @@ export const EXPRESSION_MODULES = [
     'PlusMinus',
     'StyledColumn',
 ];
-//# sourceMappingURL=types.js.map
+//# sourceMappingURL=entry-types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entry-types.js","sourceRoot":"","sources":["../../../src/core/packages/entry-types.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,OAAO;IACP,kBAAkB;IAClB,cAAc;IACd,QAAQ;IACR,cAAc;IACd,cAAc;IACd,YAAY;IACZ,YAAY;IACZ,WAAW;IACX,cAAc;CACN,CAAC"}

package/dist/core/packages/exec.js

@@ -0,0 +1,37 @@
+import { spawn } from 'node:child_process';
+/** Runs a command and resolves with its stdout; rejects with stderr on a non-zero exit */
+export function exec(command, args, options = {}) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            cwd: options.cwd,
+            shell: process.platform === 'win32',
+            stdio: ['ignore', 'pipe', 'pipe'],
+            env: { ...process.env, NO_UPDATE_NOTIFIER: '1', npm_config_update_notifier: 'false' },
+        });
+        const out = [];
+        const err = [];
+        child.stdout.on('data', (chunk) => out.push(chunk));
+        child.stderr.on('data', (chunk) => err.push(chunk));
+        const timer = options.timeoutMs
+            ? setTimeout(() => {
+                child.kill();
+                reject(new Error(`${command} ${args.join(' ')} timed out after ${options.timeoutMs} ms`));
+            }, options.timeoutMs)
+            : undefined;
+        child.on('error', (error) => {
+            clearTimeout(timer);
+            reject(error);
+        });
+        child.on('close', (code) => {
+            clearTimeout(timer);
+            if (code === 0) {
+                resolve(Buffer.concat(out).toString('utf8'));
+            }
+            else {
+                reject(new Error(`${command} ${args.join(' ')} exited with ${code}: ${Buffer.concat(err).toString('utf8').trim()}`));
+            }
+        });
+    });
+}
+export const NPM = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+//# sourceMappingURL=exec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../../src/core/packages/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAO3C,0FAA0F;AAC1F,MAAM,UAAU,IAAI,CAAC,OAAe,EAAE,IAAc,EAAE,UAAuB,EAAE;IAC7E,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;YACjC,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,KAAK,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO;YACnC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;YACjC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,0BAA0B,EAAE,OAAO,EAAE;SACtF,CAAC,CAAC;QACH,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5D,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5D,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS;YAC7B,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE;gBACd,KAAK,CAAC,IAAI,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,oBAAoB,OAAO,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC;YAC5F,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC;YACvB,CAAC,CAAC,SAAS,CAAC;QACd,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC1B,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;YAC/C,CAAC;iBAAM,CAAC;gBACN,MAAM,CACJ,IAAI,KAAK,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,IAAI,KAAK,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAC7G,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC"}