minecraft-bedrock-mcp-server 0.1.0

package/dist/queue/command-queue.js

@@ -0,0 +1,151 @@
+import { BridgeError } from "../errors/bridge-error.js";
+import { newCommandId } from "./command-id.js";
+import { createPendingCommands } from "./pending-commands.js";
+/** Creates an in-memory {@link CommandQueue}. */
+export function createCommandQueue(options) {
+    const now = options.now ?? Date.now;
+    const pending = createPendingCommands();
+    const ready = [];
+    const waiters = [];
+    let lastPollAt = 0;
+    let activePolls = 0;
+    let closed = false;
+    function bridgeConnected() {
+        return activePolls > 0 || now() - lastPollAt < options.livenessWindowMs;
+    }
+    function wakeNextWaiter() {
+        waiters.shift()?.wake();
+    }
+    function dropFromReady(id) {
+        const index = ready.findIndex((command) => command.id === id);
+        if (index >= 0)
+            ready.splice(index, 1);
+    }
+    function takeReady(max, at) {
+        const batch = [];
+        while (batch.length < max) {
+            const command = ready.shift();
+            if (!command)
+                break;
+            // A command past its deadline has already been (or will be) rejected by
+            // the pending registry; never deliver it.
+            if (command.deadlineAt <= at)
+                continue;
+            batch.push({
+                id: command.id,
+                kind: command.kind,
+                payload: command.payload,
+                issued_at: new Date(command.issuedAt).toISOString(),
+                deadline_ms: command.deadlineAt - at,
+            });
+        }
+        return batch;
+    }
+    /** Resolves when a command is enqueued, the timeout elapses, or `signal` aborts. */
+    function awaitCommand(timeoutMs, signal) {
+        return new Promise((resolve) => {
+            let settled = false;
+            const waiter = { wake: finish };
+            const timer = setTimeout(finish, timeoutMs);
+            timer.unref();
+            signal.addEventListener("abort", finish, { once: true });
+            waiters.push(waiter);
+            function finish() {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timer);
+                signal.removeEventListener("abort", finish);
+                const index = waiters.indexOf(waiter);
+                if (index >= 0)
+                    waiters.splice(index, 1);
+                resolve();
+            }
+        });
+    }
+    return {
+        async enqueueAndAwait(request) {
+            if (closed) {
+                throw new BridgeError({
+                    code: "BRIDGE_DISCONNECTED",
+                    message: "the command queue is closed",
+                });
+            }
+            if (!bridgeConnected()) {
+                throw new BridgeError({
+                    code: "BRIDGE_DISCONNECTED",
+                    message: "no behavior pack is connected to the bridge",
+                });
+            }
+            if (pending.size() >= options.maxOutstanding) {
+                throw new BridgeError({
+                    code: "QUEUE_FULL",
+                    message: `the command queue is at capacity (${options.maxOutstanding} outstanding)`,
+                });
+            }
+            const throttled = options.throttle.tryAdmit(request.kind);
+            if (throttled) {
+                throw new BridgeError({
+                    code: "COMMAND_THROTTLED",
+                    message: `command kind '${request.kind}' is being throttled`,
+                    retryAfterMs: throttled.retryAfterMs,
+                    details: { kind: request.kind },
+                });
+            }
+            const id = newCommandId();
+            const issuedAt = now();
+            const deadlineAt = issuedAt + request.timeoutMs;
+            const result = pending.register(id, deadlineAt);
+            ready.push({
+                id,
+                kind: request.kind,
+                payload: request.payload,
+                issuedAt,
+                deadlineAt,
+                correlationId: request.correlationId,
+            });
+            // Once the command settles or times out, make sure it is not left
+            // lingering in the ready buffer awaiting delivery.
+            void result.then(() => {
+                dropFromReady(id);
+            }, () => {
+                dropFromReady(id);
+            });
+            wakeNextWaiter();
+            return await result;
+        },
+        async dequeue({ max, timeoutMs, signal }) {
+            lastPollAt = now();
+            activePolls += 1;
+            try {
+                if (ready.length === 0 && !signal.aborted && !closed) {
+                    await awaitCommand(timeoutMs, signal);
+                }
+                return takeReady(max, now());
+            }
+            finally {
+                activePolls -= 1;
+            }
+        },
+        settle(result) {
+            return pending.settle(result.id, result);
+        },
+        stats() {
+            return {
+                depth: ready.length,
+                inFlight: Math.max(0, pending.size() - ready.length),
+                bridgeConnected: bridgeConnected(),
+            };
+        },
+        close() {
+            if (closed)
+                return;
+            closed = true;
+            ready.length = 0;
+            pending.rejectAll(new BridgeError({ code: "BRIDGE_DISCONNECTED", message: "the bridge is shutting down" }));
+            while (waiters.length > 0)
+                wakeNextWaiter();
+        },
+    };
+}
+//# sourceMappingURL=command-queue.js.map

package/dist/queue/command-queue.js.map

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

package/dist/queue/command-throttle.d.ts

@@ -0,0 +1,38 @@
+/** Result of a denied admission: how long until a retry may succeed. */
+export interface ThrottleDecision {
+    readonly retryAfterMs: number;
+}
+/** Token-bucket rate-limit policy for a command kind. */
+export interface ThrottlePolicy {
+    /** Sustained admissions per second. */
+    readonly ratePerSecond: number;
+    /** Bucket capacity — the largest burst admitted at once. */
+    readonly burst: number;
+}
+/** Configuration for {@link createCommandThrottle}. */
+export interface CommandThrottleOptions {
+    /** Policy applied to any kind without a specific override. */
+    readonly defaultPolicy: ThrottlePolicy;
+    /** Per-kind policy overrides, keyed by command kind. */
+    readonly perKindPolicy?: Readonly<Record<string, ThrottlePolicy>>;
+    /** Clock source, injectable for tests. Defaults to `Date.now`. */
+    readonly now?: () => number;
+}
+/**
+ * Per-kind rate limiter for the bridge enqueue path.
+ *
+ * Each command kind gets an independent token bucket, shielding the behavior
+ * pack's script watchdog from bursts of expensive commands.
+ */
+export interface CommandThrottle {
+    /**
+     * Attempts to admit one command of the given kind.
+     *
+     * @returns `null` when admitted; a {@link ThrottleDecision} when the kind's
+     *   bucket is empty.
+     */
+    tryAdmit(kind: string): ThrottleDecision | null;
+}
+/** Creates a {@link CommandThrottle} from the given policy. */
+export declare function createCommandThrottle(options: CommandThrottleOptions): CommandThrottle;
+//# sourceMappingURL=command-throttle.d.ts.map

package/dist/queue/command-throttle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-throttle.d.ts","sourceRoot":"","sources":["../../src/queue/command-throttle.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,yDAAyD;AACzD,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,uDAAuD;AACvD,MAAM,WAAW,sBAAsB;IACrC,8DAA8D;IAC9D,QAAQ,CAAC,aAAa,EAAE,cAAc,CAAC;IACvC,wDAAwD;IACxD,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;IAClE,kEAAkE;IAClE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAAC;CACjD;AAOD,+DAA+D;AAC/D,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CA4BtF"}

package/dist/queue/command-throttle.js

@@ -0,0 +1,26 @@
+/** Creates a {@link CommandThrottle} from the given policy. */
+export function createCommandThrottle(options) {
+    const now = options.now ?? Date.now;
+    const buckets = new Map();
+    function policyFor(kind) {
+        return options.perKindPolicy?.[kind] ?? options.defaultPolicy;
+    }
+    return {
+        tryAdmit(kind) {
+            const policy = policyFor(kind);
+            const at = now();
+            const bucket = buckets.get(kind) ?? { tokens: policy.burst, updatedAt: at };
+            const elapsedSeconds = Math.max(0, at - bucket.updatedAt) / 1000;
+            bucket.tokens = Math.min(policy.burst, bucket.tokens + elapsedSeconds * policy.ratePerSecond);
+            bucket.updatedAt = at;
+            buckets.set(kind, bucket);
+            if (bucket.tokens >= 1) {
+                bucket.tokens -= 1;
+                return null;
+            }
+            const retryAfterMs = Math.ceil(((1 - bucket.tokens) / policy.ratePerSecond) * 1000);
+            return { retryAfterMs };
+        },
+    };
+}
+//# sourceMappingURL=command-throttle.js.map

package/dist/queue/command-throttle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-throttle.js","sourceRoot":"","sources":["../../src/queue/command-throttle.ts"],"names":[],"mappings":"AA4CA,+DAA+D;AAC/D,MAAM,UAAU,qBAAqB,CAAC,OAA+B;IACnE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE1C,SAAS,SAAS,CAAC,IAAY;QAC7B,OAAO,OAAO,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,aAAa,CAAC;IAChE,CAAC;IAED,OAAO;QACL,QAAQ,CAAC,IAAI;YACX,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC/B,MAAM,EAAE,GAAG,GAAG,EAAE,CAAC;YACjB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;YAE5E,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;YACjE,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,GAAG,cAAc,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;YAC9F,MAAM,CAAC,SAAS,GAAG,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAE1B,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBACvB,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;gBACnB,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,CAAC;YACpF,OAAO,EAAE,YAAY,EAAE,CAAC;QAC1B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/queue/instrumented-command-queue.d.ts

@@ -0,0 +1,9 @@
+import type { Metrics } from "../observability/metrics.js";
+import type { CommandQueue } from "./command-queue.js";
+/**
+ * Wraps a {@link CommandQueue}, recording each command's duration and outcome
+ * to {@link Metrics}. Composition keeps the base queue free of metrics
+ * concerns; the wrapper is applied only when metrics are enabled.
+ */
+export declare function createInstrumentedCommandQueue(inner: CommandQueue, metrics: Metrics, now?: () => number): CommandQueue;
+//# sourceMappingURL=instrumented-command-queue.d.ts.map

package/dist/queue/instrumented-command-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumented-command-queue.d.ts","sourceRoot":"","sources":["../../src/queue/instrumented-command-queue.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAE3D,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,oBAAoB,CAAC;AAEvE;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,OAAO,EAChB,GAAG,GAAE,MAAM,MAAiB,GAC3B,YAAY,CA8Bd"}

package/dist/queue/instrumented-command-queue.js

@@ -0,0 +1,39 @@
+import { BridgeError } from "../errors/bridge-error.js";
+/**
+ * Wraps a {@link CommandQueue}, recording each command's duration and outcome
+ * to {@link Metrics}. Composition keeps the base queue free of metrics
+ * concerns; the wrapper is applied only when metrics are enabled.
+ */
+export function createInstrumentedCommandQueue(inner, metrics, now = Date.now) {
+    return {
+        async enqueueAndAwait(request) {
+            const startedAt = now();
+            try {
+                const result = await inner.enqueueAndAwait(request);
+                metrics.recordCommand({
+                    kind: request.kind,
+                    status: result.status,
+                    code: result.status === "error" ? result.error.code : undefined,
+                    durationMs: now() - startedAt,
+                });
+                return result;
+            }
+            catch (error) {
+                metrics.recordCommand({
+                    kind: request.kind,
+                    status: "error",
+                    code: BridgeError.is(error) ? error.code : "INTERNAL",
+                    durationMs: now() - startedAt,
+                });
+                throw error;
+            }
+        },
+        dequeue: (options) => inner.dequeue(options),
+        settle: (result) => inner.settle(result),
+        stats: () => inner.stats(),
+        close: () => {
+            inner.close();
+        },
+    };
+}
+//# sourceMappingURL=instrumented-command-queue.js.map

package/dist/queue/instrumented-command-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumented-command-queue.js","sourceRoot":"","sources":["../../src/queue/instrumented-command-queue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAKxD;;;;GAIG;AACH,MAAM,UAAU,8BAA8B,CAC5C,KAAmB,EACnB,OAAgB,EAChB,MAAoB,IAAI,CAAC,GAAG;IAE5B,OAAO;QACL,KAAK,CAAC,eAAe,CAAC,OAAuB;YAC3C,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC;YACxB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;gBACpD,OAAO,CAAC,aAAa,CAAC;oBACpB,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,IAAI,EAAE,MAAM,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;oBAC/D,UAAU,EAAE,GAAG,EAAE,GAAG,SAAS;iBAC9B,CAAC,CAAC;gBACH,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,aAAa,CAAC;oBACpB,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,MAAM,EAAE,OAAO;oBACf,IAAI,EAAE,WAAW,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU;oBACrD,UAAU,EAAE,GAAG,EAAE,GAAG,SAAS;iBAC9B,CAAC,CAAC;gBACH,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QACD,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAC5C,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;QACxC,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE;QAC1B,KAAK,EAAE,GAAG,EAAE;YACV,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/queue/pending-commands.d.ts

@@ -0,0 +1,35 @@
+import { BridgeError } from "../errors/bridge-error.js";
+import type { CommandResult } from "../protocol/result.js";
+import type { CommandId } from "./command-id.js";
+/**
+ * Registry of in-flight commands awaiting a correlated result.
+ *
+ * A command is registered when it is enqueued and removed when the behavior
+ * pack settles it or when its deadline elapses.
+ */
+export interface PendingCommands {
+    /**
+     * Registers a command and returns a promise for its result.
+     *
+     * Resolves with the {@link CommandResult} reported by the behavior pack
+     * (whether `ok` or `error`). Rejects with a `COMMAND_TIMEOUT` `BridgeError`
+     * if `deadlineAt` is reached first.
+     *
+     * @param deadlineAt - Absolute epoch-millisecond deadline.
+     */
+    register(id: CommandId, deadlineAt: number): Promise<CommandResult>;
+    /**
+     * Delivers a result to a registered command.
+     *
+     * @returns `true` if a pending command matched; `false` if the id is
+     *   unknown or already settled (e.g. a result that arrived after timeout).
+     */
+    settle(id: CommandId, result: CommandResult): boolean;
+    /** Rejects every pending command — used during graceful shutdown. */
+    rejectAll(error: BridgeError): void;
+    /** Number of commands currently awaiting a result. */
+    size(): number;
+}
+/** Creates an empty {@link PendingCommands} registry. */
+export declare function createPendingCommands(): PendingCommands;
+//# sourceMappingURL=pending-commands.d.ts.map

package/dist/queue/pending-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending-commands.d.ts","sourceRoot":"","sources":["../../src/queue/pending-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAQjD;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAEpE;;;;;OAKG;IACH,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC;IAEtD,qEAAqE;IACrE,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAEpC,sDAAsD;IACtD,IAAI,IAAI,MAAM,CAAC;CAChB;AAED,yDAAyD;AACzD,wBAAgB,qBAAqB,IAAI,eAAe,CA0CvD"}

package/dist/queue/pending-commands.js

@@ -0,0 +1,41 @@
+import { BridgeError } from "../errors/bridge-error.js";
+/** Creates an empty {@link PendingCommands} registry. */
+export function createPendingCommands() {
+    const entries = new Map();
+    return {
+        register(id, deadlineAt) {
+            return new Promise((resolve, reject) => {
+                const delayMs = Math.max(0, deadlineAt - Date.now());
+                const timer = setTimeout(() => {
+                    entries.delete(id);
+                    reject(new BridgeError({
+                        code: "COMMAND_TIMEOUT",
+                        message: `command ${id} did not complete within ${delayMs} ms`,
+                    }));
+                }, delayMs);
+                timer.unref();
+                entries.set(id, { resolve, reject, timer });
+            });
+        },
+        settle(id, result) {
+            const entry = entries.get(id);
+            if (!entry)
+                return false;
+            clearTimeout(entry.timer);
+            entries.delete(id);
+            entry.resolve(result);
+            return true;
+        },
+        rejectAll(error) {
+            for (const entry of entries.values()) {
+                clearTimeout(entry.timer);
+                entry.reject(error);
+            }
+            entries.clear();
+        },
+        size() {
+            return entries.size;
+        },
+    };
+}
+//# sourceMappingURL=pending-commands.js.map

package/dist/queue/pending-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending-commands.js","sourceRoot":"","sources":["../../src/queue/pending-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AA2CxD,yDAAyD;AACzD,MAAM,UAAU,qBAAqB;IACnC,MAAM,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEnD,OAAO;QACL,QAAQ,CAAC,EAAE,EAAE,UAAU;YACrB,OAAO,IAAI,OAAO,CAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACpD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;gBACrD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;oBAC5B,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;oBACnB,MAAM,CACJ,IAAI,WAAW,CAAC;wBACd,IAAI,EAAE,iBAAiB;wBACvB,OAAO,EAAE,WAAW,EAAE,4BAA4B,OAAO,KAAK;qBAC/D,CAAC,CACH,CAAC;gBACJ,CAAC,EAAE,OAAO,CAAC,CAAC;gBACZ,KAAK,CAAC,KAAK,EAAE,CAAC;gBACd,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YAC9C,CAAC,CAAC,CAAC;QACL,CAAC;QAED,MAAM,CAAC,EAAE,EAAE,MAAM;YACf,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC9B,IAAI,CAAC,KAAK;gBAAE,OAAO,KAAK,CAAC;YACzB,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC1B,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACnB,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,SAAS,CAAC,KAAK;YACb,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;gBACrC,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC1B,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;YACD,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;QAED,IAAI;YACF,OAAO,OAAO,CAAC,IAAI,CAAC;QACtB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/server-info.d.ts

@@ -0,0 +1,5 @@
+/** The npm package name. */
+export declare const SERVER_NAME: string;
+/** The npm package version. */
+export declare const SERVER_VERSION: string;
+//# sourceMappingURL=server-info.d.ts.map

package/dist/server-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-info.d.ts","sourceRoot":"","sources":["../src/server-info.ts"],"names":[],"mappings":"AAqBA,4BAA4B;AAC5B,eAAO,MAAM,WAAW,QAAgB,CAAC;AAEzC,+BAA+B;AAC/B,eAAO,MAAM,cAAc,QAAmB,CAAC"}

package/dist/server-info.js

@@ -0,0 +1,22 @@
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { z } from "zod";
+const ManifestSchema = z.object({
+    name: z.string(),
+    version: z.string(),
+});
+/**
+ * Reads the package manifest that ships beside the compiled output (and beside
+ * `src/` during development), so the name and version stay in sync with npm.
+ */
+function readManifest() {
+    const manifestPath = join(import.meta.dirname, "../package.json");
+    const raw = JSON.parse(readFileSync(manifestPath, "utf8"));
+    return ManifestSchema.parse(raw);
+}
+const manifest = readManifest();
+/** The npm package name. */
+export const SERVER_NAME = manifest.name;
+/** The npm package version. */
+export const SERVER_VERSION = manifest.version;
+//# sourceMappingURL=server-info.js.map

package/dist/server-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-info.js","sourceRoot":"","sources":["../src/server-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC;AAEH;;;GAGG;AACH,SAAS,YAAY;IACnB,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;IAClE,MAAM,GAAG,GAAY,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;IACpE,OAAO,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;AAEhC,4BAA4B;AAC5B,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC;AAEzC,+BAA+B;AAC/B,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC"}

package/dist/structures/structure-file-store.d.ts

@@ -0,0 +1,22 @@
+/** Metadata for a `.mcstructure` file. */
+export interface StructureFileInfo {
+    readonly name: string;
+    readonly bytes: number;
+}
+/**
+ * Filesystem access to the `.mcstructure` files in the behavior pack's
+ * `structures` folder. Every file name is confined to that folder.
+ */
+export interface StructureFileStore {
+    /** Lists the `.mcstructure` files present. */
+    list(): Promise<StructureFileInfo[]>;
+    /** Reads a structure file's raw bytes. */
+    read(name: string): Promise<Buffer>;
+    /** Writes a structure file, creating the folder if needed. */
+    write(name: string, data: Buffer): Promise<StructureFileInfo>;
+    /** Deletes a structure file; `false` if it did not exist. */
+    remove(name: string): Promise<boolean>;
+}
+/** Creates a {@link StructureFileStore} rooted at `rootDir`. */
+export declare function createStructureFileStore(rootDir: string): StructureFileStore;
+//# sourceMappingURL=structure-file-store.d.ts.map

package/dist/structures/structure-file-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure-file-store.d.ts","sourceRoot":"","sources":["../../src/structures/structure-file-store.ts"],"names":[],"mappings":"AAMA,0CAA0C;AAC1C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,8CAA8C;IAC9C,IAAI,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACrC,0CAA0C;IAC1C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,8DAA8D;IAC9D,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC9D,6DAA6D;IAC7D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACxC;AAMD,gEAAgE;AAChE,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CA8E5E"}

package/dist/structures/structure-file-store.js

@@ -0,0 +1,89 @@
+import { mkdir, readFile, readdir, stat, unlink, writeFile } from "node:fs/promises";
+import { basename, join, resolve } from "node:path";
+import { BridgeError } from "../errors/bridge-error.js";
+const STRUCTURE_EXTENSION = ".mcstructure";
+function isErrno(error) {
+    return error instanceof Error && "code" in error;
+}
+/** Creates a {@link StructureFileStore} rooted at `rootDir`. */
+export function createStructureFileStore(rootDir) {
+    const root = resolve(rootDir);
+    /** Resolves a caller-supplied name to an absolute path inside `root`. */
+    function resolveFile(name) {
+        const trimmed = name.trim();
+        if (trimmed.length === 0 || trimmed !== basename(trimmed) || trimmed.includes("..")) {
+            throw new BridgeError({
+                code: "STRUCTURE_FILE_ERROR",
+                message: `invalid structure file name '${name}'`,
+            });
+        }
+        const fileName = trimmed.endsWith(STRUCTURE_EXTENSION)
+            ? trimmed
+            : `${trimmed}${STRUCTURE_EXTENSION}`;
+        return join(root, fileName);
+    }
+    return {
+        async list() {
+            let entries;
+            try {
+                entries = await readdir(root);
+            }
+            catch (error) {
+                if (isErrno(error) && error.code === "ENOENT")
+                    return [];
+                throw new BridgeError({
+                    code: "STRUCTURE_FILE_ERROR",
+                    message: "unable to list the structures folder",
+                    cause: error,
+                });
+            }
+            const files = [];
+            for (const entry of entries) {
+                if (!entry.endsWith(STRUCTURE_EXTENSION))
+                    continue;
+                const info = await stat(join(root, entry));
+                files.push({ name: entry, bytes: info.size });
+            }
+            return files;
+        },
+        async read(name) {
+            const path = resolveFile(name);
+            try {
+                return await readFile(path);
+            }
+            catch (error) {
+                if (isErrno(error) && error.code === "ENOENT") {
+                    throw new BridgeError({ code: "NOT_FOUND", message: `no structure file '${name}'` });
+                }
+                throw new BridgeError({
+                    code: "STRUCTURE_FILE_ERROR",
+                    message: `unable to read structure file '${name}'`,
+                    cause: error,
+                });
+            }
+        },
+        async write(name, data) {
+            const path = resolveFile(name);
+            await mkdir(root, { recursive: true });
+            await writeFile(path, data);
+            return { name: basename(path), bytes: data.byteLength };
+        },
+        async remove(name) {
+            const path = resolveFile(name);
+            try {
+                await unlink(path);
+                return true;
+            }
+            catch (error) {
+                if (isErrno(error) && error.code === "ENOENT")
+                    return false;
+                throw new BridgeError({
+                    code: "STRUCTURE_FILE_ERROR",
+                    message: `unable to delete structure file '${name}'`,
+                    cause: error,
+                });
+            }
+        },
+    };
+}
+//# sourceMappingURL=structure-file-store.js.map

package/dist/structures/structure-file-store.js.map

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

package/dist/tools/block-tools.d.ts

@@ -0,0 +1,4 @@
+import { type ToolDefinition } from "./tool-definition.js";
+/** Block reads and block writes. */
+export declare const blockTools: readonly ToolDefinition[];
+//# sourceMappingURL=block-tools.d.ts.map

package/dist/tools/block-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-tools.d.ts","sourceRoot":"","sources":["../../src/tools/block-tools.ts"],"names":[],"mappings":"AAQA,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAI7E,oCAAoC;AACpC,eAAO,MAAM,UAAU,EAAE,SAAS,cAAc,EAyG/C,CAAC"}