@moxxy/core 0.3.0

package/dist/plugins/package-requirements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-requirements.js","sourceRoot":"","sources":["../../src/plugins/package-requirements.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAyB,MAAM,YAAY,CAAC;AAEvE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,WAAmB,EACnB,OAAe;IAEf,MAAM,WAAW,GAAG,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC7D,IAAI,CAAC,WAAW;QAAE,OAAO,EAAE,CAAC;IAC5B,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,UAAmB,CAAC;IACxB,IAAI,CAAC;QACH,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,UAAU,GAAI,UAAkC,CAAC,KAAK,CAAC;IAC7D,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAC/B,OAAO,MAAM,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC;AACxC,CAAC;AAED,SAAS,kBAAkB,CAAC,WAAmB,EAAE,OAAe;IAC9D,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;IAClE,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,OAAO,CAAC,GAAG,WAAW,eAAe,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/plugins/registry-kinds.d.ts

@@ -0,0 +1,58 @@
+import type { Plugin } from '@moxxy/sdk';
+import type { PluginHostOptions } from './host-options.js';
+/**
+ * The per-registry record of the names a loaded plugin contributed. Keyed by
+ * the {@link LoadedRecord} field each kind writes to. PluginHost stores one
+ * `LoadedRecord` per loaded plugin so `unload` knows exactly which names to
+ * unregister from each registry.
+ */
+export interface RegistryNameRecord {
+    readonly toolNames: ReadonlyArray<string>;
+    readonly providerNames: ReadonlyArray<string>;
+    readonly modeNames: ReadonlyArray<string>;
+    readonly compactorNames: ReadonlyArray<string>;
+    readonly cacheStrategyNames: ReadonlyArray<string>;
+    readonly viewRendererNames: ReadonlyArray<string>;
+    readonly tunnelProviderNames: ReadonlyArray<string>;
+    readonly channelNames: ReadonlyArray<string>;
+    readonly surfaceNames: ReadonlyArray<string>;
+    readonly agentNames: ReadonlyArray<string>;
+    readonly commandNames: ReadonlyArray<string>;
+    readonly transcriberNames: ReadonlyArray<string>;
+    readonly synthesizerNames: ReadonlyArray<string>;
+    readonly embedderNames: ReadonlyArray<string>;
+    readonly isolatorNames: ReadonlyArray<string>;
+    readonly workflowExecutorNames: ReadonlyArray<string>;
+}
+/**
+ * A single contribution kind, mapping a plugin field + registry to the
+ * register / unregister / name-extraction operations PluginHost performs for
+ * it. Driving register and unregister from this one table keeps the two sides
+ * in lockstep — adding a registry kind is one entry, not edits to two parallel
+ * 16-line lists.
+ *
+ * `TDef` is the contribution def type for this kind. The table is declared with
+ * heterogeneous defs, so it is widened to `RegistryKind<any>` for iteration;
+ * each entry's closures stay individually type-checked against their own def.
+ */
+export interface RegistryKind<TDef> {
+    /** Stable identifier for the kind (used by tests/diagnostics). */
+    readonly kind: string;
+    /** {@link RegistryNameRecord} field this kind writes its names to. */
+    readonly recordField: keyof RegistryNameRecord;
+    /** The defs this plugin contributes for this kind. */
+    readonly defs: (plugin: Plugin) => ReadonlyArray<TDef>;
+    /** Extract the registry key from a def (mostly `.name`; surfaces use `.kind`). */
+    readonly nameOf: (def: TDef) => string;
+    /** Register a single def into its registry (uses `register` or `replace`). */
+    readonly register: (opts: PluginHostOptions, def: TDef) => void;
+    /** Remove a previously-registered name from its registry. */
+    readonly unregister: (opts: PluginHostOptions, name: string) => void;
+}
+/**
+ * The authoritative ordered list of contribution kinds. The ORDER here is the
+ * exact register order `applyPlugin` used and the exact unregister order
+ * `unload` used; preserve it when editing.
+ */
+export declare const REGISTRY_KINDS: ReadonlyArray<RegistryKind<unknown>>;
+//# sourceMappingURL=registry-kinds.d.ts.map

package/dist/plugins/registry-kinds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-kinds.d.ts","sourceRoot":"","sources":["../../src/plugins/registry-kinds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAOV,MAAM,EAWP,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,cAAc,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC/C,QAAQ,CAAC,kBAAkB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACnD,QAAQ,CAAC,iBAAiB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAClD,QAAQ,CAAC,mBAAmB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACpD,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7C,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7C,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC3C,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,qBAAqB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACvD;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,YAAY,CAAC,IAAI;IAChC,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,QAAQ,CAAC,WAAW,EAAE,MAAM,kBAAkB,CAAC;IAC/C,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,aAAa,CAAC,IAAI,CAAC,CAAC;IACvD,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,IAAI,KAAK,MAAM,CAAC;IACvC,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,iBAAiB,EAAE,GAAG,EAAE,IAAI,KAAK,IAAI,CAAC;IAChE,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACtE;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,aAAa,CAAC,YAAY,CAAC,OAAO,CAAC,CAoIvB,CAAC"}

package/dist/plugins/registry-kinds.js

@@ -0,0 +1,139 @@
+/**
+ * The authoritative ordered list of contribution kinds. The ORDER here is the
+ * exact register order `applyPlugin` used and the exact unregister order
+ * `unload` used; preserve it when editing.
+ */
+export const REGISTRY_KINDS = [
+    {
+        kind: 'tool',
+        recordField: 'toolNames',
+        defs: (p) => p.tools ?? [],
+        nameOf: (t) => t.name,
+        register: (o, t) => o.tools.register(t),
+        unregister: (o, n) => o.tools.unregister(n),
+    },
+    {
+        kind: 'provider',
+        recordField: 'providerNames',
+        defs: (p) => p.providers ?? [],
+        nameOf: (d) => d.name,
+        register: (o, d) => o.providers.register(d),
+        unregister: (o, n) => o.providers.unregister(n),
+    },
+    {
+        kind: 'mode',
+        recordField: 'modeNames',
+        defs: (p) => p.modes ?? [],
+        nameOf: (m) => m.name,
+        register: (o, m) => o.modes.register(m),
+        unregister: (o, n) => o.modes.unregister(n),
+    },
+    {
+        kind: 'compactor',
+        recordField: 'compactorNames',
+        defs: (p) => p.compactors ?? [],
+        nameOf: (c) => c.name,
+        register: (o, c) => o.compactors.register(c),
+        unregister: (o, n) => o.compactors.unregister(n),
+    },
+    {
+        kind: 'cacheStrategy',
+        recordField: 'cacheStrategyNames',
+        defs: (p) => p.cacheStrategies ?? [],
+        nameOf: (c) => c.name,
+        register: (o, c) => o.cacheStrategies.register(c),
+        unregister: (o, n) => o.cacheStrategies.unregister(n),
+    },
+    {
+        kind: 'viewRenderer',
+        recordField: 'viewRendererNames',
+        defs: (p) => p.viewRenderers ?? [],
+        nameOf: (v) => v.name,
+        // viewRenderers use `replace` (override-allowed) on the register side.
+        register: (o, v) => o.viewRenderers.replace(v),
+        unregister: (o, n) => o.viewRenderers.unregister(n),
+    },
+    {
+        kind: 'tunnelProvider',
+        recordField: 'tunnelProviderNames',
+        defs: (p) => p.tunnelProviders ?? [],
+        nameOf: (t) => t.name,
+        // tunnelProviders use `replace` (override-allowed) on the register side.
+        register: (o, t) => o.tunnelProviders.replace(t),
+        unregister: (o, n) => o.tunnelProviders.unregister(n),
+    },
+    {
+        kind: 'channel',
+        recordField: 'channelNames',
+        defs: (p) => p.channels ?? [],
+        nameOf: (c) => c.name,
+        register: (o, c) => o.channels.register(c),
+        unregister: (o, n) => o.channels.unregister(n),
+    },
+    {
+        kind: 'surface',
+        recordField: 'surfaceNames',
+        defs: (p) => p.surfaces ?? [],
+        // surfaces are keyed by `.kind`, not `.name`.
+        nameOf: (s) => s.kind,
+        register: (o, s) => o.surfaces.register(s),
+        unregister: (o, n) => o.surfaces.unregister(n),
+    },
+    {
+        kind: 'agent',
+        recordField: 'agentNames',
+        defs: (p) => p.agents ?? [],
+        nameOf: (a) => a.name,
+        register: (o, a) => o.agents.register(a),
+        unregister: (o, n) => o.agents.unregister(n),
+    },
+    {
+        kind: 'command',
+        recordField: 'commandNames',
+        defs: (p) => p.commands ?? [],
+        nameOf: (c) => c.name,
+        register: (o, c) => o.commands.register(c),
+        unregister: (o, n) => o.commands.unregister(n),
+    },
+    {
+        kind: 'transcriber',
+        recordField: 'transcriberNames',
+        defs: (p) => p.transcribers ?? [],
+        nameOf: (t) => t.name,
+        register: (o, t) => o.transcribers.register(t),
+        unregister: (o, n) => o.transcribers.unregister(n),
+    },
+    {
+        kind: 'synthesizer',
+        recordField: 'synthesizerNames',
+        defs: (p) => p.synthesizers ?? [],
+        nameOf: (s) => s.name,
+        register: (o, s) => o.synthesizers.register(s),
+        unregister: (o, n) => o.synthesizers.unregister(n),
+    },
+    {
+        kind: 'embedder',
+        recordField: 'embedderNames',
+        defs: (p) => p.embedders ?? [],
+        nameOf: (e) => e.name,
+        register: (o, e) => o.embedders.register(e),
+        unregister: (o, n) => o.embedders.unregister(n),
+    },
+    {
+        kind: 'isolator',
+        recordField: 'isolatorNames',
+        defs: (p) => p.isolators ?? [],
+        nameOf: (i) => i.name,
+        register: (o, i) => o.isolators.register(i),
+        unregister: (o, n) => o.isolators.unregister(n),
+    },
+    {
+        kind: 'workflowExecutor',
+        recordField: 'workflowExecutorNames',
+        defs: (p) => p.workflowExecutors ?? [],
+        nameOf: (w) => w.name,
+        register: (o, w) => o.workflowExecutors.register(w),
+        unregister: (o, n) => o.workflowExecutors.unregister(n),
+    },
+];
+//# sourceMappingURL=registry-kinds.js.map

package/dist/plugins/registry-kinds.js.map

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

package/dist/plugins/toposort.d.ts

@@ -0,0 +1,24 @@
+import type { ResolvedPluginManifest } from '@moxxy/sdk';
+/**
+ * Topological sort of discovered plugin manifests by their static
+ * `requirements` (from `package.json#moxxy.requirements`). Only
+ * `kind: 'plugin'` requirements participate; everything else (runtime,
+ * provider-state, etc.) is irrelevant to load order.
+ *
+ * Behavior:
+ * - A manifest whose required plugin name doesn't appear in `manifests`
+ *   is left in place — the readiness check in PluginHost will reject it
+ *   later. Toposort doesn't pre-judge.
+ * - Optional requirements (`optional: true`) are treated as soft edges:
+ *   if the target is present we order around it; if not, we skip the
+ *   edge silently.
+ * - Cycles throw `PluginCycleError` with the participating plugin names
+ *   so the caller can surface a useful diagnostic instead of silently
+ *   loading in an arbitrary order.
+ */
+export declare class PluginCycleError extends Error {
+    readonly cycle: ReadonlyArray<string>;
+    constructor(cycle: ReadonlyArray<string>);
+}
+export declare function toposortPluginManifests(manifests: ReadonlyArray<ResolvedPluginManifest>): ReadonlyArray<ResolvedPluginManifest>;
+//# sourceMappingURL=toposort.d.ts.map

package/dist/plugins/toposort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toposort.d.ts","sourceRoot":"","sources":["../../src/plugins/toposort.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAE3E;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IAC7B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC;gBAA5B,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC;CAIlD;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,aAAa,CAAC,sBAAsB,CAAC,GAC/C,aAAa,CAAC,sBAAsB,CAAC,CA6BvC"}

package/dist/plugins/toposort.js

@@ -0,0 +1,67 @@
+/**
+ * Topological sort of discovered plugin manifests by their static
+ * `requirements` (from `package.json#moxxy.requirements`). Only
+ * `kind: 'plugin'` requirements participate; everything else (runtime,
+ * provider-state, etc.) is irrelevant to load order.
+ *
+ * Behavior:
+ * - A manifest whose required plugin name doesn't appear in `manifests`
+ *   is left in place — the readiness check in PluginHost will reject it
+ *   later. Toposort doesn't pre-judge.
+ * - Optional requirements (`optional: true`) are treated as soft edges:
+ *   if the target is present we order around it; if not, we skip the
+ *   edge silently.
+ * - Cycles throw `PluginCycleError` with the participating plugin names
+ *   so the caller can surface a useful diagnostic instead of silently
+ *   loading in an arbitrary order.
+ */
+export class PluginCycleError extends Error {
+    cycle;
+    constructor(cycle) {
+        super(`Plugin requirement cycle detected: ${cycle.join(' -> ')}`);
+        this.cycle = cycle;
+        this.name = 'PluginCycleError';
+    }
+}
+export function toposortPluginManifests(manifests) {
+    const byPackage = new Map();
+    for (const m of manifests)
+        byPackage.set(m.packageName, m);
+    const order = [];
+    const visited = new Set();
+    const onStack = new Set();
+    const stack = [];
+    const visit = (name) => {
+        if (visited.has(name))
+            return;
+        if (onStack.has(name)) {
+            const startIdx = stack.indexOf(name);
+            throw new PluginCycleError(stack.slice(startIdx).concat(name));
+        }
+        const manifest = byPackage.get(name);
+        if (!manifest)
+            return; // unknown dep — leave for readiness gate
+        onStack.add(name);
+        stack.push(name);
+        for (const dep of pluginDeps(manifest.requirements))
+            visit(dep);
+        onStack.delete(name);
+        stack.pop();
+        visited.add(name);
+        order.push(manifest);
+    };
+    for (const m of manifests)
+        visit(m.packageName);
+    return order;
+}
+function pluginDeps(requirements) {
+    if (!requirements)
+        return [];
+    const out = [];
+    for (const req of requirements) {
+        if (req.kind === 'plugin')
+            out.push(req.name);
+    }
+    return out;
+}
+//# sourceMappingURL=toposort.js.map

package/dist/plugins/toposort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toposort.js","sourceRoot":"","sources":["../../src/plugins/toposort.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACpB;IAArB,YAAqB,KAA4B;QAC/C,KAAK,CAAC,sCAAsC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAD/C,UAAK,GAAL,KAAK,CAAuB;QAE/C,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,MAAM,UAAU,uBAAuB,CACrC,SAAgD;IAEhD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkC,CAAC;IAC5D,KAAK,MAAM,CAAC,IAAI,SAAS;QAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAE3D,MAAM,KAAK,GAA6B,EAAE,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,MAAM,KAAK,GAAG,CAAC,IAAY,EAAQ,EAAE;QACnC,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO;QAC9B,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACrC,MAAM,IAAI,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACjE,CAAC;QACD,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,QAAQ;YAAE,OAAO,CAAC,yCAAyC;QAEhE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,KAAK,MAAM,GAAG,IAAI,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QAChE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACrB,KAAK,CAAC,GAAG,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,SAAS;QAAE,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IAChD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,UAAU,CACjB,YAAyD;IAEzD,IAAI,CAAC,YAAY;QAAE,OAAO,EAAE,CAAC;IAC7B,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ;YAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/preferences.d.ts

@@ -0,0 +1,40 @@
+/**
+ * User-level runtime preferences persisted at ~/.moxxy/preferences.json.
+ * Distinct from `~/.moxxy/config.yaml` (user-edited, source of truth for
+ * provider/plugin wiring) — this file is mutated by the TUI as the user
+ * picks a model / loop strategy via slash commands, so it survives across
+ * CLI invocations. A missing file or unreadable contents is a no-op:
+ * preferences are best-effort, never load-blocking.
+ */
+export interface MoxxyPreferences {
+    /** Active provider name (e.g. "openai", "anthropic"). */
+    readonly providerName?: string;
+    /** Active model id under that provider (e.g. "gpt-5.4-mini"). */
+    readonly model?: string;
+    /** Active loop strategy name (e.g. "default", "research", "goal"). */
+    readonly mode?: string;
+    /**
+     * Providers the user disabled (desktop Settings → Providers toggle).
+     * Seeded into the ProviderRegistry at boot; a listed provider stays
+     * registered but can't be activated until re-enabled.
+     */
+    readonly disabledProviders?: ReadonlyArray<string>;
+}
+export declare function preferencesPath(): string;
+/**
+ * Read preferences from disk. Returns an empty object when the file
+ * doesn't exist or fails to parse — preferences are an optional layer,
+ * never a hard dependency of session bootstrap.
+ */
+export declare function loadPreferences(): Promise<MoxxyPreferences>;
+/**
+ * Merge-and-write preferences. Reads the current file (if any), merges
+ * the patch on top so we don't blow away unrelated fields, and writes
+ * the result back atomically. The whole read-merge-write runs inside a
+ * module-level mutex so overlapping saves serialize (invariant #5) and
+ * never lose an update. Best-effort: a write failure logs to stderr but
+ * does not throw — the user's pick still takes effect in this session,
+ * just won't persist across invocations.
+ */
+export declare function savePreferences(patch: Partial<MoxxyPreferences>): Promise<void>;
+//# sourceMappingURL=preferences.d.ts.map

package/dist/preferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.d.ts","sourceRoot":"","sources":["../src/preferences.ts"],"names":[],"mappings":"AAMA;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,iEAAiE;IACjE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACpD;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;;;GAIG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAYjE;AAUD;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAcrF"}

package/dist/preferences.js

@@ -0,0 +1,58 @@
+import { promises as fs } from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { createMutex, migrateModeName } from '@moxxy/sdk';
+import { writeFileAtomic } from '@moxxy/sdk/server';
+export function preferencesPath() {
+    return path.join(os.homedir(), '.moxxy', 'preferences.json');
+}
+/**
+ * Read preferences from disk. Returns an empty object when the file
+ * doesn't exist or fails to parse — preferences are an optional layer,
+ * never a hard dependency of session bootstrap.
+ */
+export async function loadPreferences() {
+    try {
+        const raw = await fs.readFile(preferencesPath(), 'utf8');
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === 'object') {
+            const prefs = parsed;
+            return prefs.mode ? { ...prefs, mode: migrateModeName(prefs.mode) } : prefs;
+        }
+        return {};
+    }
+    catch {
+        return {};
+    }
+}
+// Serializes the read-modify-write in `savePreferences` so two concurrent
+// saves (e.g. a /model pick and a provider-disable toggle firing close
+// together) can't both read the same snapshot and have the second write
+// clobber the first's field. This is the single write path for the file —
+// other packages (CLI, runner, channels) route their fire-and-forget saves
+// through it, and any load-modify-save must go through it too.
+const writeMutex = createMutex();
+/**
+ * Merge-and-write preferences. Reads the current file (if any), merges
+ * the patch on top so we don't blow away unrelated fields, and writes
+ * the result back atomically. The whole read-merge-write runs inside a
+ * module-level mutex so overlapping saves serialize (invariant #5) and
+ * never lose an update. Best-effort: a write failure logs to stderr but
+ * does not throw — the user's pick still takes effect in this session,
+ * just won't persist across invocations.
+ */
+export async function savePreferences(patch) {
+    return writeMutex.run(async () => {
+        const current = await loadPreferences();
+        const next = { ...current, ...patch };
+        const target = preferencesPath();
+        try {
+            await writeFileAtomic(target, JSON.stringify(next, null, 2) + '\n');
+        }
+        catch (err) {
+            process.stderr.write(`moxxy: failed to persist preferences to ${target}: ` +
+                `${err instanceof Error ? err.message : String(err)}\n`);
+        }
+    });
+}
+//# sourceMappingURL=preferences.js.map

package/dist/preferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.js","sourceRoot":"","sources":["../src/preferences.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAyBpD,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAC;AAC/D,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,EAAE,EAAE,MAAM,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;QAC1C,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,MAA0B,CAAC;YACzC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QAC9E,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,0EAA0E;AAC1E,uEAAuE;AACvE,wEAAwE;AACxE,0EAA0E;AAC1E,2EAA2E;AAC3E,+DAA+D;AAC/D,MAAM,UAAU,GAAG,WAAW,EAAE,CAAC;AAEjC;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAAgC;IACpE,OAAO,UAAU,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;QAC/B,MAAM,OAAO,GAAG,MAAM,eAAe,EAAE,CAAC;QACxC,MAAM,IAAI,GAAqB,EAAE,GAAG,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC;QACxD,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,MAAM,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QACtE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,2CAA2C,MAAM,IAAI;gBACnD,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAC1D,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/registries/active-backend-registry.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Shared base for the "single active backend" registries (speech-to-text,
+ * text-to-speech, embeddings). Each one is a Map of named defs with at most one
+ * *active* at a time:
+ *   - plugins call `register(def)` at load time
+ *   - the host / CLI / agent calls `setActive(name, config)` to pick one
+ *   - call sites read `getActive()` / `tryGetActive()` to use it (degrading
+ *     gracefully when none is active)
+ *
+ * The three concrete registries differ only along a few axes, expressed via
+ * {@link BackendRegistryOptions}:
+ *   - how a def becomes an instance (`build`) — `createClient(config)` for
+ *     STT/embeddings, `create({ config, getSecret })` for TTS
+ *   - whether the first registered def auto-becomes active (`autoAdoptFirst`,
+ *     TTS only — STT/embeddings require an explicit `setActive`)
+ *   - whether the active instance is (re)built lazily on read (`buildOnRead`,
+ *     TTS only — needed because `autoAdoptFirst` can set `active` without ever
+ *     building an instance; it also makes `setActive` rebuild when handed a
+ *     fresh config)
+ *
+ * `ProviderRegistry` deliberately stays separate: it is the core LLM path and
+ * carries its own ready-state semantics.
+ */
+export interface BackendRegistryOptions<TDef extends {
+    name: string;
+}, TInstance> {
+    /** Capitalised singular noun for error messages, e.g. `'Synthesizer'`. */
+    readonly noun: string;
+    /** Turn a def + (possibly empty) config into a runtime instance. */
+    readonly build: (def: TDef, config: Record<string, unknown>) => TInstance;
+    /** Adopt the first registered def as active when nothing is active yet. */
+    readonly autoAdoptFirst?: boolean;
+    /** (Re)build the active instance lazily on read rather than requiring it to
+     *  have been built at `setActive` time. Also makes `setActive` rebuild when a
+     *  config is supplied. Pair with {@link autoAdoptFirst}. */
+    readonly buildOnRead?: boolean;
+}
+export declare class ActiveBackendRegistry<TDef extends {
+    name: string;
+}, TInstance> {
+    private readonly opts;
+    private readonly defs;
+    private readonly instances;
+    private active;
+    constructor(opts: BackendRegistryOptions<TDef, TInstance>);
+    register(def: TDef, instance?: TInstance): void;
+    /** Overwrite an existing def, dropping the cached instance so the next build
+     *  uses the new def. */
+    replace(def: TDef, instance?: TInstance): void;
+    unregister(name: string): void;
+    list(): ReadonlyArray<TDef>;
+    has(name: string): boolean;
+    setActive(name: string, config?: Record<string, unknown>): TInstance;
+    /** Deactivate the current backend (callers fall back to their default). */
+    clearActive(): void;
+    getActive(): TInstance;
+    /** Active backend, or null when none is configured. Lets call sites degrade
+     *  gracefully (keyword recall, the OS voice, "no transcriber configured"). */
+    tryGetActive(): TInstance | null;
+    getActiveName(): string | null;
+    /** Cached instance for `name`, building it from its def on first use. */
+    private instantiate;
+    private buildInstance;
+}
+//# sourceMappingURL=active-backend-registry.d.ts.map

package/dist/registries/active-backend-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-backend-registry.d.ts","sourceRoot":"","sources":["../../src/registries/active-backend-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,sBAAsB,CAAC,IAAI,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,SAAS;IAC9E,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,SAAS,CAAC;IAC1E,2EAA2E;IAC3E,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC;;gEAE4D;IAC5D,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,qBAAa,qBAAqB,CAAC,IAAI,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,SAAS;IAK7D,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2B;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgC;IAC1D,OAAO,CAAC,MAAM,CAAuB;gBAER,IAAI,EAAE,sBAAsB,CAAC,IAAI,EAAE,SAAS,CAAC;IAE1E,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,SAAS,GAAG,IAAI;IAS/C;4BACwB;IACxB,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,SAAS,GAAG,IAAI;IAM9C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM9B,IAAI,IAAI,aAAa,CAAC,IAAI,CAAC;IAI3B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAmBpE,2EAA2E;IAC3E,WAAW,IAAI,IAAI;IAInB,SAAS,IAAI,SAAS;IAUtB;kFAC8E;IAC9E,YAAY,IAAI,SAAS,GAAG,IAAI;IAYhC,aAAa,IAAI,MAAM,GAAG,IAAI;IAI9B,yEAAyE;IACzE,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,aAAa;CAKtB"}

package/dist/registries/active-backend-registry.js

@@ -0,0 +1,108 @@
+export class ActiveBackendRegistry {
+    opts;
+    defs = new Map();
+    instances = new Map();
+    active = null;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    register(def, instance) {
+        if (this.defs.has(def.name)) {
+            throw new Error(`${this.opts.noun} already registered: ${def.name}`);
+        }
+        this.defs.set(def.name, def);
+        if (instance)
+            this.instances.set(def.name, instance);
+        if (this.opts.autoAdoptFirst && this.active === null)
+            this.active = def.name;
+    }
+    /** Overwrite an existing def, dropping the cached instance so the next build
+     *  uses the new def. */
+    replace(def, instance) {
+        this.defs.set(def.name, def);
+        this.instances.delete(def.name);
+        if (instance)
+            this.instances.set(def.name, instance);
+    }
+    unregister(name) {
+        this.defs.delete(name);
+        this.instances.delete(name);
+        if (this.active === name)
+            this.active = null;
+    }
+    list() {
+        return [...this.defs.values()];
+    }
+    has(name) {
+        return this.defs.has(name);
+    }
+    setActive(name, config) {
+        if (!this.defs.has(name))
+            throw new Error(`${this.opts.noun} not registered: ${name}`);
+        if (this.opts.buildOnRead) {
+            // Supplying a config (re)builds with it; otherwise reuse / lazily build.
+            if (config)
+                this.instances.set(name, this.buildInstance(name, config));
+            this.active = name;
+            return this.instantiate(name);
+        }
+        // Build once, on first activation; later activations reuse the cache and
+        // ignore `config`.
+        let instance = this.instances.get(name);
+        if (!instance) {
+            instance = this.buildInstance(name, config);
+            this.instances.set(name, instance);
+        }
+        this.active = name;
+        return instance;
+    }
+    /** Deactivate the current backend (callers fall back to their default). */
+    clearActive() {
+        this.active = null;
+    }
+    getActive() {
+        if (!this.active) {
+            throw new Error(`No active ${this.opts.noun.toLowerCase()}. Call setActive(name) first.`);
+        }
+        if (this.opts.buildOnRead)
+            return this.instantiate(this.active);
+        const inst = this.instances.get(this.active);
+        if (!inst)
+            throw new Error(`Active ${this.opts.noun.toLowerCase()} has no instance: ${this.active}`);
+        return inst;
+    }
+    /** Active backend, or null when none is configured. Lets call sites degrade
+     *  gracefully (keyword recall, the OS voice, "no transcriber configured"). */
+    tryGetActive() {
+        if (!this.active)
+            return null;
+        if (this.opts.buildOnRead) {
+            try {
+                return this.instantiate(this.active);
+            }
+            catch {
+                return null;
+            }
+        }
+        return this.instances.get(this.active) ?? null;
+    }
+    getActiveName() {
+        return this.active;
+    }
+    /** Cached instance for `name`, building it from its def on first use. */
+    instantiate(name) {
+        let inst = this.instances.get(name);
+        if (!inst) {
+            inst = this.buildInstance(name);
+            this.instances.set(name, inst);
+        }
+        return inst;
+    }
+    buildInstance(name, config) {
+        const def = this.defs.get(name);
+        if (!def)
+            throw new Error(`${this.opts.noun} not registered: ${name}`);
+        return this.opts.build(def, config ?? {});
+    }
+}
+//# sourceMappingURL=active-backend-registry.js.map

package/dist/registries/active-backend-registry.js.map

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