@moxxy/core 0.3.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"modes.d.ts","sourceRoot":"","sources":["../../src/registries/modes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAE3D,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8B;IACpD,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyB;IAEzD;;8EAE0E;IAC1E,cAAc,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAK1C;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAQ7B,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAe5B;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK9B,IAAI,IAAI,aAAa,CAAC,OAAO,CAAC;IAI9B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAU7B,SAAS,IAAI,OAAO;IAOpB,OAAO,CAAC,QAAQ;CAKjB"}

package/dist/registries/modes.js

@@ -0,0 +1,81 @@
+import { migrateModeName } from '@moxxy/sdk';
+export class ModeRegistry {
+    modes = new Map();
+    active = null;
+    changeListeners = new Set();
+    /** 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) {
+        this.changeListeners.add(fn);
+        return () => this.changeListeners.delete(fn);
+    }
+    /**
+     * 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) {
+        if (this.modes.has(mode.name)) {
+            throw new Error(`Mode already registered: ${mode.name}`);
+        }
+        this.modes.set(mode.name, mode);
+        if (!this.active)
+            this.activate(mode);
+    }
+    replace(mode) {
+        this.modes.set(mode.name, mode);
+        if (!this.active) {
+            this.activate(mode);
+        }
+        else if (this.active === mode.name) {
+            // The active mode's def was swapped in place (e.g. a hot-reloaded mode
+            // plugin). `getActive()` already returns the new def, but observers of
+            // `onActiveChange` (the runner broadcasting InfoChanged) must be told the
+            // active behaviour changed under them, or remote clients keep driving the
+            // stale def. `activate()` would early-return on the name match, so notify
+            // directly.
+            for (const fn of this.changeListeners)
+                fn();
+        }
+    }
+    /**
+     * 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) {
+        this.modes.delete(name);
+        if (this.active === name)
+            this.active = null;
+    }
+    list() {
+        return [...this.modes.values()];
+    }
+    setActive(name) {
+        // Prefer the literal name; only when it isn't registered fall back to the
+        // legacy-name map (e.g. a persisted "tool-use" → "default"). This never
+        // overrides a validly-registered name and keeps an old config / preference
+        // / setMode RPC value from crashing a session with "Mode not registered".
+        const mode = this.modes.get(name) ?? this.modes.get(migrateModeName(name));
+        if (!mode)
+            throw new Error(`Mode not registered: ${name}`);
+        this.activate(mode);
+    }
+    getActive() {
+        if (!this.active)
+            throw new Error('No active mode registered.');
+        const mode = this.modes.get(this.active);
+        if (!mode)
+            throw new Error(`Active mode missing: ${this.active}`);
+        return mode;
+    }
+    activate(mode) {
+        if (this.active === mode.name)
+            return;
+        this.active = mode.name;
+        for (const fn of this.changeListeners)
+            fn();
+    }
+}
+//# sourceMappingURL=modes.js.map

package/dist/registries/modes.js.map

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

package/dist/registries/providers.d.ts

@@ -0,0 +1,44 @@
+import type { LLMProvider, ProviderDef } from '@moxxy/sdk';
+export declare class ProviderRegistry {
+    private readonly defs;
+    private readonly instances;
+    private active;
+    /**
+     * Names the user disabled. Kept name-based (not def-based) so it can be
+     * seeded from preferences BEFORE the plugins register their defs — boot
+     * order doesn't matter. A disabled provider stays registered/listable but
+     * can't be activated.
+     */
+    private readonly disabled;
+    /**
+     * Register a provider def. Throws on duplicate — use `replace()` for
+     * explicit overwrite. Matches the semantics of `tools` and `channels`.
+     */
+    register(def: ProviderDef, instance?: LLMProvider): void;
+    /**
+     * Overwrite an existing def (also drops the cached instance so the new
+     * createClient gets called).
+     *
+     * Invariant: replacing the ACTIVE provider's def leaves `active` pointing at
+     * it but with no cached instance, so `getActive()` throws until the caller
+     * rebuilds the instance. Callers replacing the active provider MUST follow
+     * with `setActive(name, config)` (replace can't rebuild itself — it has no
+     * config). The sole production caller does exactly that.
+     */
+    replace(def: ProviderDef, instance?: LLMProvider): void;
+    unregister(name: string): void;
+    list(): ReadonlyArray<ProviderDef>;
+    /**
+     * Enable/disable a provider by name. Disabling the ACTIVE provider is
+     * refused — switch first, then disable — so a session never ends up with an
+     * active-but-disabled provider. Unknown names are accepted (the set seeds
+     * from preferences before plugins register), except when disabling via a
+     * live toggle is meaningless because the provider is active.
+     */
+    setEnabled(name: string, enabled: boolean): void;
+    isEnabled(name: string): boolean;
+    setActive(name: string, config?: Record<string, unknown>): LLMProvider;
+    getActive(): LLMProvider;
+    getActiveName(): string | null;
+}
+//# sourceMappingURL=providers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../src/registries/providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE3D,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkC;IACvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;IAC5D,OAAO,CAAC,MAAM,CAAuB;IACrC;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAE9C;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,IAAI;IAQxD;;;;;;;;;OASG;IACH,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,IAAI;IAMvD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM9B,IAAI,IAAI,aAAa,CAAC,WAAW,CAAC;IAIlC;;;;;;OAMG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAQhD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIhC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW;IAetE,SAAS,IAAI,WAAW;IAOxB,aAAa,IAAI,MAAM,GAAG,IAAI;CAG/B"}

package/dist/registries/providers.js

@@ -0,0 +1,95 @@
+export class ProviderRegistry {
+    defs = new Map();
+    instances = new Map();
+    active = null;
+    /**
+     * Names the user disabled. Kept name-based (not def-based) so it can be
+     * seeded from preferences BEFORE the plugins register their defs — boot
+     * order doesn't matter. A disabled provider stays registered/listable but
+     * can't be activated.
+     */
+    disabled = new Set();
+    /**
+     * Register a provider def. Throws on duplicate — use `replace()` for
+     * explicit overwrite. Matches the semantics of `tools` and `channels`.
+     */
+    register(def, instance) {
+        if (this.defs.has(def.name)) {
+            throw new Error(`Provider already registered: ${def.name}`);
+        }
+        this.defs.set(def.name, def);
+        if (instance)
+            this.instances.set(def.name, instance);
+    }
+    /**
+     * Overwrite an existing def (also drops the cached instance so the new
+     * createClient gets called).
+     *
+     * Invariant: replacing the ACTIVE provider's def leaves `active` pointing at
+     * it but with no cached instance, so `getActive()` throws until the caller
+     * rebuilds the instance. Callers replacing the active provider MUST follow
+     * with `setActive(name, config)` (replace can't rebuild itself — it has no
+     * config). The sole production caller does exactly that.
+     */
+    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()];
+    }
+    /**
+     * Enable/disable a provider by name. Disabling the ACTIVE provider is
+     * refused — switch first, then disable — so a session never ends up with an
+     * active-but-disabled provider. Unknown names are accepted (the set seeds
+     * from preferences before plugins register), except when disabling via a
+     * live toggle is meaningless because the provider is active.
+     */
+    setEnabled(name, enabled) {
+        if (!enabled && this.active === name) {
+            throw new Error(`Cannot disable the active provider "${name}" — switch providers first.`);
+        }
+        if (enabled)
+            this.disabled.delete(name);
+        else
+            this.disabled.add(name);
+    }
+    isEnabled(name) {
+        return !this.disabled.has(name);
+    }
+    setActive(name, config) {
+        const def = this.defs.get(name);
+        if (!def)
+            throw new Error(`Provider not registered: ${name}`);
+        if (this.disabled.has(name)) {
+            throw new Error(`Provider "${name}" is disabled — enable it first.`);
+        }
+        let instance = this.instances.get(name);
+        if (!instance) {
+            instance = def.createClient(config ?? {});
+            this.instances.set(name, instance);
+        }
+        this.active = name;
+        return instance;
+    }
+    getActive() {
+        if (!this.active)
+            throw new Error('No active provider. Call setActive(name) first.');
+        const inst = this.instances.get(this.active);
+        if (!inst)
+            throw new Error(`Active provider has no instance: ${this.active}`);
+        return inst;
+    }
+    getActiveName() {
+        return this.active;
+    }
+}
+//# sourceMappingURL=providers.js.map

package/dist/registries/providers.js.map

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

package/dist/registries/skills.d.ts

@@ -0,0 +1,24 @@
+import type { Skill, SkillRegistry } from '@moxxy/sdk';
+export declare class SkillRegistryImpl implements SkillRegistry {
+    private readonly byId;
+    private readonly byNameIdx;
+    list(): ReadonlyArray<Skill>;
+    get(id: string): Skill | undefined;
+    byName(name: string): Skill | undefined;
+    filterByTriggers(prompt: string): ReadonlyArray<Skill>;
+    /**
+     * Register a skill. Throws on duplicate id — use `replace()` for
+     * overwrite (or `replaceAll()` for atomic bulk swap).
+     */
+    register(skill: Skill): void;
+    replace(skill: Skill): void;
+    unregister(id: string): void;
+    clear(): void;
+    /**
+     * Replace the registry's entire contents atomically (no observable empty
+     * window). Used by `reload_skills` so a concurrent lookup never sees
+     * zero skills while a rescan is in flight.
+     */
+    replaceAll(skills: ReadonlyArray<Skill>): void;
+}
+//# sourceMappingURL=skills.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/registries/skills.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEvD,qBAAa,iBAAkB,YAAW,aAAa;IACrD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA4B;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;IAEtD,IAAI,IAAI,aAAa,CAAC,KAAK,CAAC;IAI5B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAIlC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAIvC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC;IAUtD;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAQ5B,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAc3B,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAO5B,KAAK,IAAI,IAAI;IAKb;;;;OAIG;IACH,UAAU,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,IAAI;CAe/C"}

package/dist/registries/skills.js

@@ -0,0 +1,81 @@
+export class SkillRegistryImpl {
+    byId = new Map();
+    byNameIdx = new Map();
+    list() {
+        return [...this.byId.values()];
+    }
+    get(id) {
+        return this.byId.get(id);
+    }
+    byName(name) {
+        return this.byNameIdx.get(name);
+    }
+    filterByTriggers(prompt) {
+        const lower = prompt.toLowerCase();
+        const matches = [];
+        for (const skill of this.byId.values()) {
+            const triggers = skill.frontmatter.triggers ?? [];
+            if (triggers.some((t) => lower.includes(t.toLowerCase())))
+                matches.push(skill);
+        }
+        return matches;
+    }
+    /**
+     * Register a skill. Throws on duplicate id — use `replace()` for
+     * overwrite (or `replaceAll()` for atomic bulk swap).
+     */
+    register(skill) {
+        if (this.byId.has(skill.id)) {
+            throw new Error(`Skill already registered: ${skill.id}`);
+        }
+        this.byId.set(skill.id, skill);
+        this.byNameIdx.set(skill.frontmatter.name, skill);
+    }
+    replace(skill) {
+        // Drop the prior definition's name from the index when it changed —
+        // otherwise an edited skill re-registered under the same id but a new
+        // frontmatter.name leaves the OLD name pointing at the stale skill
+        // forever (two live names for one id). Mirrors CommandRegistry.replace's
+        // alias cleanup.
+        const prior = this.byId.get(skill.id);
+        if (prior && prior.frontmatter.name !== skill.frontmatter.name) {
+            this.byNameIdx.delete(prior.frontmatter.name);
+        }
+        this.byId.set(skill.id, skill);
+        this.byNameIdx.set(skill.frontmatter.name, skill);
+    }
+    unregister(id) {
+        const skill = this.byId.get(id);
+        if (!skill)
+            return;
+        this.byId.delete(id);
+        this.byNameIdx.delete(skill.frontmatter.name);
+    }
+    clear() {
+        this.byId.clear();
+        this.byNameIdx.clear();
+    }
+    /**
+     * Replace the registry's entire contents atomically (no observable empty
+     * window). Used by `reload_skills` so a concurrent lookup never sees
+     * zero skills while a rescan is in flight.
+     */
+    replaceAll(skills) {
+        const nextById = new Map();
+        const nextByName = new Map();
+        for (const s of skills) {
+            nextById.set(s.id, s);
+            nextByName.set(s.frontmatter.name, s);
+        }
+        // Synchronous swap: callers between these lines still see the OLD
+        // registry (Maps aren't replaced, only repopulated). Clear+set is the
+        // shortest synchronous window we can achieve in JS for Map fields.
+        this.byId.clear();
+        this.byNameIdx.clear();
+        for (const [k, v] of nextById)
+            this.byId.set(k, v);
+        for (const [k, v] of nextByName)
+            this.byNameIdx.set(k, v);
+    }
+}
+//# sourceMappingURL=skills.js.map

package/dist/registries/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/registries/skills.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,iBAAiB;IACX,IAAI,GAAG,IAAI,GAAG,EAAiB,CAAC;IAChC,SAAS,GAAG,IAAI,GAAG,EAAiB,CAAC;IAEtD,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,CAAC,IAAY;QACjB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,gBAAgB,CAAC,MAAc;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QACnC,MAAM,OAAO,GAAY,EAAE,CAAC;QAC5B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACvC,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,QAAQ,IAAI,EAAE,CAAC;YAClD,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjF,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,KAAY;QACnB,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,6BAA6B,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC/B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,CAAC,KAAY;QAClB,oEAAoE;QACpE,sEAAsE;QACtE,mEAAmE;QACnE,yEAAyE;QACzE,iBAAiB;QACjB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACtC,IAAI,KAAK,IAAI,KAAK,CAAC,WAAW,CAAC,IAAI,KAAK,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;YAC/D,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC/B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC;IAED,UAAU,CAAC,EAAU;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACrB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAClB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACH,UAAU,CAAC,MAA4B;QACrC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAiB,CAAC;QAC1C,MAAM,UAAU,GAAG,IAAI,GAAG,EAAiB,CAAC;QAC5C,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YACtB,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACxC,CAAC;QACD,kEAAkE;QAClE,sEAAsE;QACtE,mEAAmE;QACnE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAClB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,QAAQ;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACnD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,UAAU;YAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5D,CAAC;CACF"}

package/dist/registries/surfaces.d.ts

@@ -0,0 +1,13 @@
+import type { SurfaceDef, SurfaceKind, SurfaceRegistry } from '@moxxy/sdk';
+import { DefMapRegistry } from './def-map-registry.js';
+/**
+ * Registry of surface defs contributed by plugins (terminal, browser, …),
+ * keyed by `kind`. A flat name→def map ({@link DefMapRegistry}) with
+ * register/unregister so the PluginHost can add and remove a plugin's
+ * surfaces on load/unload. The live, open instances are managed separately by
+ * the {@link SurfaceHostImpl}; this registry only knows the available kinds.
+ */
+export declare class SurfaceRegistryImpl extends DefMapRegistry<SurfaceDef, SurfaceKind> implements SurfaceRegistry {
+    constructor();
+}
+//# sourceMappingURL=surfaces.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"surfaces.d.ts","sourceRoot":"","sources":["../../src/registries/surfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;;;;;GAMG;AACH,qBAAa,mBACX,SAAQ,cAAc,CAAC,UAAU,EAAE,WAAW,CAC9C,YAAW,eAAe;;CAK3B"}

package/dist/registries/surfaces.js

@@ -0,0 +1,14 @@
+import { DefMapRegistry } from './def-map-registry.js';
+/**
+ * Registry of surface defs contributed by plugins (terminal, browser, …),
+ * keyed by `kind`. A flat name→def map ({@link DefMapRegistry}) with
+ * register/unregister so the PluginHost can add and remove a plugin's
+ * surfaces on load/unload. The live, open instances are managed separately by
+ * the {@link SurfaceHostImpl}; this registry only knows the available kinds.
+ */
+export class SurfaceRegistryImpl extends DefMapRegistry {
+    constructor() {
+        super({ noun: 'Surface', keyOf: (def) => def.kind });
+    }
+}
+//# sourceMappingURL=surfaces.js.map

package/dist/registries/surfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaces.js","sourceRoot":"","sources":["../../src/registries/surfaces.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,OAAO,mBACX,SAAQ,cAAuC;IAG/C;QACE,KAAK,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;CACF"}

package/dist/registries/synthesizers.d.ts

@@ -0,0 +1,26 @@
+import type { Synthesizer, SynthesizerDef } from '@moxxy/sdk';
+import { ActiveBackendRegistry } from './active-backend-registry.js';
+/**
+ * Registry of text-to-speech backends:
+ *   - plugins call `register(def)` at load time
+ *   - read-aloud surfaces read `tryGetActive()` to turn text into audio
+ *   - the agent switches/deactivates via the `set_voice` tool
+ *
+ * Unlike transcribers/embedders (where the host picks a backend explicitly),
+ * TTS has a sensible default: the first synthesizer registered auto-becomes
+ * active (`autoAdoptFirst`), so a user who asks the agent to author an
+ * ElevenLabs plugin gets read-aloud through it immediately — no extra activate
+ * step. Because `active` can thus be set without a built instance, the active
+ * synthesizer is (re)built lazily on read (`buildOnRead`). `getActive()` throws
+ * when none is active so the desktop falls back to the OS `speechSynthesis`.
+ *
+ * `secretResolver` is the vault-backed `getSecret` (the same one wired into
+ * tool contexts), handed to each synthesizer's `create(ctx)` so a TTS plugin
+ * can read its API key without touching `process.env`.
+ */
+export declare class SynthesizerRegistry extends ActiveBackendRegistry<SynthesizerDef, Synthesizer> {
+    constructor(opts?: {
+        secretResolver?: (name: string) => Promise<string | null>;
+    });
+}
+//# sourceMappingURL=synthesizers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"synthesizers.d.ts","sourceRoot":"","sources":["../../src/registries/synthesizers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,mBAAoB,SAAQ,qBAAqB,CAAC,cAAc,EAAE,WAAW,CAAC;gBAC7E,IAAI,GAAE;QAAE,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;KAAO;CAarF"}

package/dist/registries/synthesizers.js

@@ -0,0 +1,34 @@
+import { ActiveBackendRegistry } from './active-backend-registry.js';
+/**
+ * Registry of text-to-speech backends:
+ *   - plugins call `register(def)` at load time
+ *   - read-aloud surfaces read `tryGetActive()` to turn text into audio
+ *   - the agent switches/deactivates via the `set_voice` tool
+ *
+ * Unlike transcribers/embedders (where the host picks a backend explicitly),
+ * TTS has a sensible default: the first synthesizer registered auto-becomes
+ * active (`autoAdoptFirst`), so a user who asks the agent to author an
+ * ElevenLabs plugin gets read-aloud through it immediately — no extra activate
+ * step. Because `active` can thus be set without a built instance, the active
+ * synthesizer is (re)built lazily on read (`buildOnRead`). `getActive()` throws
+ * when none is active so the desktop falls back to the OS `speechSynthesis`.
+ *
+ * `secretResolver` is the vault-backed `getSecret` (the same one wired into
+ * tool contexts), handed to each synthesizer's `create(ctx)` so a TTS plugin
+ * can read its API key without touching `process.env`.
+ */
+export class SynthesizerRegistry extends ActiveBackendRegistry {
+    constructor(opts = {}) {
+        const { secretResolver } = opts;
+        super({
+            noun: 'Synthesizer',
+            autoAdoptFirst: true,
+            buildOnRead: true,
+            build: (def, config) => def.create({
+                config,
+                ...(secretResolver ? { getSecret: secretResolver } : {}),
+            }),
+        });
+    }
+}
+//# sourceMappingURL=synthesizers.js.map

package/dist/registries/synthesizers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesizers.js","sourceRoot":"","sources":["../../src/registries/synthesizers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,mBAAoB,SAAQ,qBAAkD;IACzF,YAAY,OAAsE,EAAE;QAClF,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;QAChC,KAAK,CAAC;YACJ,IAAI,EAAE,aAAa;YACnB,cAAc,EAAE,IAAI;YACpB,WAAW,EAAE,IAAI;YACjB,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CACrB,GAAG,CAAC,MAAM,CAAC;gBACT,MAAM;gBACN,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACzD,CAAC;SACL,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/registries/tools.d.ts

@@ -0,0 +1,49 @@
+import type { EventLogReader, SubagentSpawner, ToolDef } from '@moxxy/sdk';
+import type { Logger } from '../logger.js';
+export interface ToolRegistry {
+    list(): ReadonlyArray<ToolDef>;
+    get(name: string): ToolDef | undefined;
+    has(name: string): boolean;
+    register(tool: ToolDef): void;
+    unregister(name: string): void;
+    execute(name: string, input: unknown, signal: AbortSignal, opts?: ExecuteOptions): Promise<unknown>;
+}
+interface ExecuteOptions {
+    readonly callId?: string;
+    readonly sessionId?: string;
+    readonly turnId?: string;
+    readonly log?: EventLogReader;
+    readonly logger?: Logger;
+    readonly cwd?: string;
+    /**
+     * Optional spawner — passed by run-turn so multi-agent tools (e.g.
+     * `dispatch_agent`) can fan work out from inside the tool-use loop.
+     * Plain `tools.execute()` callers (tests, one-off scripts) may omit it.
+     */
+    readonly subagents?: SubagentSpawner;
+}
+export declare class ToolRegistryImpl implements ToolRegistry {
+    private readonly tools;
+    private readonly defaultLogger;
+    private readonly defaultCwd;
+    /**
+     * Vault-backed secret resolver, when the host wires one. Surfaced to
+     * every tool handler as `ctx.getSecret(name)` so plugins can read an
+     * API key at call time without the value ever entering the model's
+     * context or `process.env`.
+     */
+    private readonly secretResolver?;
+    constructor(opts: {
+        logger: Logger;
+        cwd: string;
+        secretResolver?: (name: string) => Promise<string | null>;
+    });
+    list(): ReadonlyArray<ToolDef>;
+    get(name: string): ToolDef | undefined;
+    has(name: string): boolean;
+    register(tool: ToolDef): void;
+    unregister(name: string): void;
+    execute(name: string, input: unknown, signal: AbortSignal, opts?: ExecuteOptions): Promise<unknown>;
+}
+export {};
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/registries/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAe,OAAO,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,MAAM,WAAW,YAAY;IAC3B,IAAI,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACvC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACrG;AAED,UAAU,cAAc;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,CAAC,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,eAAe,CAAC;CACtC;AAED,qBAAa,gBAAiB,YAAW,YAAY;IACnD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8B;IACpD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAA2C;gBAE/D,IAAI,EAAE;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;KAC3D;IAMD,IAAI,IAAI,aAAa,CAAC,OAAO,CAAC;IAI9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAItC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAO7B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIxB,OAAO,CACX,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,WAAW,EACnB,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,OAAO,CAAC;CAyCpB"}

package/dist/registries/tools.js

@@ -0,0 +1,98 @@
+import { asToolCallId, asSessionId, asTurnId } from '@moxxy/sdk';
+export class ToolRegistryImpl {
+    tools = new Map();
+    defaultLogger;
+    defaultCwd;
+    /**
+     * Vault-backed secret resolver, when the host wires one. Surfaced to
+     * every tool handler as `ctx.getSecret(name)` so plugins can read an
+     * API key at call time without the value ever entering the model's
+     * context or `process.env`.
+     */
+    secretResolver;
+    constructor(opts) {
+        this.defaultLogger = opts.logger;
+        this.defaultCwd = opts.cwd;
+        this.secretResolver = opts.secretResolver;
+    }
+    list() {
+        return [...this.tools.values()];
+    }
+    get(name) {
+        return this.tools.get(name);
+    }
+    has(name) {
+        return this.tools.has(name);
+    }
+    register(tool) {
+        if (this.tools.has(tool.name)) {
+            throw new Error(`Tool already registered: ${tool.name}`);
+        }
+        this.tools.set(tool.name, tool);
+    }
+    unregister(name) {
+        this.tools.delete(name);
+    }
+    async execute(name, input, signal, opts = {}) {
+        const tool = this.tools.get(name);
+        if (!tool)
+            throw new Error(`Unknown tool: ${name}`);
+        // Use safeParse so a validation failure surfaces as a clean,
+        // single-line error in the tool_result instead of the raw ZodError
+        // (which JSON-stringifies into 20+ lines of red noise — observed
+        // with memory_save and synthesize_skill). The formatted message tells
+        // the model exactly which fields are off and why, so it can retry.
+        const parseResult = tool.inputSchema.safeParse(input);
+        if (!parseResult.success) {
+            throw new Error(`Invalid input for ${name}: ${formatZodIssues(parseResult.error)}`);
+        }
+        const parsed = parseResult.data;
+        const ctx = {
+            sessionId: asSessionId(opts.sessionId ?? 'no-session'),
+            turnId: asTurnId(opts.turnId ?? 'no-turn'),
+            callId: asToolCallId(opts.callId ?? 'no-call'),
+            cwd: opts.cwd ?? this.defaultCwd,
+            signal,
+            log: opts.log ?? emptyLog(),
+            logger: opts.logger ?? this.defaultLogger,
+            ...(opts.subagents ? { subagents: opts.subagents } : {}),
+            ...(this.secretResolver ? { getSecret: this.secretResolver } : {}),
+        };
+        const result = await tool.handler(parsed, ctx);
+        if (tool.outputSchema) {
+            // Mirror the input path: format an output-schema mismatch (a plugin bug)
+            // into the same single-line message instead of letting the raw 20-line
+            // ZodError surface, and name the offending tool + fields.
+            const outResult = tool.outputSchema.safeParse(result);
+            if (!outResult.success) {
+                throw new Error(`Tool ${name} produced invalid output: ${formatZodIssues(outResult.error)}`);
+            }
+            return outResult.data;
+        }
+        return result;
+    }
+}
+/**
+ * Format a ZodError's issues into a single-line, model-friendly string
+ * (`path: message; path: message`). Used by both input and output validation
+ * so the raw multi-line ZodError JSON noise never reaches the model.
+ */
+function formatZodIssues(error) {
+    return error.issues
+        .map((iss) => {
+        const path = iss.path.length ? iss.path.join('.') : '(root)';
+        return `${path}: ${iss.message}`;
+    })
+        .join('; ');
+}
+function emptyLog() {
+    return {
+        length: 0,
+        at: () => undefined,
+        slice: () => [],
+        ofType: () => [],
+        byTurn: () => [],
+        toJSON: () => [],
+    };
+}
+//# sourceMappingURL=tools.js.map

package/dist/registries/tools.js.map

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

package/dist/registries/transcribers.d.ts

@@ -0,0 +1,17 @@
+import type { Transcriber, TranscriberDef } from '@moxxy/sdk';
+import { ActiveBackendRegistry } from './active-backend-registry.js';
+/**
+ * Registry of speech-to-text backends:
+ *   - plugins call `register(def)` at load time
+ *   - the host/CLI calls `setActive(name, config)` once a backend is chosen
+ *   - channels with audio input read `getActive()` to transcribe bytes
+ *
+ * At most one transcriber is *active* at a time, selected explicitly (no
+ * auto-adopt). `getActive()` throws when none is active, so call sites can
+ * degrade gracefully (e.g. Telegram falls back to "you sent a voice note but no
+ * transcriber is configured").
+ */
+export declare class TranscriberRegistry extends ActiveBackendRegistry<TranscriberDef, Transcriber> {
+    constructor();
+}
+//# sourceMappingURL=transcribers.d.ts.map