@moxxy/core 0.3.0

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

@@ -0,0 +1,59 @@
+/**
+ * Shared base for the "single active def, no built instance" registries
+ * (compactors, cache strategies, view renderers, tunnel providers, workflow
+ * executors). Each is a `Map<name, def>` with at most one *active* def at a
+ * time:
+ *   - plugins call `register(def)` at load time (throws on duplicate)
+ *   - the first registration auto-activates (when `autoAdoptFirst`, the
+ *     default), so a session always has a default once a plugin loads one
+ *   - the host / agent calls `setActive(name)` to switch
+ *   - call sites read `getActive()` (returns null when nothing is active)
+ *   - `unregister` clears the active slot rather than silently picking an
+ *     arbitrary successor — callers must `setActive()` again
+ *
+ * This is the def-only sibling of {@link ActiveBackendRegistry} (which also
+ * builds runtime *instances* for STT/TTS/embeddings). The two families share
+ * the same surface (register/replace/unregister/list/has/setActive/getActive/
+ * getActiveName/clearActive) so they stay consistent.
+ *
+ * `ModeRegistry` (change-listeners + legacy-name migration) and
+ * `ProviderRegistry` (disabled-set + built instances) deliberately stay
+ * bespoke rather than extend this base.
+ */
+export interface ActiveDefRegistryOptions {
+    /** Capitalised singular noun for error messages, e.g. `'Compactor'`. */
+    readonly noun: string;
+    /** Adopt the first registered def as active when nothing is active yet.
+     *  Defaults to `true`. */
+    readonly autoAdoptFirst?: boolean;
+}
+export declare class ActiveDefRegistry<TDef extends {
+    name: string;
+}> {
+    private readonly defs;
+    private active;
+    private readonly noun;
+    private readonly autoAdoptFirst;
+    constructor(opts: ActiveDefRegistryOptions);
+    /**
+     * Register a def. Throws on duplicate — use `replace()` to overwrite.
+     * Auto-activates the first registration (when `autoAdoptFirst`).
+     */
+    register(def: TDef): void;
+    /** Overwrite an existing def (or add a new one) without throwing.
+     *  Auto-activates when nothing is active yet (mirrors `register`). */
+    replace(def: TDef): void;
+    /**
+     * Remove a def. If it was active, the active slot is cleared (callers must
+     * `setActive()` rather than getting an arbitrary "next").
+     */
+    unregister(name: string): void;
+    list(): ReadonlyArray<TDef>;
+    has(name: string): boolean;
+    setActive(name: string): void;
+    /** Deactivate the current def (callers fall back to their default). */
+    clearActive(): void;
+    getActive(): TDef | null;
+    getActiveName(): string | null;
+}
+//# sourceMappingURL=active-def-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"active-def-registry.d.ts","sourceRoot":"","sources":["../../src/registries/active-def-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,wBAAwB;IACvC,wEAAwE;IACxE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;8BAC0B;IAC1B,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,qBAAa,iBAAiB,CAAC,IAAI,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE;IAC1D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2B;IAChD,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;gBAE7B,IAAI,EAAE,wBAAwB;IAK1C;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,IAAI,GAAG,IAAI;IAQzB;0EACsE;IACtE,OAAO,CAAC,GAAG,EAAE,IAAI,GAAG,IAAI;IAKxB;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK9B,IAAI,IAAI,aAAa,CAAC,IAAI,CAAC;IAI3B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM7B,uEAAuE;IACvE,WAAW,IAAI,IAAI;IAInB,SAAS,IAAI,IAAI,GAAG,IAAI;IAKxB,aAAa,IAAI,MAAM,GAAG,IAAI;CAG/B"}

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

@@ -0,0 +1,63 @@
+export class ActiveDefRegistry {
+    defs = new Map();
+    active = null;
+    noun;
+    autoAdoptFirst;
+    constructor(opts) {
+        this.noun = opts.noun;
+        this.autoAdoptFirst = opts.autoAdoptFirst ?? true;
+    }
+    /**
+     * Register a def. Throws on duplicate — use `replace()` to overwrite.
+     * Auto-activates the first registration (when `autoAdoptFirst`).
+     */
+    register(def) {
+        if (this.defs.has(def.name)) {
+            throw new Error(`${this.noun} already registered: ${def.name}`);
+        }
+        this.defs.set(def.name, def);
+        if (this.autoAdoptFirst && !this.active)
+            this.active = def.name;
+    }
+    /** Overwrite an existing def (or add a new one) without throwing.
+     *  Auto-activates when nothing is active yet (mirrors `register`). */
+    replace(def) {
+        this.defs.set(def.name, def);
+        if (this.autoAdoptFirst && !this.active)
+            this.active = def.name;
+    }
+    /**
+     * Remove a def. If it was active, the active slot is cleared (callers must
+     * `setActive()` rather than getting an arbitrary "next").
+     */
+    unregister(name) {
+        this.defs.delete(name);
+        if (this.active === name)
+            this.active = null;
+    }
+    list() {
+        return [...this.defs.values()];
+    }
+    has(name) {
+        return this.defs.has(name);
+    }
+    setActive(name) {
+        const def = this.defs.get(name);
+        if (!def)
+            throw new Error(`${this.noun} not registered: ${name}`);
+        this.active = def.name;
+    }
+    /** Deactivate the current def (callers fall back to their default). */
+    clearActive() {
+        this.active = null;
+    }
+    getActive() {
+        if (!this.active)
+            return null;
+        return this.defs.get(this.active) ?? null;
+    }
+    getActiveName() {
+        return this.active;
+    }
+}
+//# sourceMappingURL=active-def-registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"active-def-registry.js","sourceRoot":"","sources":["../../src/registries/active-def-registry.ts"],"names":[],"mappings":"AA8BA,MAAM,OAAO,iBAAiB;IACX,IAAI,GAAG,IAAI,GAAG,EAAgB,CAAC;IACxC,MAAM,GAAkB,IAAI,CAAC;IACpB,IAAI,CAAS;IACb,cAAc,CAAU;IAEzC,YAAY,IAA8B;QACxC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC;IACpD,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,GAAS;QAChB,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,wBAAwB,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC7B,IAAI,IAAI,CAAC,cAAc,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC;IAClE,CAAC;IAED;0EACsE;IACtE,OAAO,CAAC,GAAS;QACf,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC7B,IAAI,IAAI,CAAC,cAAc,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC;IAClE,CAAC;IAED;;;OAGG;IACH,UAAU,CAAC,IAAY;QACrB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACvB,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI;YAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IAC/C,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,SAAS,CAAC,IAAY;QACpB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,oBAAoB,IAAI,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC;IACzB,CAAC;IAED,uEAAuE;IACvE,WAAW;QACT,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,SAAS;QACP,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAC9B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;IAC5C,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF"}

package/dist/registries/agents.d.ts

@@ -0,0 +1,16 @@
+import type { AgentDef } from '@moxxy/sdk';
+import { DefMapRegistry } from './def-map-registry.js';
+/**
+ * Registry of named subagent kinds contributed by plugins. The
+ * `dispatch_agent` tool looks definitions up here by `agentType` and
+ * uses them as templates (systemPrompt, allowedTools, mode, …)
+ * for the spawned child.
+ *
+ * A flat name→def map ({@link DefMapRegistry}): register throws on
+ * duplicate so two plugins can't silently shadow each other — use
+ * `replace()` when you really want to override (e.g. user-config overrides).
+ */
+export declare class AgentRegistry extends DefMapRegistry<AgentDef> {
+    constructor();
+}
+//# sourceMappingURL=agents.d.ts.map

package/dist/registries/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/registries/agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;;;;;;;;GASG;AACH,qBAAa,aAAc,SAAQ,cAAc,CAAC,QAAQ,CAAC;;CAI1D"}

package/dist/registries/agents.js

@@ -0,0 +1,17 @@
+import { DefMapRegistry } from './def-map-registry.js';
+/**
+ * Registry of named subagent kinds contributed by plugins. The
+ * `dispatch_agent` tool looks definitions up here by `agentType` and
+ * uses them as templates (systemPrompt, allowedTools, mode, …)
+ * for the spawned child.
+ *
+ * A flat name→def map ({@link DefMapRegistry}): register throws on
+ * duplicate so two plugins can't silently shadow each other — use
+ * `replace()` when you really want to override (e.g. user-config overrides).
+ */
+export class AgentRegistry extends DefMapRegistry {
+    constructor() {
+        super({ noun: 'Agent', keyOf: (def) => def.name });
+    }
+}
+//# sourceMappingURL=agents.js.map

package/dist/registries/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/registries/agents.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;;;;;;;;GASG;AACH,MAAM,OAAO,aAAc,SAAQ,cAAwB;IACzD;QACE,KAAK,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;CACF"}

package/dist/registries/cache-strategies.d.ts

@@ -0,0 +1,12 @@
+import type { CacheStrategyDef } from '@moxxy/sdk';
+import { ActiveDefRegistry } from './active-def-registry.js';
+/**
+ * One active prompt-caching strategy per session. Register throws on
+ * duplicate, auto-activates the first, and `unregister` clears the active
+ * slot rather than picking an arbitrary successor. See
+ * {@link ActiveDefRegistry}.
+ */
+export declare class CacheStrategyRegistry extends ActiveDefRegistry<CacheStrategyDef> {
+    constructor();
+}
+//# sourceMappingURL=cache-strategies.d.ts.map

package/dist/registries/cache-strategies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-strategies.d.ts","sourceRoot":"","sources":["../../src/registries/cache-strategies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;;GAKG;AACH,qBAAa,qBAAsB,SAAQ,iBAAiB,CAAC,gBAAgB,CAAC;;CAI7E"}

package/dist/registries/cache-strategies.js

@@ -0,0 +1,13 @@
+import { ActiveDefRegistry } from './active-def-registry.js';
+/**
+ * One active prompt-caching strategy per session. Register throws on
+ * duplicate, auto-activates the first, and `unregister` clears the active
+ * slot rather than picking an arbitrary successor. See
+ * {@link ActiveDefRegistry}.
+ */
+export class CacheStrategyRegistry extends ActiveDefRegistry {
+    constructor() {
+        super({ noun: 'Cache strategy' });
+    }
+}
+//# sourceMappingURL=cache-strategies.js.map

package/dist/registries/cache-strategies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-strategies.js","sourceRoot":"","sources":["../../src/registries/cache-strategies.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,OAAO,qBAAsB,SAAQ,iBAAmC;IAC5E;QACE,KAAK,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC;IACpC,CAAC;CACF"}

package/dist/registries/channels.d.ts

@@ -0,0 +1,16 @@
+import type { ChannelAvailability, ChannelDef, ChannelFactoryDeps, ChannelRegistry } from '@moxxy/sdk';
+import { DefMapRegistry } from './def-map-registry.js';
+/**
+ * Flat name→def registry of channels ({@link DefMapRegistry}) plus
+ * `listWithAvailability`, which pairs each channel with its current
+ * availability (treating channels without an `isAvailable` hook as
+ * `{ ok: true }` and mapping a thrown probe to `{ ok: false }`).
+ */
+export declare class ChannelRegistryImpl extends DefMapRegistry<ChannelDef> implements ChannelRegistry {
+    constructor();
+    listWithAvailability(deps: ChannelFactoryDeps): Promise<ReadonlyArray<{
+        def: ChannelDef;
+        availability: ChannelAvailability;
+    }>>;
+}
+//# sourceMappingURL=channels.d.ts.map

package/dist/registries/channels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../../src/registries/channels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,UAAU,EACV,kBAAkB,EAClB,eAAe,EAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,cAAc,CAAC,UAAU,CAAE,YAAW,eAAe;;IAKtF,oBAAoB,CACxB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,aAAa,CAAC;QAAE,GAAG,EAAE,UAAU,CAAC;QAAC,YAAY,EAAE,mBAAmB,CAAA;KAAE,CAAC,CAAC;CAoBlF"}

package/dist/registries/channels.js

@@ -0,0 +1,35 @@
+import { DefMapRegistry } from './def-map-registry.js';
+/**
+ * Flat name→def registry of channels ({@link DefMapRegistry}) plus
+ * `listWithAvailability`, which pairs each channel with its current
+ * availability (treating channels without an `isAvailable` hook as
+ * `{ ok: true }` and mapping a thrown probe to `{ ok: false }`).
+ */
+export class ChannelRegistryImpl extends DefMapRegistry {
+    constructor() {
+        super({ noun: 'Channel', keyOf: (def) => def.name });
+    }
+    async listWithAvailability(deps) {
+        const out = [];
+        for (const def of this.defs.values()) {
+            let availability;
+            if (def.isAvailable) {
+                try {
+                    availability = await def.isAvailable(deps);
+                }
+                catch (err) {
+                    availability = {
+                        ok: false,
+                        reason: err instanceof Error ? err.message : String(err),
+                    };
+                }
+            }
+            else {
+                availability = { ok: true };
+            }
+            out.push({ def, availability });
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=channels.js.map

package/dist/registries/channels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.js","sourceRoot":"","sources":["../../src/registries/channels.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,OAAO,mBAAoB,SAAQ,cAA0B;IACjE;QACE,KAAK,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,oBAAoB,CACxB,IAAwB;QAExB,MAAM,GAAG,GAAkE,EAAE,CAAC;QAC9E,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACrC,IAAI,YAAiC,CAAC;YACtC,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;gBACpB,IAAI,CAAC;oBACH,YAAY,GAAG,MAAM,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;gBAC7C,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,YAAY,GAAG;wBACb,EAAE,EAAE,KAAK;wBACT,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;qBACzD,CAAC;gBACJ,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,YAAY,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;YAC9B,CAAC;YACD,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF"}

package/dist/registries/commands.d.ts

@@ -0,0 +1,29 @@
+import type { CommandDef } from '@moxxy/sdk';
+/**
+ * Registry of `/<name>` slash commands shared across every channel.
+ * Plugins contribute via `PluginSpec.commands`; channels read with
+ * `list()` / `get()` / `match()` to render their picker and dispatch
+ * matching user input.
+ *
+ * Naming conflicts throw at registration time so two plugins can't
+ * silently shadow the same name — use `replace()` for explicit
+ * overrides (e.g. user-config tweaks of a built-in).
+ */
+export declare class CommandRegistry {
+    private readonly commands;
+    /** Reverse-lookup table: alias → primary name. */
+    private readonly aliases;
+    register(cmd: CommandDef): void;
+    replace(cmd: CommandDef): void;
+    unregister(name: string): void;
+    get(name: string): CommandDef | undefined;
+    has(name: string): boolean;
+    list(): ReadonlyArray<CommandDef>;
+    /**
+     * Filter to commands visible in `channel`. Commands with no
+     * `channels` field are visible everywhere; commands with a list are
+     * visible only when `channel` appears in it.
+     */
+    listForChannel(channel: string): ReadonlyArray<CommandDef>;
+}
+//# sourceMappingURL=commands.d.ts.map

package/dist/registries/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/registries/commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;;;GASG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;IAC1D,kDAAkD;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IAErD,QAAQ,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI;IAgB/B,OAAO,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI;IAY9B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAO9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAOzC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,IAAI,IAAI,aAAa,CAAC,UAAU,CAAC;IAIjC;;;;OAIG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAAC,UAAU,CAAC;CAK3D"}

package/dist/registries/commands.js

@@ -0,0 +1,72 @@
+/**
+ * Registry of `/<name>` slash commands shared across every channel.
+ * Plugins contribute via `PluginSpec.commands`; channels read with
+ * `list()` / `get()` / `match()` to render their picker and dispatch
+ * matching user input.
+ *
+ * Naming conflicts throw at registration time so two plugins can't
+ * silently shadow the same name — use `replace()` for explicit
+ * overrides (e.g. user-config tweaks of a built-in).
+ */
+export class CommandRegistry {
+    commands = new Map();
+    /** Reverse-lookup table: alias → primary name. */
+    aliases = new Map();
+    register(cmd) {
+        if (this.commands.has(cmd.name)) {
+            throw new Error(`Command already registered: /${cmd.name}`);
+        }
+        if (this.aliases.has(cmd.name)) {
+            throw new Error(`Command name already in use as an alias: /${cmd.name}`);
+        }
+        this.commands.set(cmd.name, cmd);
+        for (const alias of cmd.aliases ?? []) {
+            if (this.aliases.has(alias) || this.commands.has(alias)) {
+                throw new Error(`Command alias already in use: /${alias}`);
+            }
+            this.aliases.set(alias, cmd.name);
+        }
+    }
+    replace(cmd) {
+        // Clean up any aliases of the prior definition before re-adding.
+        const prior = this.commands.get(cmd.name);
+        if (prior) {
+            for (const alias of prior.aliases ?? [])
+                this.aliases.delete(alias);
+        }
+        this.commands.set(cmd.name, cmd);
+        for (const alias of cmd.aliases ?? []) {
+            this.aliases.set(alias, cmd.name);
+        }
+    }
+    unregister(name) {
+        const cmd = this.commands.get(name);
+        if (!cmd)
+            return;
+        for (const alias of cmd.aliases ?? [])
+            this.aliases.delete(alias);
+        this.commands.delete(name);
+    }
+    get(name) {
+        const direct = this.commands.get(name);
+        if (direct)
+            return direct;
+        const aliased = this.aliases.get(name);
+        return aliased ? this.commands.get(aliased) : undefined;
+    }
+    has(name) {
+        return this.get(name) !== undefined;
+    }
+    list() {
+        return [...this.commands.values()];
+    }
+    /**
+     * Filter to commands visible in `channel`. Commands with no
+     * `channels` field are visible everywhere; commands with a list are
+     * visible only when `channel` appears in it.
+     */
+    listForChannel(channel) {
+        return this.list().filter((c) => !c.channels || c.channels.includes(channel));
+    }
+}
+//# sourceMappingURL=commands.js.map

package/dist/registries/commands.js.map

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

package/dist/registries/compactors.d.ts

@@ -0,0 +1,12 @@
+import type { CompactorDef } from '@moxxy/sdk';
+import { ActiveDefRegistry } from './active-def-registry.js';
+/**
+ * One active compaction strategy per session. Register throws on duplicate
+ * (use `replace()` to overwrite) and auto-activates the first registration;
+ * `unregister` clears the active slot rather than picking an arbitrary
+ * successor. See {@link ActiveDefRegistry}.
+ */
+export declare class CompactorRegistry extends ActiveDefRegistry<CompactorDef> {
+    constructor();
+}
+//# sourceMappingURL=compactors.d.ts.map

package/dist/registries/compactors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compactors.d.ts","sourceRoot":"","sources":["../../src/registries/compactors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,iBAAiB,CAAC,YAAY,CAAC;;CAIrE"}

package/dist/registries/compactors.js

@@ -0,0 +1,13 @@
+import { ActiveDefRegistry } from './active-def-registry.js';
+/**
+ * One active compaction strategy per session. Register throws on duplicate
+ * (use `replace()` to overwrite) and auto-activates the first registration;
+ * `unregister` clears the active slot rather than picking an arbitrary
+ * successor. See {@link ActiveDefRegistry}.
+ */
+export class CompactorRegistry extends ActiveDefRegistry {
+    constructor() {
+        super({ noun: 'Compactor' });
+    }
+}
+//# sourceMappingURL=compactors.js.map

package/dist/registries/compactors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compactors.js","sourceRoot":"","sources":["../../src/registries/compactors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,OAAO,iBAAkB,SAAQ,iBAA+B;IACpE;QACE,KAAK,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IAC/B,CAAC;CACF"}

package/dist/registries/def-map-registry.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Shared base for the "flat name→def, no active slot" registries (agents,
+ * channels, surfaces). A `Map<key, def>` exposing register (throws on
+ * duplicate), replace (overwrite), unregister, list, get and has. The three
+ * registries differ only in their noun and key field (`name` vs `kind`),
+ * supplied via {@link DefMapRegistryOptions}.
+ *
+ * `ChannelRegistryImpl` extends this and adds `listWithAvailability`;
+ * `SurfaceRegistryImpl` keys on `kind` rather than `name`.
+ */
+export interface DefMapRegistryOptions<TDef, K> {
+    /** Capitalised singular noun for error messages, e.g. `'Agent'`. */
+    readonly noun: string;
+    /** Extract the map key from a def, e.g. `(d) => d.name` or `(d) => d.kind`. */
+    readonly keyOf: (def: TDef) => K;
+}
+export declare class DefMapRegistry<TDef, K = string> {
+    protected readonly defs: Map<K, TDef>;
+    private readonly noun;
+    private readonly keyOf;
+    constructor(opts: DefMapRegistryOptions<TDef, K>);
+    /**
+     * Register a definition. Throws on duplicate so two plugins can't silently
+     * shadow each other — use `replace()` when you really want to override.
+     */
+    register(def: TDef): void;
+    replace(def: TDef): void;
+    unregister(key: K): void;
+    list(): ReadonlyArray<TDef>;
+    get(key: K): TDef | undefined;
+    has(key: K): boolean;
+}
+//# sourceMappingURL=def-map-registry.d.ts.map

package/dist/registries/def-map-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"def-map-registry.d.ts","sourceRoot":"","sources":["../../src/registries/def-map-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,WAAW,qBAAqB,CAAC,IAAI,EAAE,CAAC;IAC5C,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,KAAK,CAAC,CAAC;CAClC;AAED,qBAAa,cAAc,CAAC,IAAI,EAAE,CAAC,GAAG,MAAM;IAC1C,SAAS,CAAC,QAAQ,CAAC,IAAI,eAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;gBAE7B,IAAI,EAAE,qBAAqB,CAAC,IAAI,EAAE,CAAC,CAAC;IAKhD;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,IAAI,GAAG,IAAI;IAQzB,OAAO,CAAC,GAAG,EAAE,IAAI,GAAG,IAAI;IAIxB,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI;IAIxB,IAAI,IAAI,aAAa,CAAC,IAAI,CAAC;IAI3B,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS;IAI7B,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;CAGrB"}

package/dist/registries/def-map-registry.js

@@ -0,0 +1,36 @@
+export class DefMapRegistry {
+    defs = new Map();
+    noun;
+    keyOf;
+    constructor(opts) {
+        this.noun = opts.noun;
+        this.keyOf = opts.keyOf;
+    }
+    /**
+     * Register a definition. Throws on duplicate so two plugins can't silently
+     * shadow each other — use `replace()` when you really want to override.
+     */
+    register(def) {
+        const key = this.keyOf(def);
+        if (this.defs.has(key)) {
+            throw new Error(`${this.noun} already registered: ${String(key)}`);
+        }
+        this.defs.set(key, def);
+    }
+    replace(def) {
+        this.defs.set(this.keyOf(def), def);
+    }
+    unregister(key) {
+        this.defs.delete(key);
+    }
+    list() {
+        return [...this.defs.values()];
+    }
+    get(key) {
+        return this.defs.get(key);
+    }
+    has(key) {
+        return this.defs.has(key);
+    }
+}
+//# sourceMappingURL=def-map-registry.js.map

package/dist/registries/def-map-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"def-map-registry.js","sourceRoot":"","sources":["../../src/registries/def-map-registry.ts"],"names":[],"mappings":"AAiBA,MAAM,OAAO,cAAc;IACN,IAAI,GAAG,IAAI,GAAG,EAAW,CAAC;IAC5B,IAAI,CAAS;IACb,KAAK,CAAmB;IAEzC,YAAY,IAAoC;QAC9C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,GAAS;QAChB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,wBAAwB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,CAAC,GAAS;QACf,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IACtC,CAAC;IAED,UAAU,CAAC,GAAM;QACf,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,GAAG,CAAC,GAAM;QACR,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED,GAAG,CAAC,GAAM;QACR,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;CACF"}

package/dist/registries/embedders.d.ts

@@ -0,0 +1,16 @@
+import type { EmbedderDef, EmbeddingProvider } from '@moxxy/sdk';
+import { ActiveBackendRegistry } from './active-backend-registry.js';
+/**
+ * Registry of text-embedding backends:
+ *   - plugins call `register(def)` at load time (via `PluginSpec.embedders`)
+ *   - the host/CLI calls `setActive(name, config)` once an embedder is chosen
+ *   - @moxxy/plugin-memory reads `getActive()` / `tryGetActive()` for recall
+ *
+ * At most one embedder is active at a time, selected explicitly. `createClient`
+ * is called lazily on first activation, so a registered-but-unselected embedder
+ * (e.g. the heavy transformers one) never instantiates its runtime.
+ */
+export declare class EmbedderRegistry extends ActiveBackendRegistry<EmbedderDef, EmbeddingProvider> {
+    constructor();
+}
+//# sourceMappingURL=embedders.d.ts.map

package/dist/registries/embedders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedders.d.ts","sourceRoot":"","sources":["../../src/registries/embedders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE;;;;;;;;;GASG;AACH,qBAAa,gBAAiB,SAAQ,qBAAqB,CAAC,WAAW,EAAE,iBAAiB,CAAC;;CAI1F"}

package/dist/registries/embedders.js

@@ -0,0 +1,17 @@
+import { ActiveBackendRegistry } from './active-backend-registry.js';
+/**
+ * Registry of text-embedding backends:
+ *   - plugins call `register(def)` at load time (via `PluginSpec.embedders`)
+ *   - the host/CLI calls `setActive(name, config)` once an embedder is chosen
+ *   - @moxxy/plugin-memory reads `getActive()` / `tryGetActive()` for recall
+ *
+ * At most one embedder is active at a time, selected explicitly. `createClient`
+ * is called lazily on first activation, so a registered-but-unselected embedder
+ * (e.g. the heavy transformers one) never instantiates its runtime.
+ */
+export class EmbedderRegistry extends ActiveBackendRegistry {
+    constructor() {
+        super({ noun: 'Embedder', build: (def, config) => def.createClient(config) });
+    }
+}
+//# sourceMappingURL=embedders.js.map

package/dist/registries/embedders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedders.js","sourceRoot":"","sources":["../../src/registries/embedders.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE;;;;;;;;;GASG;AACH,MAAM,OAAO,gBAAiB,SAAQ,qBAAqD;IACzF;QACE,KAAK,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAChF,CAAC;CACF"}

package/dist/registries/isolators.d.ts

@@ -0,0 +1,21 @@
+import type { Isolator } from '@moxxy/sdk';
+/**
+ * Collection of capability isolators contributed by plugins via
+ * `PluginSpec.isolators`. Unlike the single-active registries, this is just the
+ * set of AVAILABLE isolators — selection (and ownership of the security
+ * boundary) stays with the active security layer (`@moxxy/plugin-security`),
+ * which reads these and picks one by `security.isolator` config.
+ *
+ * A contributed isolator is therefore NEVER auto-activated: registration only
+ * makes it available; the user must opt in by name, so a rogue plugin can't
+ * silently weaken isolation just by being installed.
+ */
+export declare class IsolatorRegistry {
+    private readonly impls;
+    register(iso: Isolator): void;
+    unregister(name: string): void;
+    get(name: string): Isolator | undefined;
+    has(name: string): boolean;
+    list(): ReadonlyArray<Isolator>;
+}
+//# sourceMappingURL=isolators.d.ts.map

package/dist/registries/isolators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isolators.d.ts","sourceRoot":"","sources":["../../src/registries/isolators.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;;;;;GAUG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+B;IAErD,QAAQ,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI;IAM7B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAIvC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,IAAI,IAAI,aAAa,CAAC,QAAQ,CAAC;CAGhC"}

package/dist/registries/isolators.js

@@ -0,0 +1,32 @@
+/**
+ * Collection of capability isolators contributed by plugins via
+ * `PluginSpec.isolators`. Unlike the single-active registries, this is just the
+ * set of AVAILABLE isolators — selection (and ownership of the security
+ * boundary) stays with the active security layer (`@moxxy/plugin-security`),
+ * which reads these and picks one by `security.isolator` config.
+ *
+ * A contributed isolator is therefore NEVER auto-activated: registration only
+ * makes it available; the user must opt in by name, so a rogue plugin can't
+ * silently weaken isolation just by being installed.
+ */
+export class IsolatorRegistry {
+    impls = new Map();
+    register(iso) {
+        // Overwrite by name: an isolator may arrive via more than one path (a
+        // bundled built-in AND a discovered copy). Same name → same role; last wins.
+        this.impls.set(iso.name, iso);
+    }
+    unregister(name) {
+        this.impls.delete(name);
+    }
+    get(name) {
+        return this.impls.get(name);
+    }
+    has(name) {
+        return this.impls.has(name);
+    }
+    list() {
+        return [...this.impls.values()];
+    }
+}
+//# sourceMappingURL=isolators.js.map

package/dist/registries/isolators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isolators.js","sourceRoot":"","sources":["../../src/registries/isolators.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,gBAAgB;IACV,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAC;IAErD,QAAQ,CAAC,GAAa;QACpB,sEAAsE;QACtE,6EAA6E;QAC7E,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAClC,CAAC;CACF"}

package/dist/registries/modes.d.ts

@@ -0,0 +1,28 @@
+import { type ModeDef } from '@moxxy/sdk';
+export declare class ModeRegistry {
+    private readonly modes;
+    private active;
+    private readonly changeListeners;
+    /** Observe active-mode changes — used by the runner to broadcast
+     *  InfoChanged so remote clients track a mode switch (whether it came from
+     *  a `setMode` RPC or a mode handing off to another mode mid-session). */
+    onActiveChange(fn: () => void): () => void;
+    /**
+     * Register a mode. Throws on duplicate — use `replace()` for
+     * overwrite. Auto-activates on first registration (modes need a default
+     * for any session to work).
+     */
+    register(mode: ModeDef): void;
+    replace(mode: ModeDef): void;
+    /**
+     * Remove a mode. If it was active, the active slot is cleared —
+     * callers must `setActive()` explicitly rather than silently picking
+     * some arbitrary "next" mode.
+     */
+    unregister(name: string): void;
+    list(): ReadonlyArray<ModeDef>;
+    setActive(name: string): void;
+    getActive(): ModeDef;
+    private activate;
+}
+//# sourceMappingURL=modes.d.ts.map