@moxxy/config 0.27.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Moxxy (moxxy.ai)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/config-writer.d.ts

@@ -0,0 +1,30 @@
+import { type MoxxyConfig } from './schema.js';
+/**
+ * The ONE schema-validated, comment-preserving dot-path config writer. Both
+ * the model-facing `config_set` tool (plugin.ts) and UI surfaces (the TUI's
+ * /settings panel) write through here, sharing a single mutex, so concurrent
+ * writers can't interleave and no surface can persist a structurally-invalid
+ * config.
+ */
+export type ConfigScope = 'user' | 'project';
+/** Serializes every config write in this process (tool + UI surfaces). */
+export declare const configWriteMutex: import("@moxxy/sdk").Mutex;
+export declare function findScopePath(scope: ConfigScope, cwd: string): Promise<string | null>;
+export declare function scopeDefaultPath(scope: ConfigScope, cwd: string): string;
+export declare function parseDotPath(p: string): Array<string | number>;
+export interface SetConfigValueOptions {
+    readonly scope: ConfigScope;
+    readonly cwd: string;
+    /** Dot path into the config (e.g. `context.reasoning`, `tui.hints`). */
+    readonly path: string;
+    /** The ALREADY-PARSED value to set (callers own string→value parsing). */
+    readonly value: unknown;
+}
+export interface SetConfigValueResult {
+    /** The file that was written. */
+    readonly path: string;
+    /** The full validated config snapshot after the write. */
+    readonly config: MoxxyConfig;
+}
+export declare function setConfigValue(opts: SetConfigValueOptions): Promise<SetConfigValueResult>;
+//# sourceMappingURL=config-writer.d.ts.map

package/dist/config-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-writer.d.ts","sourceRoot":"","sources":["../src/config-writer.ts"],"names":[],"mappings":"AAKA,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAElE;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;AAQ7C,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,4BAAgB,CAAC;AAE9C,wBAAsB,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAW3F;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAE9D;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,iCAAiC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAyB/F"}

package/dist/config-writer.js

@@ -0,0 +1,57 @@
+import { promises as fs } from 'node:fs';
+import * as path from 'node:path';
+import { createMutex } from '@moxxy/sdk';
+import { moxxyPath, writeFileAtomic } from '@moxxy/sdk/server';
+import { findUpward } from './loader.js';
+import { moxxyConfigSchema } from './schema.js';
+const USER_YAML = () => moxxyPath('config.yaml');
+// YAML names only — the writer round-trips documents with `setIn`, which it
+// can't do for the .ts/.js configs loadConfig also honors.
+const PROJECT_YAML_NAMES = ['moxxy.config.yaml', 'moxxy.config.yml'];
+/** Serializes every config write in this process (tool + UI surfaces). */
+export const configWriteMutex = createMutex();
+export async function findScopePath(scope, cwd) {
+    if (scope === 'user') {
+        const yaml = USER_YAML();
+        try {
+            await fs.access(yaml);
+            return yaml;
+        }
+        catch {
+            return null;
+        }
+    }
+    return findUpward(cwd, PROJECT_YAML_NAMES);
+}
+export function scopeDefaultPath(scope, cwd) {
+    return scope === 'user' ? USER_YAML() : path.join(cwd, 'moxxy.config.yaml');
+}
+export function parseDotPath(p) {
+    return p.split('.').map((seg) => (/^\d+$/.test(seg) ? Number(seg) : seg));
+}
+export async function setConfigValue(opts) {
+    return configWriteMutex.run(async () => {
+        const target = (await findScopePath(opts.scope, opts.cwd)) ?? scopeDefaultPath(opts.scope, opts.cwd);
+        await fs.mkdir(path.dirname(target), { recursive: true });
+        const yamlMod = (await import('yaml'));
+        let text = '';
+        try {
+            text = await fs.readFile(target, 'utf8');
+        }
+        catch {
+            /* new file */
+        }
+        const doc = yamlMod.parseDocument(text);
+        doc.setIn(parseDotPath(opts.path), opts.value);
+        const candidate = String(doc);
+        const parsed = yamlMod.parse(candidate);
+        const validated = moxxyConfigSchema.safeParse(parsed ?? {});
+        if (!validated.success) {
+            throw new Error(`config write to '${opts.path}' would produce an invalid config:\n` +
+                JSON.stringify(validated.error.issues, null, 2));
+        }
+        await writeFileAtomic(target, candidate);
+        return { path: target, config: validated.data };
+    });
+}
+//# sourceMappingURL=config-writer.js.map

package/dist/config-writer.js.map

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

package/dist/define.d.ts

@@ -0,0 +1,17 @@
+import type { MoxxyConfig } from './schema.js';
+/**
+ * Typed configuration factory. Use in `moxxy.config.ts`:
+ *
+ *   import { defineConfig } from '@moxxy/config';
+ *
+ *   export default defineConfig({
+ *     provider: { name: 'anthropic', model: 'claude-sonnet-4-6' },
+ *     plugins: {
+ *       '@moxxy/plugin-mcp': { enabled: true, options: { servers: [...] } },
+ *       '@acme/moxxy-plugin-shell': { enabled: false },
+ *     },
+ *     watcher: 'auto',
+ *   });
+ */
+export declare function defineConfig(config: MoxxyConfig): MoxxyConfig;
+//# sourceMappingURL=define.d.ts.map

package/dist/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAE7D"}

package/dist/define.js

@@ -0,0 +1,18 @@
+/**
+ * Typed configuration factory. Use in `moxxy.config.ts`:
+ *
+ *   import { defineConfig } from '@moxxy/config';
+ *
+ *   export default defineConfig({
+ *     provider: { name: 'anthropic', model: 'claude-sonnet-4-6' },
+ *     plugins: {
+ *       '@moxxy/plugin-mcp': { enabled: true, options: { servers: [...] } },
+ *       '@acme/moxxy-plugin-shell': { enabled: false },
+ *     },
+ *     watcher: 'auto',
+ *   });
+ */
+export function defineConfig(config) {
+    return config;
+}
+//# sourceMappingURL=define.js.map

package/dist/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY,CAAC,MAAmB;IAC9C,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { defineConfig } from './define.js';
+export { loadConfig, type LoadConfigOptions, type LoadedConfig } from './loader.js';
+export { mergeConfigs } from './merge.js';
+export { buildConfigPlugin, type ConfigApplier, type ConfigApplyResult, } from './plugin.js';
+export { moxxyConfigSchema, pluginSettingsSchema, permissionsConfigSchema, embeddingsConfigSchema, securityConfigSchema, watcherModeSchema, type MoxxyConfig, type PluginSettings, type PermissionsConfig, type EmbeddingsConfig, type SecurityConfig, type WatcherMode, } from './schema.js';
+export { pluginsTreeSchema, providerSlotSchema, providerItemSchema, categorySlotSchema, PLUGIN_CATEGORY_KEYS, type PluginsTree, type ProviderSlot, type ProviderItem, type CategorySlot, type PluginCategoryKey, } from './plugins-tree-schema.js';
+export { applyInitConfig, clearPluginState, defaultUserConfigPath, isPluginDisabled, loadActiveModel, loadActiveProvider, loadDisabledPackageNames, loadDisabledProviders, loadProviderItems, removeProviderItem, setCategoryDefault, setPluginEnabled, setProviderEnabled, setProviderItemConfig, setProviderModel, type ProviderItemState, type InitConfigSelections, type UserConfigOptions, } from './user-config.js';
+export { configWriteMutex, setConfigValue, type ConfigScope, type SetConfigValueOptions, type SetConfigValueResult, } from './config-writer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EACL,iBAAiB,EACjB,KAAK,aAAa,EAClB,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,iBAAiB,GACvB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+export { defineConfig } from './define.js';
+export { loadConfig } from './loader.js';
+export { mergeConfigs } from './merge.js';
+export { buildConfigPlugin, } from './plugin.js';
+export { moxxyConfigSchema, pluginSettingsSchema, permissionsConfigSchema, embeddingsConfigSchema, securityConfigSchema, watcherModeSchema, } from './schema.js';
+export { pluginsTreeSchema, providerSlotSchema, providerItemSchema, categorySlotSchema, PLUGIN_CATEGORY_KEYS, } from './plugins-tree-schema.js';
+// Comment-preserving writers for ~/.moxxy/config.yaml — the single store that
+// replaced ~/.moxxy/preferences.json (runtime provider/mode/model/disabled).
+export { applyInitConfig, clearPluginState, defaultUserConfigPath, isPluginDisabled, loadActiveModel, loadActiveProvider, loadDisabledPackageNames, loadDisabledProviders, loadProviderItems, removeProviderItem, setCategoryDefault, setPluginEnabled, setProviderEnabled, setProviderItemConfig, setProviderModel, } from './user-config.js';
+export { configWriteMutex, setConfigValue, } from './config-writer.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAA6C,MAAM,aAAa,CAAC;AACpF,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EACL,iBAAiB,GAGlB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,GAOlB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,GAMrB,MAAM,0BAA0B,CAAC;AAClC,8EAA8E;AAC9E,6EAA6E;AAC7E,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,GAIjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,gBAAgB,EAChB,cAAc,GAIf,MAAM,oBAAoB,CAAC"}

package/dist/loader.d.ts

@@ -0,0 +1,28 @@
+import { type MoxxyConfig } from './schema.js';
+export interface LoadConfigOptions {
+    readonly cwd: string;
+    readonly explicitPath?: string;
+    readonly skipUser?: boolean;
+}
+export interface LoadedConfig {
+    readonly config: MoxxyConfig;
+    readonly sources: ReadonlyArray<{
+        scope: 'project' | 'user' | 'explicit';
+        path: string;
+    }>;
+}
+/** Cap upward filesystem traversal when searching for a project config.
+ *  Shared with the config plugin's scope-resolution walk so the bound can't
+ *  drift between load time (here) and edit time (plugin.ts). */
+export declare const MAX_CONFIG_SEARCH_DEPTH = 12;
+export declare function loadConfig(opts: LoadConfigOptions): Promise<LoadedConfig>;
+/**
+ * Walk upward from `startDir` (bounded by {@link MAX_CONFIG_SEARCH_DEPTH})
+ * returning the first directory that holds one of `names`. The `names` list is
+ * a deliberate parameter: `loadConfig` searches every config extension while the
+ * config plugin's editor searches only the YAML names it can safely mutate — so
+ * the shared traversal invariant lives here, the divergent name set stays with
+ * the caller. Returns the full path, or null if none found within the bound.
+ */
+export declare function findUpward(startDir: string, names: ReadonlyArray<string>): Promise<string | null>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAKA,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAElE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;QAAE,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3F;AAkBD;;gEAEgE;AAChE,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C,wBAAsB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CA4B/E;AAkID;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAC3B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAUxB"}

package/dist/loader.js

@@ -0,0 +1,210 @@
+import { promises as fs } from 'node:fs';
+import * as path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { moxxyHome } from '@moxxy/sdk/server';
+import { mergeConfigs } from './merge.js';
+import { moxxyConfigSchema } from './schema.js';
+const CONFIG_NAMES = [
+    'moxxy.config.yaml',
+    'moxxy.config.yml',
+    'moxxy.config.ts',
+    'moxxy.config.js',
+    'moxxy.config.mjs',
+    'moxxy.config.cjs',
+];
+const USER_CONFIG_NAMES = [
+    'config.yaml',
+    'config.yml',
+    'config.ts',
+    'config.js',
+    'config.mjs',
+    'config.cjs',
+];
+/** Cap upward filesystem traversal when searching for a project config.
+ *  Shared with the config plugin's scope-resolution walk so the bound can't
+ *  drift between load time (here) and edit time (plugin.ts). */
+export const MAX_CONFIG_SEARCH_DEPTH = 12;
+export async function loadConfig(opts) {
+    const sources = [];
+    const configs = [];
+    if (!opts.skipUser) {
+        const userPath = await findFile(moxxyHome(), USER_CONFIG_NAMES);
+        if (userPath) {
+            const cfg = await loadOne(userPath);
+            configs.push(cfg);
+            sources.push({ scope: 'user', path: userPath });
+        }
+    }
+    if (opts.explicitPath) {
+        const cfg = await loadOne(opts.explicitPath);
+        configs.push(cfg);
+        sources.push({ scope: 'explicit', path: opts.explicitPath });
+    }
+    else {
+        const projectPath = await findUpward(opts.cwd, CONFIG_NAMES);
+        if (projectPath) {
+            warnIfAncestorExecutableConfig(projectPath, opts.cwd);
+            const cfg = await loadOne(projectPath);
+            configs.push(cfg);
+            sources.push({ scope: 'project', path: projectPath });
+        }
+    }
+    return { config: mergeConfigs(...configs), sources };
+}
+const EXECUTABLE_CONFIG_EXTS = new Set(['.ts', '.tsx', '.js', '.mjs', '.cjs']);
+function isUnderDir(filePath, dir) {
+    const rel = path.relative(path.resolve(dir), path.resolve(filePath));
+    return rel === '' || (!rel.startsWith('..') && !path.isAbsolute(rel));
+}
+/**
+ * The project-config upward walk resolves and then EXECUTES the first matching
+ * config above cwd. An ancestor (e.g. a shared home/temp parent or an untrusted
+ * outer repo) can therefore plant a config whose code runs with full process
+ * privileges. We keep the documented upward-walk behavior but surface the exact
+ * absolute path on stderr before running an ancestor *executable* config, so the
+ * operator can see what is about to execute. Non-executable YAML and at/under-cwd
+ * configs are silent (no new trust boundary widened).
+ */
+function warnIfAncestorExecutableConfig(filePath, cwd) {
+    if (!EXECUTABLE_CONFIG_EXTS.has(path.extname(filePath)))
+        return;
+    if (isUnderDir(filePath, cwd))
+        return;
+    console.warn(`[moxxy] executing project config from an ancestor directory: ${path.resolve(filePath)}`);
+}
+async function loadOne(filePath) {
+    const ext = path.extname(filePath);
+    let raw;
+    if (ext === '.yaml' || ext === '.yml') {
+        const yamlText = await fs.readFile(filePath, 'utf8');
+        const yamlMod = (await import('yaml'));
+        raw = yamlMod.parse(yamlText);
+        if (raw === null || raw === undefined)
+            raw = {};
+    }
+    else {
+        let mod;
+        if (ext === '.ts' || ext === '.tsx') {
+            const jiti = await getJiti(path.dirname(filePath));
+            if (!jiti)
+                throw new Error(`Cannot load ${filePath}: jiti is required for .ts configs.`);
+            mod = jiti(filePath);
+        }
+        else {
+            mod = await importJsConfig(filePath);
+        }
+        raw = extractDefault(mod);
+        if (!raw) {
+            throw new Error(`Config file ${filePath} must default-export the result of defineConfig().`);
+        }
+    }
+    const parsed = moxxyConfigSchema.safeParse(raw);
+    if (!parsed.success) {
+        throw new Error(`Invalid moxxy config at ${filePath}:\n` + JSON.stringify(parsed.error.issues, null, 2));
+    }
+    return parsed.data;
+}
+// Key the cache by cwd: a jiti instance binds its module-resolution /
+// interopDefault base to the dir it was created with, so a single shared
+// instance would resolve a SECOND project's `.ts` config relative imports
+// against the FIRST project's dir. Long-lived hosts (desktop/runner) load
+// configs for multiple workspaces in one process, so each cwd needs its own.
+//
+// Each entry carries its own module-resolution + compiled-module store, so an
+// unbounded map would grow one jiti runtime per workspace dir forever. Cap it
+// with a small LRU (re-insert on hit, drop the oldest on overflow) so a
+// long-running host that opens many projects keeps only a bounded working set.
+const MAX_CACHED_JITI = 16;
+const cachedJiti = new Map();
+async function getJiti(cwd) {
+    const existing = cachedJiti.get(cwd);
+    if (existing) {
+        // Mark as most-recently-used.
+        cachedJiti.delete(cwd);
+        cachedJiti.set(cwd, existing);
+        return existing;
+    }
+    try {
+        const mod = await import('jiti');
+        const factory = mod.createJiti ??
+            mod.default;
+        if (!factory)
+            return null;
+        const instance = factory(cwd, { interopDefault: true });
+        cachedJiti.set(cwd, instance);
+        while (cachedJiti.size > MAX_CACHED_JITI) {
+            const oldest = cachedJiti.keys().next().value;
+            if (oldest === undefined)
+                break;
+            cachedJiti.delete(oldest);
+        }
+        return instance;
+    }
+    catch {
+        return null;
+    }
+}
+// The ESM module registry never evicts an entry once imported and offers no
+// eviction API: every DISTINCT specifier is retained for the process lifetime
+// along with its whole module graph. A naive `?v=${Date.now()}` cache-buster on
+// every load therefore leaks one module per reload in the exact long-lived
+// hosts (desktop/runner) this loader targets. Instead: import each JS config by
+// its plain file URL the FIRST time (one registry entry, GC-stable), and only
+// append a cache-buster when re-loading a path we've already imported — using a
+// monotonic counter so same-millisecond reloads are still guaranteed unique
+// (Date.now()'s 1ms resolution would otherwise return the stale cached module).
+const importedJsConfigs = new Set();
+let importReloadCounter = 0;
+async function importJsConfig(filePath) {
+    const base = pathToFileURL(filePath).href;
+    if (importedJsConfigs.has(base)) {
+        return import(`${base}?v=${Date.now()}-${++importReloadCounter}`);
+    }
+    importedJsConfigs.add(base);
+    return import(base);
+}
+function extractDefault(mod) {
+    if (!mod)
+        return undefined;
+    if (typeof mod !== 'object')
+        return undefined;
+    const m = mod;
+    if (m.default && typeof m.default === 'object')
+        return m.default;
+    return undefined;
+}
+/**
+ * Walk upward from `startDir` (bounded by {@link MAX_CONFIG_SEARCH_DEPTH})
+ * returning the first directory that holds one of `names`. The `names` list is
+ * a deliberate parameter: `loadConfig` searches every config extension while the
+ * config plugin's editor searches only the YAML names it can safely mutate — so
+ * the shared traversal invariant lives here, the divergent name set stays with
+ * the caller. Returns the full path, or null if none found within the bound.
+ */
+export async function findUpward(startDir, names) {
+    let cursor = path.resolve(startDir);
+    for (let i = 0; i < MAX_CONFIG_SEARCH_DEPTH; i++) {
+        const found = await findFile(cursor, names);
+        if (found)
+            return found;
+        const parent = path.dirname(cursor);
+        if (parent === cursor)
+            break;
+        cursor = parent;
+    }
+    return null;
+}
+async function findFile(dir, names) {
+    for (const name of names) {
+        const candidate = path.join(dir, name);
+        try {
+            await fs.access(candidate);
+            return candidate;
+        }
+        catch {
+            // continue
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

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

package/dist/merge.d.ts

@@ -0,0 +1,9 @@
+import type { MoxxyConfig } from './schema.js';
+/**
+ * Deep-merge any number of configs in order. Later wins on scalars; arrays are concatenated;
+ * objects are merged key-by-key.
+ *
+ * Precedence (highest → lowest): CLI flags → project config → user config → defaults.
+ */
+export declare function mergeConfigs(...configs: ReadonlyArray<MoxxyConfig | undefined>): MoxxyConfig;
+//# sourceMappingURL=merge.d.ts.map

package/dist/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../src/merge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,OAAO,EAAE,aAAa,CAAC,WAAW,GAAG,SAAS,CAAC,GAAG,WAAW,CAO5F"}

package/dist/merge.js

@@ -0,0 +1,45 @@
+/**
+ * Deep-merge any number of configs in order. Later wins on scalars; arrays are concatenated;
+ * objects are merged key-by-key.
+ *
+ * Precedence (highest → lowest): CLI flags → project config → user config → defaults.
+ */
+export function mergeConfigs(...configs) {
+    const out = {};
+    for (const cfg of configs) {
+        if (!cfg)
+            continue;
+        mergeInto(out, cfg);
+    }
+    return out;
+}
+// Keys that, when assigned via `target[key] = ...`, hit a prototype setter
+// instead of creating an own data property — silently dropping the data AND
+// replacing the merged object's prototype. A parsed config (JSON default-export
+// or some YAML inputs) can carry an own enumerable `__proto__`/`constructor`/
+// `prototype` key, so skip them defensively. Legitimate configs never use them.
+const FORBIDDEN_MERGE_KEYS = new Set(['__proto__', 'constructor', 'prototype']);
+function mergeInto(target, source) {
+    for (const [key, value] of Object.entries(source)) {
+        if (value === undefined)
+            continue;
+        if (FORBIDDEN_MERGE_KEYS.has(key))
+            continue;
+        const existing = target[key];
+        if (Array.isArray(value)) {
+            target[key] = Array.isArray(existing) ? [...existing, ...value] : [...value];
+        }
+        else if (isPlainObject(value)) {
+            const base = isPlainObject(existing) ? { ...existing } : {};
+            mergeInto(base, value);
+            target[key] = base;
+        }
+        else {
+            target[key] = value;
+        }
+    }
+}
+function isPlainObject(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+//# sourceMappingURL=merge.js.map

package/dist/merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../src/merge.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,GAAG,OAA+C;IAC7E,MAAM,GAAG,GAAgB,EAAE,CAAC;IAC5B,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,2EAA2E;AAC3E,4EAA4E;AAC5E,gFAAgF;AAChF,8EAA8E;AAC9E,gFAAgF;AAChF,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC;AAEhF,SAAS,SAAS,CAAC,MAA+B,EAAE,MAA+B;IACjF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,IAAI,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5C,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;QAC/E,CAAC;aAAM,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5D,SAAS,CAAC,IAAI,EAAE,KAAgC,CAAC,CAAC;YAClD,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,CAAU;IAC/B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC"}

package/dist/plugin-settings-schema.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+/** Per-package settings in the `plugins.packages` install/enable ledger. */
+export declare const pluginSettingsSchema: z.ZodObject<{
+    /** Plug/unplug the whole package (all its contributions). Default true. */
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    /** Package-specific options passed to the plugin. */
+    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    /**
+     * Optional per-contribution exclusions, e.g. `["tool:foo"]`, to suppress a
+     * single contribution of an otherwise-enabled package. Honored at
+     * registration time. Kept optional so the common case stays one line.
+     */
+    exclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    enabled?: boolean | undefined;
+    options?: Record<string, unknown> | undefined;
+    exclude?: string[] | undefined;
+}, {
+    enabled?: boolean | undefined;
+    options?: Record<string, unknown> | undefined;
+    exclude?: string[] | undefined;
+}>;
+export type PluginSettings = z.infer<typeof pluginSettingsSchema>;
+//# sourceMappingURL=plugin-settings-schema.d.ts.map

package/dist/plugin-settings-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-settings-schema.d.ts","sourceRoot":"","sources":["../src/plugin-settings-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB;IAE7B,2EAA2E;;IAE3E,qDAAqD;;IAErD;;;;OAIG;;;;;;;;;;EAGI,CAAC;AACZ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/plugin-settings-schema.js

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+/** Per-package settings in the `plugins.packages` install/enable ledger. */
+export const pluginSettingsSchema = z
+    .object({
+    /** Plug/unplug the whole package (all its contributions). Default true. */
+    enabled: z.boolean().optional(),
+    /** Package-specific options passed to the plugin. */
+    options: z.record(z.string(), z.unknown()).optional(),
+    /**
+     * Optional per-contribution exclusions, e.g. `["tool:foo"]`, to suppress a
+     * single contribution of an otherwise-enabled package. Honored at
+     * registration time. Kept optional so the common case stays one line.
+     */
+    exclude: z.array(z.string()).optional(),
+})
+    .strict();
+//# sourceMappingURL=plugin-settings-schema.js.map

package/dist/plugin-settings-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-settings-schema.js","sourceRoot":"","sources":["../src/plugin-settings-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,4EAA4E;AAC5E,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KAClC,MAAM,CAAC;IACN,2EAA2E;IAC3E,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC/B,qDAAqD;IACrD,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IACrD;;;;OAIG;IACH,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACxC,CAAC;KACD,MAAM,EAAE,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,21 @@
+import { type Plugin } from '@moxxy/sdk';
+import { type MoxxyConfig } from './schema.js';
+/**
+ * Optional callback that the CLI (or any session host) can provide to apply
+ * config changes to a live session without a restart. The applier receives the
+ * full validated config snapshot AFTER the write; it should diff against its
+ * own cached state and update the parts it can apply safely.
+ *
+ * Return a list of changed paths that were reflected at runtime, plus any
+ * that need a session restart to take effect.
+ */
+export interface ConfigApplyResult {
+    readonly applied: ReadonlyArray<string>;
+    readonly pending: ReadonlyArray<string>;
+}
+export type ConfigApplier = (snapshot: MoxxyConfig) => Promise<ConfigApplyResult>;
+export declare function buildConfigPlugin(opts?: {
+    cwd: string;
+    applier?: ConfigApplier;
+}): Plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAEA,OAAO,EAA4C,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAGnF,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAGlE;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACzC;AACD,MAAM,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,WAAW,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;AA6FlF,wBAAgB,iBAAiB,CAC/B,IAAI,GAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,aAAa,CAAA;CAA2B,GACtE,MAAM,CAmPR"}