@sadhaka/loom-engine 0.13.0 → 0.14.0

package/dist/director/ai/ai-plugin-registry.d.ts

@@ -0,0 +1,20 @@
+import type { IAIPlugin, EmittedEvents, PluginContext, PeerInfo, PlayerAction } from './plugin.js';
+export declare class AIPluginDuplicateError extends Error {
+    readonly pluginName: string;
+    constructor(pluginName: string);
+}
+export declare class AIPluginRegistry {
+    private plugins;
+    register(plugin: IAIPlugin): void;
+    unregister(name: string): Promise<boolean>;
+    list(): ReadonlyArray<IAIPlugin>;
+    get(name: string): IAIPlugin | undefined;
+    dispatchTick(ctx: PluginContext): Promise<EmittedEvents>;
+    dispatchPeerJoin(ctx: PluginContext, peer: PeerInfo): Promise<EmittedEvents>;
+    dispatchPeerLeave(ctx: PluginContext, peer: PeerInfo): Promise<EmittedEvents>;
+    dispatchZoneEnter(ctx: PluginContext, peer: PeerInfo, fromZone: string | null): Promise<EmittedEvents>;
+    dispatchPlayerAction(ctx: PluginContext, peer: PeerInfo, action: PlayerAction): Promise<EmittedEvents>;
+    private dispatch;
+    private errorMeta;
+}
+//# sourceMappingURL=ai-plugin-registry.d.ts.map

package/dist/director/ai/ai-plugin-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-plugin-registry.d.ts","sourceRoot":"","sources":["../../../src/director/ai/ai-plugin-registry.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EACb,aAAa,EACb,QAAQ,EACR,YAAY,EACb,MAAM,aAAa,CAAC;AAErB,qBAAa,sBAAuB,SAAQ,KAAK;aACnB,UAAU,EAAE,MAAM;gBAAlB,UAAU,EAAE,MAAM;CAI/C;AAED,qBAAa,gBAAgB;IAK3B,OAAO,CAAC,OAAO,CAAmB;IAOlC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IA0B3B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA8BhD,IAAI,IAAI,aAAa,CAAC,SAAS,CAAC;IAMhC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAgBlC,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAMxD,gBAAgB,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC;IAM5E,iBAAiB,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC;IAM7E,iBAAiB,CACrB,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,MAAM,GAAG,IAAI,GACtB,OAAO,CAAC,aAAa,CAAC;IAMnB,oBAAoB,CACxB,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,aAAa,CAAC;YAYX,QAAQ;IAiEtB,OAAO,CAAC,SAAS;CAgBlB"}

package/dist/director/ai/ai-plugin-registry.js

@@ -0,0 +1,232 @@
+// AIPluginRegistry - dispatches lifecycle hooks across registered plugins.
+//
+// Per LOOM-DIRECTOR-PROTOCOL-V2 Section 5.3: the registry holds N
+// plugins, dispatches each hook in priority order (lower runs first),
+// and concatenates the EmittedEvents from every plugin into a single
+// merged result. The caller (the engine's emit path / TWT's loom_director
+// orchestrator) takes the merged events and routes them - character
+// events to the v1 stream, zone events to the v2 zone log + presence
+// fanout.
+//
+// Error isolation guarantee (open question 8.3): if a plugin's hook
+// throws synchronously OR the returned Promise rejects, the registry
+// logs the failure via that plugin's logger, drops that plugin's
+// contribution for THIS dispatch only, and continues with the next
+// plugin. The dispatch never throws to the caller. Plugin authors
+// remain responsible for their own internal try/catch; the registry
+// is the safety net of last resort.
+//
+// Implementation notes:
+//   - Plugins are kept in a sorted array; register/unregister keep
+//     it sorted so the dispatch hot path is a simple iteration.
+//   - The registry never instantiates a PluginContext; the caller
+//     supplies one per dispatch (or reuses one and refreshes views).
+//     This keeps the registry decoupled from world-state plumbing.
+//   - dispose() is awaited inside unregister() so plugins can flush
+//     pending work; if dispose throws we log and continue (drop
+//     guarantee extends to dispose so the caller never sees plugin
+//     errors leak).
+export class AIPluginDuplicateError extends Error {
+    pluginName;
+    constructor(pluginName) {
+        super('AIPluginDuplicateError: plugin already registered: ' + pluginName);
+        this.pluginName = pluginName;
+        this.name = 'AIPluginDuplicateError';
+    }
+}
+export class AIPluginRegistry {
+    // Sorted by priority ascending, then by registration order. The
+    // registration index is encoded by inserting at the right position
+    // on register() rather than re-sorting, which preserves stable
+    // ordering for equal priorities.
+    plugins = [];
+    // ----- Lifecycle -----
+    // Register a plugin. Throws AIPluginDuplicateError if a plugin with
+    // the same name is already registered (names are the registry key).
+    // Insertion is O(n) but n is small (typically 1-10 plugins).
+    register(plugin) {
+        for (var i = 0; i < this.plugins.length; i++) {
+            var existing = this.plugins[i];
+            if (existing && existing.name === plugin.name) {
+                throw new AIPluginDuplicateError(plugin.name);
+            }
+        }
+        // Find the first plugin with strictly higher priority and insert
+        // before it. This preserves stable ordering for equal priorities
+        // (a later-registered plugin runs after an earlier one with the
+        // same priority).
+        var insertAt = this.plugins.length;
+        for (var j = 0; j < this.plugins.length; j++) {
+            var p = this.plugins[j];
+            if (p && p.priority > plugin.priority) {
+                insertAt = j;
+                break;
+            }
+        }
+        this.plugins.splice(insertAt, 0, plugin);
+    }
+    // Unregister a plugin by name. Awaits the plugin's dispose() if
+    // present; logs and drops if dispose throws. Returns true if a
+    // plugin was removed, false if no plugin with that name was
+    // registered.
+    async unregister(name) {
+        var idx = -1;
+        for (var i = 0; i < this.plugins.length; i++) {
+            var p = this.plugins[i];
+            if (p && p.name === name) {
+                idx = i;
+                break;
+            }
+        }
+        if (idx === -1)
+            return false;
+        var plugin = this.plugins[idx];
+        this.plugins.splice(idx, 1);
+        if (plugin && typeof plugin.dispose === 'function') {
+            try {
+                await plugin.dispose();
+            }
+            catch (err) {
+                // Drop guarantee extends to dispose. We can't log via the
+                // plugin's logger because we have no PluginContext here;
+                // fall back to console with the plugin name tag.
+                console.error('[plugin: ' + plugin.name + '] dispose() threw', this.errorMeta(err));
+            }
+        }
+        return true;
+    }
+    // Read-only snapshot of the plugin list, in dispatch order. Returns
+    // a fresh array; mutating it does not affect the registry.
+    list() {
+        return this.plugins.slice();
+    }
+    // Look up a plugin by name. Returns undefined if no plugin with
+    // that name is registered.
+    get(name) {
+        for (var i = 0; i < this.plugins.length; i++) {
+            var p = this.plugins[i];
+            if (p && p.name === name)
+                return p;
+        }
+        return undefined;
+    }
+    // ----- Dispatchers -----
+    // All five dispatchers share the same shape: iterate plugins in
+    // priority order, call the hook if defined, await the result, merge
+    // into the running EmittedEvents. Errors are caught per-plugin and
+    // logged via the plugin's logger if reachable through ctx; never
+    // thrown to the caller.
+    async dispatchTick(ctx) {
+        return this.dispatch(ctx, 'onTick', function (plugin, ctx) {
+            return plugin.onTick(ctx);
+        });
+    }
+    async dispatchPeerJoin(ctx, peer) {
+        return this.dispatch(ctx, 'onPeerJoin', function (plugin, ctx) {
+            return plugin.onPeerJoin(ctx, peer);
+        });
+    }
+    async dispatchPeerLeave(ctx, peer) {
+        return this.dispatch(ctx, 'onPeerLeave', function (plugin, ctx) {
+            return plugin.onPeerLeave(ctx, peer);
+        });
+    }
+    async dispatchZoneEnter(ctx, peer, fromZone) {
+        return this.dispatch(ctx, 'onZoneEnter', function (plugin, ctx) {
+            return plugin.onZoneEnter(ctx, peer, fromZone);
+        });
+    }
+    async dispatchPlayerAction(ctx, peer, action) {
+        return this.dispatch(ctx, 'onPlayerAction', function (plugin, ctx) {
+            return plugin.onPlayerAction(ctx, peer, action);
+        });
+    }
+    // ----- Internals -----
+    // Generic dispatch helper. `hookName` is the property name we check
+    // for definition on each plugin; `invoke` calls the actual hook
+    // (the spread of args differs per dispatcher). Per-plugin try/catch
+    // around the await isolates failures.
+    async dispatch(ctx, hookName, invoke) {
+        var merged = {};
+        var characterEvents = undefined;
+        var zoneEvents = undefined;
+        // Snapshot the plugin list at dispatch start so a mutation during
+        // the dispatch (a hook calls registry.register/unregister) cannot
+        // change which plugins run for THIS dispatch. Spec doesn't forbid
+        // mutation but the predictable behavior is "this dispatch sees
+        // the registry as it was at start".
+        var snapshot = this.plugins.slice();
+        for (var i = 0; i < snapshot.length; i++) {
+            var plugin = snapshot[i];
+            if (!plugin)
+                continue;
+            // Hook not implemented by this plugin? Skip without allocating
+            // anything. Use bracket access so the keyof typing carries through.
+            var hook = plugin[hookName];
+            if (typeof hook !== 'function')
+                continue;
+            var emitted;
+            try {
+                emitted = await invoke(plugin, ctx);
+            }
+            catch (err) {
+                // Log via the plugin's logger so the failure is tagged with
+                // the plugin name. ctx.logger may itself throw; if so, fall
+                // back to console (cannot let logger errors break dispatch).
+                try {
+                    ctx.logger.error('plugin hook ' + String(hookName) + ' threw', this.errorMeta(err));
+                }
+                catch {
+                    console.error('[plugin: ' + plugin.name + '] hook ' + String(hookName) + ' threw', this.errorMeta(err));
+                }
+                // Drop this plugin's contribution for this dispatch.
+                continue;
+            }
+            if (!emitted)
+                continue;
+            if (emitted.characterEvents && emitted.characterEvents.length > 0) {
+                if (!characterEvents)
+                    characterEvents = [];
+                for (var ci = 0; ci < emitted.characterEvents.length; ci++) {
+                    var ce = emitted.characterEvents[ci];
+                    if (ce)
+                        characterEvents.push(ce);
+                }
+            }
+            if (emitted.zoneEvents && emitted.zoneEvents.length > 0) {
+                if (!zoneEvents)
+                    zoneEvents = [];
+                for (var zi = 0; zi < emitted.zoneEvents.length; zi++) {
+                    var ze = emitted.zoneEvents[zi];
+                    if (ze)
+                        zoneEvents.push(ze);
+                }
+            }
+        }
+        if (characterEvents)
+            merged.characterEvents = characterEvents;
+        if (zoneEvents)
+            merged.zoneEvents = zoneEvents;
+        return merged;
+    }
+    // Pull useful fields out of an unknown error for log meta. Avoids
+    // throwing on non-Error throws (strings, objects, undefined).
+    errorMeta(err) {
+        if (err instanceof Error) {
+            return {
+                error_name: err.name,
+                error_message: err.message,
+                error_stack: err.stack ?? null,
+            };
+        }
+        var safe;
+        try {
+            safe = JSON.stringify(err);
+        }
+        catch {
+            safe = String(err);
+        }
+        return { error: safe };
+    }
+}
+//# sourceMappingURL=ai-plugin-registry.js.map

package/dist/director/ai/ai-plugin-registry.js.map

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

package/dist/director/ai/mock-ai-plugin.d.ts

@@ -0,0 +1,24 @@
+import type { DirectorEvent } from '../event-envelope.js';
+import type { IAIPlugin, EmittedEvents, PluginContext, ZoneEvent } from './plugin.js';
+export interface MockAIPluginScriptEntry {
+    atTick: number;
+    characterEvents?: DirectorEvent[];
+    zoneEvents?: ZoneEvent[];
+}
+export interface MockAIPluginOptions {
+    name?: string;
+    script: ReadonlyArray<MockAIPluginScriptEntry>;
+    priority?: number;
+}
+export declare class MockAIPlugin implements IAIPlugin {
+    readonly name: string;
+    readonly version = "0.0.1";
+    readonly priority: number;
+    private readonly script;
+    private tick;
+    constructor(opts: MockAIPluginOptions);
+    onTick(_ctx: PluginContext): Promise<EmittedEvents>;
+    currentTick(): number;
+    resetTick(): void;
+}
+//# sourceMappingURL=mock-ai-plugin.d.ts.map

package/dist/director/ai/mock-ai-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-ai-plugin.d.ts","sourceRoot":"","sources":["../../../src/director/ai/mock-ai-plugin.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EACb,aAAa,EACb,SAAS,EACV,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,uBAAuB;IAGtC,MAAM,EAAE,MAAM,CAAC;IAEf,eAAe,CAAC,EAAE,aAAa,EAAE,CAAC;IAElC,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAIlC,IAAI,CAAC,EAAE,MAAM,CAAC;IAId,MAAM,EAAE,aAAa,CAAC,uBAAuB,CAAC,CAAC;IAE/C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,YAAa,YAAW,SAAS;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;IAIhE,OAAO,CAAC,IAAI,CAAK;gBAEL,IAAI,EAAE,mBAAmB;IAM/B,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IA+BzD,WAAW,IAAI,MAAM;IAOrB,SAAS,IAAI,IAAI;CAGlB"}

package/dist/director/ai/mock-ai-plugin.js

@@ -0,0 +1,83 @@
+// MockAIPlugin - deterministic synthetic events for tests + offline demo.
+//
+// Per LOOM-DIRECTOR-PROTOCOL-V2 Section 5.4: replaces real LLM
+// dispatch with a scripted sequence of events keyed by tick number.
+// Engine tests can wire this in place of an Anthropic-backed plugin
+// to verify registry behavior, dispatch order, and downstream emit
+// paths without burning API budget. The offline demo can use it to
+// drive a showcase loop with predictable events.
+//
+// Determinism: the script is consulted on each onTick() call. The
+// plugin keeps an internal tick counter that increments every call;
+// the constructor's `tickKey` option lets the caller provide a
+// counter source instead (e.g. tying it to the engine's frame index
+// for cross-process consistency).
+//
+// Multiple instances: the constructor accepts an optional `name`
+// override so a test can register two MockAIPlugins with different
+// scripts. Without override, the name is 'mock' and registering two
+// instances throws AIPluginDuplicateError (intentional - the spec
+// keys plugins by name).
+export class MockAIPlugin {
+    name;
+    version = '0.0.1';
+    priority;
+    script;
+    // Current tick count; increments every onTick() call. The first
+    // tick observed is 1 (matches the typical engine convention where
+    // tick 0 is "before-first-update").
+    tick = 0;
+    constructor(opts) {
+        this.name = opts.name ?? 'mock';
+        this.priority = opts.priority ?? 999;
+        this.script = opts.script;
+    }
+    async onTick(_ctx) {
+        this.tick++;
+        var characterEvents;
+        var zoneEvents;
+        for (var i = 0; i < this.script.length; i++) {
+            var entry = this.script[i];
+            if (!entry)
+                continue;
+            if (entry.atTick !== this.tick)
+                continue;
+            if (entry.characterEvents && entry.characterEvents.length > 0) {
+                if (!characterEvents)
+                    characterEvents = [];
+                for (var ci = 0; ci < entry.characterEvents.length; ci++) {
+                    var ce = entry.characterEvents[ci];
+                    if (ce)
+                        characterEvents.push(ce);
+                }
+            }
+            if (entry.zoneEvents && entry.zoneEvents.length > 0) {
+                if (!zoneEvents)
+                    zoneEvents = [];
+                for (var zi = 0; zi < entry.zoneEvents.length; zi++) {
+                    var ze = entry.zoneEvents[zi];
+                    if (ze)
+                        zoneEvents.push(ze);
+                }
+            }
+        }
+        var emitted = {};
+        if (characterEvents)
+            emitted.characterEvents = characterEvents;
+        if (zoneEvents)
+            emitted.zoneEvents = zoneEvents;
+        return emitted;
+    }
+    // Inspect-only: current tick count. Useful in tests to assert the
+    // plugin saw the expected number of dispatches.
+    currentTick() {
+        return this.tick;
+    }
+    // Reset the tick counter to 0 so the script can replay from the
+    // start. Tests that re-use a single plugin across multiple cases
+    // call this between cases.
+    resetTick() {
+        this.tick = 0;
+    }
+}
+//# sourceMappingURL=mock-ai-plugin.js.map

package/dist/director/ai/mock-ai-plugin.js.map

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

package/dist/director/ai/plugin-context.d.ts

@@ -0,0 +1,27 @@
+import type { PluginContext, PluginLogger, PluginStorage, PeerInfo, CharacterState } from './plugin.js';
+export declare class MapPluginStorage {
+    private readonly store;
+    forPlugin(pluginName: string): PluginStorage;
+    clearPlugin(pluginName: string): void;
+    size(): number;
+    private composeKey;
+}
+export declare class ConsolePluginLogger implements PluginLogger {
+    private readonly pluginName;
+    constructor(pluginName: string);
+    info(msg: string, meta?: Record<string, unknown>): void;
+    warn(msg: string, meta?: Record<string, unknown>): void;
+    error(msg: string, meta?: Record<string, unknown>): void;
+    private write;
+}
+export interface BuildPluginContextOptions {
+    pluginName: string;
+    storage: MapPluginStorage;
+    logger?: PluginLogger;
+    getZonePeers?: (zoneId: string) => ReadonlyArray<PeerInfo>;
+    getCharacterState?: (characterId: string) => Readonly<CharacterState>;
+    getZoneState?: (zoneId: string) => ReadonlyMap<string, unknown>;
+    now?: () => number;
+}
+export declare function buildPluginContext(opts: BuildPluginContextOptions): PluginContext;
+//# sourceMappingURL=plugin-context.d.ts.map

package/dist/director/ai/plugin-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-context.d.ts","sourceRoot":"","sources":["../../../src/director/ai/plugin-context.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,cAAc,EACf,MAAM,aAAa,CAAC;AAQrB,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8B;IAKpD,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa;IAkB5C,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAsBrC,IAAI,IAAI,MAAM;IAId,OAAO,CAAC,UAAU;CAGnB;AAQD,qBAAa,mBAAoB,YAAW,YAAY;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,MAAM;IAE/C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIvD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIvD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIxD,OAAO,CAAC,KAAK;CAwBd;AAYD,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,gBAAgB,CAAC;IAE1B,MAAM,CAAC,EAAE,YAAY,CAAC;IAGtB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC3D,iBAAiB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,QAAQ,CAAC,cAAc,CAAC,CAAC;IACtE,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEhE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,yBAAyB,GAAG,aAAa,CAmCjF"}

package/dist/director/ai/plugin-context.js

@@ -0,0 +1,152 @@
+// PluginContext concrete implementations.
+//
+// MapPluginStorage  - in-memory KV backed by a single Map, namespaced
+//                     per (pluginName, key). Survives across ticks;
+//                     cleared when the registry calls clearPlugin().
+// ConsolePluginLogger - tags every line with the plugin name and
+//                       writes to console.{info,warn,error}. Suitable
+//                       for tests + dev; production consumers can
+//                       drop in a structured-log impl.
+//
+// These are reference implementations. Consumers wiring against
+// `@sadhaka/loom-engine/server` may substitute their own
+// PluginStorage / PluginLogger impls (e.g. Redis-backed storage,
+// pino-backed logger) without changing the SPI surface.
+//
+// The registry does not assume MapPluginStorage; the SPI is
+// the only contract. These exist so a consumer can stand a plugin
+// up in five lines without writing a storage adapter first.
+// ----- MapPluginStorage -----
+//
+// In-memory storage shared across all plugins; per-plugin namespace
+// is enforced by composing the storage key as `${pluginName}::${key}`.
+// `clearPlugin(name)` wipes every entry tagged with that plugin so
+// unregister + re-register starts clean.
+export class MapPluginStorage {
+    store = new Map();
+    // Build a per-plugin facade that satisfies the PluginStorage
+    // interface; the facade scopes get/set/delete to the plugin's
+    // namespace so plugin authors never see the composite key.
+    forPlugin(pluginName) {
+        var self = this;
+        return {
+            async get(key) {
+                return self.store.get(self.composeKey(pluginName, key));
+            },
+            async set(key, value) {
+                self.store.set(self.composeKey(pluginName, key), value);
+            },
+            async delete(key) {
+                self.store.delete(self.composeKey(pluginName, key));
+            },
+        };
+    }
+    // Wipe all entries belonging to a plugin. Called by the registry
+    // on unregister(). Iterates once; cost is O(total entries) but
+    // unregister is rare.
+    clearPlugin(pluginName) {
+        var prefix = pluginName + '::';
+        var keysToDelete = [];
+        var iter = this.store.keys();
+        var next = iter.next();
+        while (!next.done) {
+            var k = next.value;
+            if (k.startsWith(prefix)) {
+                keysToDelete.push(k);
+            }
+            next = iter.next();
+        }
+        for (var i = 0; i < keysToDelete.length; i++) {
+            var key = keysToDelete[i];
+            if (key !== undefined) {
+                this.store.delete(key);
+            }
+        }
+    }
+    // Inspect-only: total number of entries across all plugins. Useful
+    // in tests when asserting clearPlugin shrinks the store.
+    size() {
+        return this.store.size;
+    }
+    composeKey(pluginName, key) {
+        return pluginName + '::' + key;
+    }
+}
+// ----- ConsolePluginLogger -----
+//
+// Tags every line with `[plugin: <name>]` and forwards to the
+// matching console method. Meta is JSON-stringified and appended;
+// circular refs fall back to a short description so logging never
+// throws at the boundary.
+export class ConsolePluginLogger {
+    pluginName;
+    constructor(pluginName) {
+        this.pluginName = pluginName;
+    }
+    info(msg, meta) {
+        this.write('info', msg, meta);
+    }
+    warn(msg, meta) {
+        this.write('warn', msg, meta);
+    }
+    error(msg, meta) {
+        this.write('error', msg, meta);
+    }
+    write(level, msg, meta) {
+        var tag = '[plugin: ' + this.pluginName + ']';
+        var line = tag + ' ' + msg;
+        var metaStr = '';
+        if (meta) {
+            try {
+                metaStr = ' ' + JSON.stringify(meta);
+            }
+            catch {
+                metaStr = ' [meta-not-serializable]';
+            }
+        }
+        var out = line + metaStr;
+        if (level === 'info') {
+            console.info(out);
+        }
+        else if (level === 'warn') {
+            console.warn(out);
+        }
+        else {
+            console.error(out);
+        }
+    }
+}
+export function buildPluginContext(opts) {
+    var pluginName = opts.pluginName;
+    var logger = opts.logger ?? new ConsolePluginLogger(pluginName);
+    var storage = opts.storage.forPlugin(pluginName);
+    var getZonePeers = opts.getZonePeers ??
+        function () {
+            return [];
+        };
+    var getCharacterState = opts.getCharacterState ??
+        function (characterId) {
+            return {
+                characterId,
+                zone: '',
+                x: 0,
+                y: 0,
+                hp_current: 0,
+                hp_max: 0,
+            };
+        };
+    var getZoneState = opts.getZoneState ??
+        function () {
+            return new Map();
+        };
+    var now = opts.now ?? Date.now;
+    return {
+        getZonePeers,
+        getCharacterState,
+        getZoneState,
+        storage,
+        logger,
+        now,
+    };
+}
+//# sourceMappingURL=plugin-context.js.map

package/dist/director/ai/plugin-context.js.map

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

package/dist/director/ai/plugin.d.ts

@@ -0,0 +1,57 @@
+import type { DirectorEvent } from '../event-envelope.js';
+import type { ZoneEvent } from '../zone/zone-event-envelope.js';
+export type { ZoneEvent };
+export interface EmittedEvents {
+    characterEvents?: DirectorEvent[];
+    zoneEvents?: ZoneEvent[];
+}
+export interface PeerInfo {
+    characterId: string;
+    userId: string;
+    zone: string;
+    x: number;
+    y: number;
+    name: string | null;
+}
+export interface PlayerAction {
+    kind: 'damage' | 'interact' | 'speak' | 'use_item' | (string & {});
+    payload: Record<string, unknown>;
+}
+export interface CharacterState {
+    characterId: string;
+    zone: string;
+    x: number;
+    y: number;
+    hp_current: number;
+    hp_max: number;
+}
+export interface PluginStorage {
+    get(key: string): Promise<unknown | undefined>;
+    set(key: string, value: unknown): Promise<void>;
+    delete(key: string): Promise<void>;
+}
+export interface PluginLogger {
+    info(msg: string, meta?: Record<string, unknown>): void;
+    warn(msg: string, meta?: Record<string, unknown>): void;
+    error(msg: string, meta?: Record<string, unknown>): void;
+}
+export interface PluginContext {
+    getZonePeers(zoneId: string): ReadonlyArray<PeerInfo>;
+    getCharacterState(characterId: string): Readonly<CharacterState>;
+    getZoneState(zoneId: string): ReadonlyMap<string, unknown>;
+    storage: PluginStorage;
+    logger: PluginLogger;
+    now: () => number;
+}
+export interface IAIPlugin {
+    readonly name: string;
+    readonly version: string;
+    readonly priority: number;
+    onTick?(ctx: PluginContext): Promise<EmittedEvents>;
+    onPeerJoin?(ctx: PluginContext, peer: PeerInfo): Promise<EmittedEvents>;
+    onPeerLeave?(ctx: PluginContext, peer: PeerInfo): Promise<EmittedEvents>;
+    onZoneEnter?(ctx: PluginContext, peer: PeerInfo, fromZone: string | null): Promise<EmittedEvents>;
+    onPlayerAction?(ctx: PluginContext, peer: PeerInfo, action: PlayerAction): Promise<EmittedEvents>;
+    dispose?(): Promise<void>;
+}
+//# sourceMappingURL=plugin.d.ts.map

package/dist/director/ai/plugin.d.ts.map

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