@moxxy/core 0.3.0

package/dist/plugins/host.d.ts

@@ -0,0 +1,53 @@
+import type { MoxxyRequirement, Plugin, PluginHostHandle, RequirementCheck, RequirementIssue, ResolvedPluginManifest } from '@moxxy/sdk';
+import type { PluginHostOptions, PluginLoader } from './host-options.js';
+export type { PluginHostOptions, PluginLoader };
+export interface RegisterStaticOptions {
+    /**
+     * Static requirements to enforce before registration. Mirrors the
+     * `moxxy.requirements` field a discovered plugin's package.json would
+     * carry; passed explicitly here because statically-imported builtins
+     * don't go through `discoverPlugins()`.
+     */
+    readonly requirements?: ReadonlyArray<MoxxyRequirement>;
+}
+export type PluginSkipSource = 'static' | 'discovered';
+export type PluginSkipReason = 'unmet_requirements' | 'load_error';
+export interface PluginSkipRecord {
+    readonly pluginName: string;
+    readonly source: PluginSkipSource;
+    readonly reason: PluginSkipReason;
+    readonly message: string;
+    readonly packageName?: string;
+    readonly issues?: ReadonlyArray<RequirementIssue>;
+    readonly hints: ReadonlyArray<string>;
+}
+export declare class PluginRequirementError extends Error {
+    readonly pluginName: string;
+    readonly check: RequirementCheck;
+    constructor(pluginName: string, check: RequirementCheck);
+}
+export declare class PluginHost implements PluginHostHandle {
+    private readonly opts;
+    private readonly loaded;
+    private readonly skipped;
+    constructor(opts: PluginHostOptions);
+    list(): ReadonlyArray<{
+        name: string;
+        version: string;
+        loaded: boolean;
+        kinds: ReadonlyArray<string>;
+    }>;
+    listSkipped(): ReadonlyArray<PluginSkipRecord>;
+    registerStatic(plugin: Plugin, opts?: RegisterStaticOptions): void;
+    registerDiscovered(plugin: Plugin, manifest: ResolvedPluginManifest): void;
+    discoverAndLoad(extraPaths?: ReadonlyArray<string>): Promise<ReadonlyArray<Plugin>>;
+    unload(name: string): Promise<void>;
+    reload(): Promise<void>;
+    private applyPlugin;
+    private assertRequirementsReady;
+    private refreshDispatcher;
+    private recordRequirementSkip;
+    private recordLoadError;
+    private clearSkip;
+}
+//# sourceMappingURL=host.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/plugins/host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,MAAM,EACN,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AASpB,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACzE,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,CAAC;AAEhD,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;CACzD;AAED,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,YAAY,CAAC;AACvD,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,GAAG,YAAY,CAAC;AAEnE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAClD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACvC;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAE7C,QAAQ,CAAC,UAAU,EAAE,MAAM;IAC3B,QAAQ,CAAC,KAAK,EAAE,gBAAgB;gBADvB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,gBAAgB;CAUnC;AAOD,qBAAa,UAAW,YAAW,gBAAgB;IAIrC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;gBAElC,IAAI,EAAE,iBAAiB;IAEpD,IAAI,IAAI,aAAa,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,OAAO,CAAC;QAChB,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;KAC9B,CAAC;IASF,WAAW,IAAI,aAAa,CAAC,gBAAgB,CAAC;IAI9C,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,qBAA0B,GAAG,IAAI;IAYtE,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,sBAAsB,GAAG,IAAI;IA2BpE,eAAe,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAuDnF,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBnC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAyB7B,OAAO,CAAC,WAAW;IAuBnB,OAAO,CAAC,uBAAuB;IAc/B,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,qBAAqB;IAkB7B,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,SAAS;CAGlB"}

package/dist/plugins/host.js

@@ -0,0 +1,269 @@
+import { discoverPlugins } from './discovery.js';
+import { toposortPluginManifests, PluginCycleError } from './toposort.js';
+import { REGISTRY_KINDS } from './registry-kinds.js';
+export class PluginRequirementError extends Error {
+    pluginName;
+    check;
+    constructor(pluginName, check) {
+        super(check.issues
+            .filter((issue) => !issue.requirement.optional)
+            .map((issue) => issue.message)
+            .join('; '));
+        this.pluginName = pluginName;
+        this.check = check;
+        this.name = 'PluginRequirementError';
+    }
+}
+export class PluginHost {
+    opts;
+    loaded = new Map();
+    skipped = new Map();
+    constructor(opts) {
+        this.opts = opts;
+    }
+    list() {
+        return [...this.loaded.values()].map((r) => ({
+            name: r.plugin.name,
+            version: r.plugin.version,
+            loaded: true,
+            kinds: contributionKinds(r),
+        }));
+    }
+    listSkipped() {
+        return [...this.skipped.values()];
+    }
+    registerStatic(plugin, opts = {}) {
+        if (this.loaded.has(plugin.name)) {
+            throw new Error(`Plugin already registered: ${plugin.name}`);
+        }
+        this.assertRequirementsReady(plugin, opts.requirements, 'static');
+        const record = this.applyPlugin(plugin);
+        this.loaded.set(plugin.name, record);
+        this.clearSkip(plugin.name);
+        this.opts.requirements.registerPlugin(plugin.name, plugin.version);
+        this.refreshDispatcher();
+    }
+    registerDiscovered(plugin, manifest) {
+        // Key the loaded map by the PACKAGE name — not the plugin's declared
+        // `name` — so it lines up with `discoverAndLoad`'s dedupe check, `reload`'s
+        // `wanted` set, and `unload(packageName)` callers (self-update, config,
+        // plugins-admin). Keying by `plugin.name` silently broke all three whenever
+        // a plugin's declared name differed from its package name (re-load throws,
+        // reload unloads everything, unload no-ops).
+        if (this.loaded.has(manifest.packageName)) {
+            throw new Error(`Plugin already registered: ${manifest.packageName}`);
+        }
+        this.assertRequirementsReady(plugin, manifest.requirements, 'discovered', manifest);
+        const record = this.applyPlugin(plugin, manifest);
+        this.loaded.set(manifest.packageName, record);
+        this.clearSkip(plugin.name);
+        this.clearSkip(manifest.packageName);
+        // Register the requirement under the PACKAGE name, not the declared
+        // plugin.name. `kind:'plugin'` requirements are resolved by package name —
+        // toposort keys `byPackage` by `manifest.packageName`, so the readiness
+        // gate (`requirements.plugins.get(name)`) must agree. Keying by plugin.name
+        // here meant a dependent's `{kind:'plugin', name:<packageName>}` would pass
+        // toposort ordering but fail the readiness gate whenever a plugin's
+        // declared name differed from its package name (host.ts documents that they
+        // can differ).
+        this.opts.requirements.registerPlugin(manifest.packageName, plugin.version);
+        this.refreshDispatcher();
+    }
+    async discoverAndLoad(extraPaths) {
+        const manifests = await discoverPlugins({
+            cwd: this.opts.cwd,
+            logger: this.opts.logger,
+            extraPaths,
+        });
+        const loaded = [];
+        const loader = this.opts.loader;
+        if (!loader) {
+            this.opts.logger.warn('PluginHost.discoverAndLoad called without a loader; static plugins only. Provide a loader (e.g. jiti loader) to enable dynamic discovery.');
+            return loaded;
+        }
+        let ordered;
+        try {
+            ordered = toposortPluginManifests(manifests);
+        }
+        catch (err) {
+            if (err instanceof PluginCycleError) {
+                this.opts.logger.warn('PluginHost: requirement cycle, falling back to unsorted order', {
+                    cycle: err.cycle,
+                });
+                ordered = manifests;
+            }
+            else {
+                throw err;
+            }
+        }
+        for (const manifest of ordered) {
+            if (this.loaded.has(manifest.packageName))
+                continue;
+            // Honor a runtime/config disable: never load a package the user turned off.
+            if (this.opts.isDisabled?.(manifest.packageName))
+                continue;
+            try {
+                const plugin = await loader.load(manifest);
+                this.registerDiscovered(plugin, manifest);
+                loaded.push(plugin);
+            }
+            catch (err) {
+                if (err instanceof PluginRequirementError) {
+                    this.opts.logger.warn('PluginHost: skipped plugin due to unmet requirements', {
+                        package: manifest.packageName,
+                        plugin: err.pluginName,
+                        err: err.message,
+                    });
+                    continue;
+                }
+                this.recordLoadError(manifest.packageName, 'discovered', manifest.packageName, err);
+                this.opts.logger.warn('PluginHost: failed to load plugin', {
+                    package: manifest.packageName,
+                    err: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+        this.refreshDispatcher();
+        return loaded;
+    }
+    async unload(name) {
+        const record = this.loaded.get(name);
+        if (!record)
+            return;
+        // Iterate REGISTRY_KINDS in its declared order — the exact set + order the
+        // original hand-written unregister sequence used — so register/unregister
+        // stay in lockstep and a new kind is one table entry, not edits here.
+        for (const kind of REGISTRY_KINDS) {
+            for (const recordedName of record[kind.recordField])
+                kind.unregister(this.opts, recordedName);
+        }
+        this.loaded.delete(name);
+        // Unregister under the SAME key registration used: package name for
+        // discovered plugins (see registerDiscovered), declared name for statics.
+        this.opts.requirements.unregisterPlugin(record.manifest?.packageName ?? record.plugin.name);
+        this.refreshDispatcher();
+    }
+    async reload() {
+        this.opts.logger.info('PluginHost.reload(): rescanning plugins');
+        // Reuse the same discovery roots the initial load used (incl. the user
+        // plugin dirs) for BOTH the "wanted" scan and the re-load. Omitting them
+        // would mark user plugins as not-wanted (→ unloaded) and never re-add them.
+        const manifests = await discoverPlugins({
+            cwd: this.opts.cwd,
+            logger: this.opts.logger,
+            ...(this.opts.userPaths ? { extraPaths: this.opts.userPaths } : {}),
+        });
+        // A disabled package is excluded from `wanted`, so the loop below unloads it
+        // if currently loaded and discoverAndLoad won't bring it back.
+        const wanted = new Set(manifests
+            .filter((m) => !this.opts.isDisabled?.(m.packageName))
+            .map((m) => m.packageName));
+        for (const [name] of [...this.loaded]) {
+            // Statically-registered builtins have no manifest; never unload them on
+            // reload — they aren't discovered from disk so they'd never come back.
+            if (this.loaded.get(name)?.manifest && !wanted.has(name))
+                await this.unload(name);
+        }
+        await this.discoverAndLoad(this.opts.userPaths);
+    }
+    applyPlugin(plugin, manifest) {
+        // Snapshot the contributed names BEFORE registering (same as the original
+        // two-phase order), keyed by REGISTRY_KINDS field. Building the names from
+        // the same table the registration loop uses keeps the two in lockstep.
+        const names = {};
+        for (const kind of REGISTRY_KINDS) {
+            names[kind.recordField] = kind.defs(plugin).map((def) => kind.nameOf(def));
+        }
+        // Register in REGISTRY_KINDS order — the exact set + order the original
+        // hand-written register sequence used (incl. viewRenderers/tunnelProviders
+        // via `replace`).
+        for (const kind of REGISTRY_KINDS) {
+            for (const def of kind.defs(plugin))
+                kind.register(this.opts, def);
+        }
+        return {
+            plugin,
+            manifest,
+            ...names,
+        };
+    }
+    assertRequirementsReady(plugin, requirements, source = 'static', manifest) {
+        if (!requirements || requirements.length === 0)
+            return;
+        const check = this.opts.requirements.check(requirements);
+        if (!check.ready) {
+            this.recordRequirementSkip(plugin, source, manifest, check);
+            throw new PluginRequirementError(plugin.name, check);
+        }
+    }
+    refreshDispatcher() {
+        this.opts.dispatcher.setPlugins([...this.loaded.values()].map((r) => r.plugin));
+    }
+    recordRequirementSkip(plugin, source, manifest, check) {
+        const blocking = check.issues.filter((issue) => !issue.requirement.optional);
+        this.skipped.set(skipKey(plugin.name), {
+            pluginName: plugin.name,
+            source,
+            reason: 'unmet_requirements',
+            message: blocking.map((issue) => issue.message).join('; '),
+            ...(manifest ? { packageName: manifest.packageName } : {}),
+            issues: check.issues,
+            hints: blocking.flatMap((issue) => issue.hint ? [issue.hint] : []),
+        });
+    }
+    recordLoadError(pluginName, source, packageName, err) {
+        this.skipped.set(skipKey(pluginName), {
+            pluginName,
+            source,
+            reason: 'load_error',
+            message: err instanceof Error ? err.message : String(err),
+            ...(packageName ? { packageName } : {}),
+            hints: [],
+        });
+    }
+    clearSkip(pluginName) {
+        this.skipped.delete(skipKey(pluginName));
+    }
+}
+function skipKey(pluginName) {
+    return pluginName;
+}
+/** The contribution categories a loaded plugin actually registered, in a
+ *  stable order — lets a UI group plugins by kind (tabs in the picker). */
+function contributionKinds(r) {
+    const kinds = [];
+    if (r.providerNames.length)
+        kinds.push('provider');
+    if (r.modeNames.length)
+        kinds.push('mode');
+    if (r.channelNames.length)
+        kinds.push('channel');
+    if (r.surfaceNames.length)
+        kinds.push('surface');
+    if (r.embedderNames.length)
+        kinds.push('embedder');
+    if (r.transcriberNames.length)
+        kinds.push('transcriber');
+    if (r.synthesizerNames.length)
+        kinds.push('synthesizer');
+    if (r.isolatorNames.length)
+        kinds.push('isolator');
+    if (r.compactorNames.length)
+        kinds.push('compactor');
+    if (r.cacheStrategyNames.length)
+        kinds.push('cacheStrategy');
+    if (r.viewRendererNames.length)
+        kinds.push('viewRenderer');
+    if (r.tunnelProviderNames.length)
+        kinds.push('tunnelProvider');
+    if (r.workflowExecutorNames.length)
+        kinds.push('workflowExecutor');
+    if (r.agentNames.length)
+        kinds.push('agent');
+    if (r.commandNames.length)
+        kinds.push('command');
+    if (r.toolNames.length)
+        kinds.push('tool');
+    return kinds;
+}
+//# sourceMappingURL=host.js.map

package/dist/plugins/host.js.map

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

package/dist/plugins/lifecycle.d.ts

@@ -0,0 +1,31 @@
+import type { AppContext, HookDispatcher, LifecycleHooks, MoxxyEvent, Plugin, ProviderRequest, ToolCallContext, ToolCallVerdict, ToolResultContext, ToolResultEvent, TurnContext } from '@moxxy/sdk';
+import type { Logger } from '../logger.js';
+export interface DispatcherOptions {
+    readonly hookTimeoutMs?: number;
+    readonly logger: Logger;
+    readonly onHookFailed?: (err: Error, plugin: string, hook: keyof LifecycleHooks) => void;
+}
+export declare class HookDispatcherImpl implements HookDispatcher {
+    private entries;
+    private readonly timeoutMs;
+    private readonly logger;
+    private readonly onHookFailed?;
+    constructor(opts: DispatcherOptions);
+    setPlugins(plugins: ReadonlyArray<Plugin>): void;
+    /**
+     * Whether any registered plugin declares an `onEvent` hook. Lets the
+     * per-event fan-out skip building an AppContext (which clones the whole
+     * `process.env`) when no plugin would consume it — the common case.
+     */
+    hasEventHooks(): boolean;
+    dispatchInit(ctx: AppContext): Promise<void>;
+    dispatchTurnStart(ctx: TurnContext): Promise<void>;
+    dispatchBeforeProviderCall(req: ProviderRequest, ctx: TurnContext): Promise<ProviderRequest>;
+    dispatchToolCall(ctx: ToolCallContext): Promise<ToolCallVerdict>;
+    dispatchToolResult(ctx: ToolResultContext): Promise<ToolResultEvent>;
+    dispatchEvent(event: MoxxyEvent, ctx: AppContext): Promise<void>;
+    dispatchTurnEnd(ctx: TurnContext): Promise<void>;
+    dispatchShutdown(ctx: AppContext): Promise<void>;
+    private safe;
+}
+//# sourceMappingURL=lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/plugins/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,MAAM,EACN,eAAe,EACf,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,WAAW,EACZ,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,cAAc,KAAK,IAAI,CAAC;CAC1F;AAOD,qBAAa,kBAAmB,YAAW,cAAc;IACvD,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAoC;gBAEtD,IAAI,EAAE,iBAAiB;IAMnC,UAAU,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI;IAIhD;;;;OAIG;IACH,aAAa,IAAI,OAAO;IAIlB,YAAY,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C,iBAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD,0BAA0B,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;IAW5F,gBAAgB,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAWhE,kBAAkB,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;IAWpE,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhE,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD,gBAAgB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;YAIxC,IAAI;CA6BnB"}

package/dist/plugins/lifecycle.js

@@ -0,0 +1,100 @@
+export class HookDispatcherImpl {
+    entries = [];
+    timeoutMs;
+    logger;
+    onHookFailed;
+    constructor(opts) {
+        this.timeoutMs = opts.hookTimeoutMs ?? 5_000;
+        this.logger = opts.logger;
+        this.onHookFailed = opts.onHookFailed;
+    }
+    setPlugins(plugins) {
+        this.entries = plugins.map((plugin) => ({ plugin, hooks: plugin.hooks ?? {} }));
+    }
+    /**
+     * Whether any registered plugin declares an `onEvent` hook. Lets the
+     * per-event fan-out skip building an AppContext (which clones the whole
+     * `process.env`) when no plugin would consume it — the common case.
+     */
+    hasEventHooks() {
+        return this.entries.some((e) => typeof e.hooks.onEvent === 'function');
+    }
+    async dispatchInit(ctx) {
+        for (const e of this.entries)
+            await this.safe(e, 'onInit', () => e.hooks.onInit?.(ctx));
+    }
+    async dispatchTurnStart(ctx) {
+        for (const e of this.entries)
+            await this.safe(e, 'onTurnStart', () => e.hooks.onTurnStart?.(ctx));
+    }
+    async dispatchBeforeProviderCall(req, ctx) {
+        let current = req;
+        for (const e of this.entries) {
+            const next = await this.safe(e, 'onBeforeProviderCall', () => e.hooks.onBeforeProviderCall?.(current, ctx));
+            if (next)
+                current = next;
+        }
+        return current;
+    }
+    async dispatchToolCall(ctx) {
+        let verdict = { action: 'allow' };
+        for (const e of this.entries) {
+            const next = await this.safe(e, 'onToolCall', () => e.hooks.onToolCall?.(ctx));
+            if (!next)
+                continue;
+            if (next.action === 'deny')
+                return next;
+            if (next.action === 'rewrite')
+                verdict = next;
+        }
+        return verdict;
+    }
+    async dispatchToolResult(ctx) {
+        let result = ctx.result;
+        for (const e of this.entries) {
+            const next = await this.safe(e, 'onToolResult', () => e.hooks.onToolResult?.({ ...ctx, result }));
+            if (next)
+                result = next;
+        }
+        return result;
+    }
+    async dispatchEvent(event, ctx) {
+        for (const e of this.entries) {
+            await this.safe(e, 'onEvent', () => e.hooks.onEvent?.(event, ctx));
+        }
+    }
+    async dispatchTurnEnd(ctx) {
+        for (const e of this.entries)
+            await this.safe(e, 'onTurnEnd', () => e.hooks.onTurnEnd?.(ctx));
+    }
+    async dispatchShutdown(ctx) {
+        for (const e of this.entries)
+            await this.safe(e, 'onShutdown', () => e.hooks.onShutdown?.(ctx));
+    }
+    async safe(entry, hook, fn) {
+        let timer;
+        try {
+            const p = Promise.resolve(fn());
+            const timeout = new Promise((_, reject) => {
+                timer = setTimeout(() => reject(new Error(`Hook ${hook} on ${entry.plugin.name} timed out`)), this.timeoutMs);
+            });
+            // Attach a no-op rejection handler to the timeout promise so if the
+            // fast path wins, the timer's eventual rejection is swallowed
+            // silently rather than surfacing as an unhandled rejection.
+            timeout.catch(() => undefined);
+            const winner = await Promise.race([p, timeout]);
+            return winner;
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            this.logger.warn('hook failed', { plugin: entry.plugin.name, hook, err: error.message });
+            this.onHookFailed?.(error, entry.plugin.name, hook);
+            return undefined;
+        }
+        finally {
+            if (timer !== undefined)
+                clearTimeout(timer);
+        }
+    }
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/plugins/lifecycle.js.map

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

package/dist/plugins/loader.d.ts

@@ -0,0 +1,7 @@
+import type { PluginLoader } from './host.js';
+export interface JitiLoaderOptions {
+    readonly cwd: string;
+    readonly cacheBust?: () => string;
+}
+export declare function createPluginLoader(opts: JitiLoaderOptions): PluginLoader;
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/plugins/loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;CACnC;AAiBD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,YAAY,CAqCxE"}

package/dist/plugins/loader.js

@@ -0,0 +1,68 @@
+import * as path from 'node:path';
+import { pathToFileURL } from 'node:url';
+let jitiInstance = null;
+async function getJiti(cwd) {
+    if (jitiInstance)
+        return jitiInstance;
+    try {
+        const mod = await import('jiti');
+        const factory = mod.createJiti ?? mod.default;
+        if (!factory)
+            return null;
+        jitiInstance = factory(cwd, { interopDefault: true });
+        return jitiInstance;
+    }
+    catch {
+        return null;
+    }
+}
+export function createPluginLoader(opts) {
+    return {
+        async load(manifest) {
+            const entry = path.resolve(manifest.packagePath, manifest.entry);
+            const isTs = entry.endsWith('.ts') || entry.endsWith('.tsx');
+            let mod;
+            if (isTs) {
+                const jiti = await getJiti(opts.cwd);
+                if (!jiti) {
+                    throw new Error(`Cannot load .ts plugin entry without jiti: ${entry}. Install 'jiti' as a dependency.`);
+                }
+                mod = jiti(entry);
+            }
+            else {
+                const bust = opts.cacheBust?.() ?? `${Date.now()}-${Math.random()}`;
+                const url = `${pathToFileURL(entry).href}?v=${bust}`;
+                mod = await import(url);
+            }
+            const plugin = extractPlugin(mod);
+            if (!plugin) {
+                throw new Error(`Plugin entry did not export a valid Plugin (default export with __moxxy === 'plugin'): ${entry}`);
+            }
+            // The runtime-reported version is the package.json version — the single
+            // source of truth. Plugin authors hardcode a placeholder `version` in
+            // definePlugin (commonly '0.0.0'), so stamp the manifest's packageVersion
+            // here; otherwise `moxxy plugins list` and PluginRegisteredEvent lie.
+            if (manifest.packageVersion && plugin.version !== manifest.packageVersion) {
+                return Object.freeze({ ...plugin, version: manifest.packageVersion });
+            }
+            return plugin;
+        },
+    };
+}
+function extractPlugin(mod) {
+    if (!mod || typeof mod !== 'object')
+        return null;
+    const candidates = [
+        mod.default,
+        mod.default?.default,
+        mod,
+        mod.plugin,
+    ];
+    for (const c of candidates) {
+        if (c && typeof c === 'object' && c.__moxxy === 'plugin') {
+            return c;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=loader.js.map

package/dist/plugins/loader.js.map

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

package/dist/plugins/package-requirements.d.ts

@@ -0,0 +1,16 @@
+import { type MoxxyRequirement } from '@moxxy/sdk';
+/**
+ * Read `moxxy.requirements` from a package's `package.json`, resolved by
+ * name from the given working directory. Returns an empty array when:
+ *   - the package can't be resolved (not installed in the cwd's resolution path)
+ *   - the package has no `moxxy` block
+ *   - the `moxxy` block exists but declares no requirements
+ *   - the `moxxy` block fails schema validation
+ *
+ * Errors are deliberately swallowed because this is used during boot
+ * for every static builtin: a missing or malformed package.json on one
+ * builtin shouldn't crash the CLI. The plugin host's registration gate
+ * still rejects plugins whose declared requirements aren't satisfied.
+ */
+export declare function readPackageMoxxyRequirements(packageName: string, fromDir: string): Promise<ReadonlyArray<MoxxyRequirement>>;
+//# sourceMappingURL=package-requirements.d.ts.map

package/dist/plugins/package-requirements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-requirements.d.ts","sourceRoot":"","sources":["../../src/plugins/package-requirements.ts"],"names":[],"mappings":"AAEA,OAAO,EAAsB,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEvE;;;;;;;;;;;;GAYG;AACH,wBAAsB,4BAA4B,CAChD,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC,CAoB1C"}

package/dist/plugins/package-requirements.js

@@ -0,0 +1,52 @@
+import { createRequire } from 'node:module';
+import { promises as fs } from 'node:fs';
+import { moxxyPackageSchema } from '@moxxy/sdk';
+/**
+ * Read `moxxy.requirements` from a package's `package.json`, resolved by
+ * name from the given working directory. Returns an empty array when:
+ *   - the package can't be resolved (not installed in the cwd's resolution path)
+ *   - the package has no `moxxy` block
+ *   - the `moxxy` block exists but declares no requirements
+ *   - the `moxxy` block fails schema validation
+ *
+ * Errors are deliberately swallowed because this is used during boot
+ * for every static builtin: a missing or malformed package.json on one
+ * builtin shouldn't crash the CLI. The plugin host's registration gate
+ * still rejects plugins whose declared requirements aren't satisfied.
+ */
+export async function readPackageMoxxyRequirements(packageName, fromDir) {
+    const pkgJsonPath = resolvePackageJson(packageName, fromDir);
+    if (!pkgJsonPath)
+        return [];
+    let raw;
+    try {
+        raw = await fs.readFile(pkgJsonPath, 'utf8');
+    }
+    catch {
+        return [];
+    }
+    let parsedJson;
+    try {
+        parsedJson = JSON.parse(raw);
+    }
+    catch {
+        return [];
+    }
+    const moxxyBlock = parsedJson.moxxy;
+    if (!moxxyBlock)
+        return [];
+    const parsed = moxxyPackageSchema.safeParse(moxxyBlock);
+    if (!parsed.success)
+        return [];
+    return parsed.data.requirements ?? [];
+}
+function resolvePackageJson(packageName, fromDir) {
+    const require_ = createRequire(`${fromDir.replace(/\/+$/, '')}/`);
+    try {
+        return require_.resolve(`${packageName}/package.json`);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=package-requirements.js.map