minecraft-bedrock-mcp-server 0.1.0

package/dist/mcp/session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../src/mcp/session-manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAOzD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,6BAA6B,GAAG,SAAS,CAAC;IAClE;;;;OAIG;IACH,MAAM,IAAI,OAAO,CAAC,6BAA6B,CAAC,CAAC;IACjD,sCAAsC;IACtC,KAAK,IAAI,MAAM,CAAC;IAChB,4DAA4D;IAC5D,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,sDAAsD;AACtD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,EAAE,MAAM,SAAS,CAAC;CACxC;AAED,+CAA+C;AAC/C,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAuCnF"}

package/dist/mcp/session-manager.js

@@ -0,0 +1,38 @@
+import { randomUUID } from "node:crypto";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+/** Creates an empty {@link SessionManager}. */
+export function createSessionManager(options) {
+    const sessions = new Map();
+    return {
+        get(sessionId) {
+            return sessions.get(sessionId)?.transport;
+        },
+        async create() {
+            const server = options.createServer();
+            const transport = new StreamableHTTPServerTransport({
+                sessionIdGenerator: () => randomUUID(),
+                onsessioninitialized: (sessionId) => {
+                    sessions.set(sessionId, { server, transport });
+                    options.logger.info({ sessionId, sessionCount: sessions.size }, "mcp session opened");
+                },
+            });
+            transport.onclose = () => {
+                const sessionId = transport.sessionId;
+                if (sessionId !== undefined && sessions.delete(sessionId)) {
+                    options.logger.info({ sessionId, sessionCount: sessions.size }, "mcp session closed");
+                }
+            };
+            await server.connect(transport);
+            return transport;
+        },
+        count() {
+            return sessions.size;
+        },
+        async closeAll() {
+            const open = [...sessions.values()];
+            sessions.clear();
+            await Promise.allSettled(open.flatMap((session) => [session.transport.close(), session.server.close()]));
+        },
+    };
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/mcp/session-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.js","sourceRoot":"","sources":["../../src/mcp/session-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAmCnG,+CAA+C;AAC/C,MAAM,UAAU,oBAAoB,CAAC,OAA8B;IACjE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAsB,CAAC;IAE/C,OAAO;QACL,GAAG,CAAC,SAAS;YACX,OAAO,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;QAC5C,CAAC;QAED,KAAK,CAAC,MAAM;YACV,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;YACtC,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC;gBAClD,kBAAkB,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE;gBACtC,oBAAoB,EAAE,CAAC,SAAS,EAAE,EAAE;oBAClC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;oBAC/C,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,oBAAoB,CAAC,CAAC;gBACxF,CAAC;aACF,CAAC,CAAC;YACH,SAAS,CAAC,OAAO,GAAG,GAAG,EAAE;gBACvB,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC;gBACtC,IAAI,SAAS,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;oBAC1D,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,oBAAoB,CAAC,CAAC;gBACxF,CAAC;YACH,CAAC,CAAC;YACF,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAChC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,KAAK;YACH,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;QAED,KAAK,CAAC,QAAQ;YACZ,MAAM,IAAI,GAAG,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YACpC,QAAQ,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,OAAO,CAAC,UAAU,CACtB,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAC/E,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/mcp/tool-registry.d.ts

@@ -0,0 +1,15 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ToolContext, ToolDefinition } from "../tools/tool-definition.js";
+/** Builds a per-invocation {@link ToolContext} from MCP request metadata. */
+export type ToolContextFactory = (extra: {
+    readonly signal: AbortSignal;
+    readonly requestId: string | number;
+}) => ToolContext;
+/**
+ * Registers every tool definition on an MCP server.
+ *
+ * Each handler is wrapped so that a thrown error becomes a coded error
+ * envelope rather than a transport-level failure.
+ */
+export declare function registerTools(server: McpServer, tools: readonly ToolDefinition[], contextFor: ToolContextFactory): void;
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/mcp/tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../src/mcp/tool-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAG/E,6EAA6E;AAC7E,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE;IACvC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;CACrC,KAAK,WAAW,CAAC;AAElB;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,SAAS,cAAc,EAAE,EAChC,UAAU,EAAE,kBAAkB,GAC7B,IAAI,CAqBN"}

package/dist/mcp/tool-registry.js

@@ -0,0 +1,27 @@
+import { toErrorResult } from "../tools/tool-result.js";
+/**
+ * Registers every tool definition on an MCP server.
+ *
+ * Each handler is wrapped so that a thrown error becomes a coded error
+ * envelope rather than a transport-level failure.
+ */
+export function registerTools(server, tools, contextFor) {
+    for (const tool of tools) {
+        server.registerTool(tool.name, {
+            title: tool.title,
+            description: tool.description,
+            inputSchema: tool.inputShape,
+            annotations: tool.annotations,
+        }, async (input, extra) => {
+            const context = contextFor({ signal: extra.signal, requestId: extra.requestId });
+            try {
+                return await tool.handler(input, context);
+            }
+            catch (error) {
+                context.logger.error({ err: error, tool: tool.name }, "tool handler failed");
+                return toErrorResult(error);
+            }
+        });
+    }
+}
+//# sourceMappingURL=tool-registry.js.map

package/dist/mcp/tool-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.js","sourceRoot":"","sources":["../../src/mcp/tool-registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAQxD;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAiB,EACjB,KAAgC,EAChC,UAA8B;IAE9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,YAAY,CACjB,IAAI,CAAC,IAAI,EACT;YACE,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,UAAU;YAC5B,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,EACD,KAAK,EAAE,KAAc,EAAE,KAAK,EAAE,EAAE;YAC9B,MAAM,OAAO,GAAG,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;YACjF,IAAI,CAAC;gBACH,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAC5C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,qBAAqB,CAAC,CAAC;gBAC7E,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/observability/logger.d.ts

@@ -0,0 +1,16 @@
+import { type Logger } from "pino";
+export type { Logger };
+/** Options for {@link createLogger}. */
+export interface LoggerOptions {
+    /** pino log level. */
+    readonly level: string;
+    /** When true, render human-readable logs via `pino-pretty` (development). */
+    readonly pretty: boolean;
+}
+/**
+ * Creates the application's root structured logger.
+ *
+ * Bearer tokens and `Authorization` headers are redacted from every log line.
+ */
+export declare function createLogger(options: LoggerOptions): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/observability/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/observability/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,MAAM,CAAC;AAEzC,YAAY,EAAE,MAAM,EAAE,CAAC;AAEvB,wCAAwC;AACxC,MAAM,WAAW,aAAa;IAC5B,sBAAsB;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAW3D"}

package/dist/observability/logger.js

@@ -0,0 +1,19 @@
+import { pino } from "pino";
+/**
+ * Creates the application's root structured logger.
+ *
+ * Bearer tokens and `Authorization` headers are redacted from every log line.
+ */
+export function createLogger(options) {
+    return pino({
+        level: options.level,
+        redact: {
+            paths: ["req.headers.authorization", "headers.authorization", "authorization", "*.token"],
+            remove: true,
+        },
+        ...(options.pretty
+            ? { transport: { target: "pino-pretty", options: { translateTime: "SYS:standard" } } }
+            : {}),
+    });
+}
+//# sourceMappingURL=logger.js.map

package/dist/observability/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/observability/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAe,MAAM,MAAM,CAAC;AAYzC;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,OAAsB;IACjD,OAAO,IAAI,CAAC;QACV,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE;YACN,KAAK,EAAE,CAAC,2BAA2B,EAAE,uBAAuB,EAAE,eAAe,EAAE,SAAS,CAAC;YACzF,MAAM,EAAE,IAAI;SACb;QACD,GAAG,CAAC,OAAO,CAAC,MAAM;YAChB,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,cAAc,EAAE,EAAE,EAAE;YACtF,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,CAAC;AACL,CAAC"}

package/dist/observability/metrics.d.ts

@@ -0,0 +1,27 @@
+import { Registry } from "prom-client";
+/** A completed bridge command, observed for metrics. */
+export interface CommandObservation {
+    readonly kind: string;
+    readonly status: "ok" | "error";
+    readonly code?: string;
+    readonly durationMs: number;
+}
+/** Live values the queue gauges read at scrape time. */
+export interface MetricsCollectors {
+    readonly queueDepth: () => number;
+    readonly commandsInFlight: () => number;
+    readonly bridgeConnected: () => boolean;
+    readonly mcpSessions: () => number;
+}
+/** Records server events and renders the Prometheus exposition. */
+export interface Metrics {
+    /** The Prometheus registry, rendered by the `/metrics` route. */
+    readonly registry: Registry;
+    /** Records a completed HTTP request. */
+    recordHttpRequest(method: string, statusCode: number): void;
+    /** Records a completed bridge command. */
+    recordCommand(observation: CommandObservation): void;
+}
+/** Creates a {@link Metrics} façade backed by a private Prometheus registry. */
+export declare function createMetrics(collectors: MetricsCollectors): Metrics;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/observability/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/observability/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,QAAQ,EAAE,MAAM,aAAa,CAAC;AAElE,wDAAwD;AACxD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,wDAAwD;AACxD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,MAAM,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,MAAM,CAAC;IACxC,QAAQ,CAAC,eAAe,EAAE,MAAM,OAAO,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM,CAAC;CACpC;AAED,mEAAmE;AACnE,MAAM,WAAW,OAAO;IACtB,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,wCAAwC;IACxC,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5D,0CAA0C;IAC1C,aAAa,CAAC,WAAW,EAAE,kBAAkB,GAAG,IAAI,CAAC;CACtD;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAyEpE"}

package/dist/observability/metrics.js

@@ -0,0 +1,72 @@
+import { Counter, Gauge, Histogram, Registry } from "prom-client";
+/** Creates a {@link Metrics} façade backed by a private Prometheus registry. */
+export function createMetrics(collectors) {
+    const registry = new Registry();
+    const httpRequests = new Counter({
+        name: "bridge_http_requests_total",
+        help: "Total HTTP requests by method and response status.",
+        labelNames: ["method", "status"],
+        registers: [registry],
+    });
+    const commandDuration = new Histogram({
+        name: "bridge_command_duration_seconds",
+        help: "Bridge command round-trip duration by kind and status.",
+        labelNames: ["kind", "status"],
+        buckets: [0.05, 0.1, 0.25, 0.5, 1, 2, 5, 10, 15],
+        registers: [registry],
+    });
+    const commandResults = new Counter({
+        name: "bridge_command_results_total",
+        help: "Bridge command outcomes by kind, status, and error code.",
+        labelNames: ["kind", "status", "code"],
+        registers: [registry],
+    });
+    // Gauges sample live state through the collectors when the registry is scraped.
+    const _queueDepth = new Gauge({
+        name: "bridge_command_queue_depth",
+        help: "Commands enqueued but not yet dequeued.",
+        registers: [registry],
+        collect() {
+            this.set(collectors.queueDepth());
+        },
+    });
+    const _commandsInFlight = new Gauge({
+        name: "bridge_commands_in_flight",
+        help: "Commands dequeued but not yet settled.",
+        registers: [registry],
+        collect() {
+            this.set(collectors.commandsInFlight());
+        },
+    });
+    const _bridgeConnected = new Gauge({
+        name: "bridge_connected",
+        help: "Whether a behavior pack is connected (1) or not (0).",
+        registers: [registry],
+        collect() {
+            this.set(collectors.bridgeConnected() ? 1 : 0);
+        },
+    });
+    const _mcpSessions = new Gauge({
+        name: "bridge_mcp_sessions",
+        help: "Open MCP client sessions.",
+        registers: [registry],
+        collect() {
+            this.set(collectors.mcpSessions());
+        },
+    });
+    return {
+        registry,
+        recordHttpRequest(method, statusCode) {
+            httpRequests.inc({ method, status: String(statusCode) });
+        },
+        recordCommand(observation) {
+            commandDuration.observe({ kind: observation.kind, status: observation.status }, observation.durationMs / 1000);
+            commandResults.inc({
+                kind: observation.kind,
+                status: observation.status,
+                code: observation.code ?? "",
+            });
+        },
+    };
+}
+//# sourceMappingURL=metrics.js.map

package/dist/observability/metrics.js.map

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

package/dist/protocol/command.d.ts

@@ -0,0 +1,92 @@
+import { z } from "zod";
+/**
+ * Pattern for a command identifier: the literal `cmd_` followed by a 26-char
+ * Crockford base32 ULID.
+ */
+export declare const COMMAND_ID_PATTERN: RegExp;
+/** A command identifier, correlating a queued command with its result. */
+export declare const CommandIdSchema: z.ZodString;
+/**
+ * A single command delivered to the behavior pack via `GET /bridge/poll`.
+ *
+ * `payload` is intentionally opaque at the protocol layer; it is validated
+ * against the originating MCP tool's input schema before the command is
+ * enqueued.
+ */
+export declare const CommandSchema: z.ZodObject<{
+    /** Correlation identifier (`cmd_<ULID>`). */
+    id: z.ZodString;
+    /** Command kind — the MCP tool name, e.g. `mc_block_set`. */
+    kind: z.ZodString;
+    /** Command arguments, validated per-kind at the tool layer. */
+    payload: z.ZodUnknown;
+    /** ISO-8601 timestamp at which the server issued the command. */
+    issued_at: z.ZodString;
+    /** Milliseconds of execution budget remaining when the command was delivered. */
+    deadline_ms: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    kind: string;
+    issued_at: string;
+    deadline_ms: number;
+    payload?: unknown;
+}, {
+    id: string;
+    kind: string;
+    issued_at: string;
+    deadline_ms: number;
+    payload?: unknown;
+}>;
+/** A single command delivered to the behavior pack. */
+export type Command = z.infer<typeof CommandSchema>;
+/** The response envelope for `GET /bridge/poll`. */
+export declare const PollResponseSchema: z.ZodObject<{
+    /** Commands to execute; empty when the long poll timed out. */
+    commands: z.ZodArray<z.ZodObject<{
+        /** Correlation identifier (`cmd_<ULID>`). */
+        id: z.ZodString;
+        /** Command kind — the MCP tool name, e.g. `mc_block_set`. */
+        kind: z.ZodString;
+        /** Command arguments, validated per-kind at the tool layer. */
+        payload: z.ZodUnknown;
+        /** ISO-8601 timestamp at which the server issued the command. */
+        issued_at: z.ZodString;
+        /** Milliseconds of execution budget remaining when the command was delivered. */
+        deadline_ms: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        kind: string;
+        issued_at: string;
+        deadline_ms: number;
+        payload?: unknown;
+    }, {
+        id: string;
+        kind: string;
+        issued_at: string;
+        deadline_ms: number;
+        payload?: unknown;
+    }>, "many">;
+    /** ISO-8601 server timestamp, for behavior-pack clock-skew diagnostics. */
+    server_time: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    commands: {
+        id: string;
+        kind: string;
+        issued_at: string;
+        deadline_ms: number;
+        payload?: unknown;
+    }[];
+    server_time: string;
+}, {
+    commands: {
+        id: string;
+        kind: string;
+        issued_at: string;
+        deadline_ms: number;
+        payload?: unknown;
+    }[];
+    server_time: string;
+}>;
+/** The response envelope for `GET /bridge/poll`. */
+export type PollResponse = z.infer<typeof PollResponseSchema>;
+//# sourceMappingURL=command.d.ts.map

package/dist/protocol/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/protocol/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,kBAAkB,QAAiC,CAAC;AAEjE,0EAA0E;AAC1E,eAAO,MAAM,eAAe,aAEoC,CAAC;AAEjE;;;;;;GAMG;AACH,eAAO,MAAM,aAAa;IACxB,6CAA6C;;IAE7C,6DAA6D;;IAE7D,+DAA+D;;IAE/D,iEAAiE;;IAEjE,iFAAiF;;;;;;;;;;;;;;EAEjF,CAAC;AAEH,uDAAuD;AACvD,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD,oDAAoD;AACpD,eAAO,MAAM,kBAAkB;IAC7B,+DAA+D;;QAjB/D,6CAA6C;;QAE7C,6DAA6D;;QAE7D,+DAA+D;;QAE/D,iEAAiE;;QAEjE,iFAAiF;;;;;;;;;;;;;;;IAWjF,2EAA2E;;;;;;;;;;;;;;;;;;;;EAE3E,CAAC;AAEH,oDAAoD;AACpD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/protocol/command.js

@@ -0,0 +1,37 @@
+import { z } from "zod";
+/**
+ * Pattern for a command identifier: the literal `cmd_` followed by a 26-char
+ * Crockford base32 ULID.
+ */
+export const COMMAND_ID_PATTERN = /^cmd_[0-9A-HJKMNP-TV-Z]{26}$/;
+/** A command identifier, correlating a queued command with its result. */
+export const CommandIdSchema = z
+    .string()
+    .regex(COMMAND_ID_PATTERN, "expected a cmd_<ULID> identifier");
+/**
+ * A single command delivered to the behavior pack via `GET /bridge/poll`.
+ *
+ * `payload` is intentionally opaque at the protocol layer; it is validated
+ * against the originating MCP tool's input schema before the command is
+ * enqueued.
+ */
+export const CommandSchema = z.object({
+    /** Correlation identifier (`cmd_<ULID>`). */
+    id: CommandIdSchema,
+    /** Command kind — the MCP tool name, e.g. `mc_block_set`. */
+    kind: z.string().min(1),
+    /** Command arguments, validated per-kind at the tool layer. */
+    payload: z.unknown(),
+    /** ISO-8601 timestamp at which the server issued the command. */
+    issued_at: z.string().datetime(),
+    /** Milliseconds of execution budget remaining when the command was delivered. */
+    deadline_ms: z.number().int().positive(),
+});
+/** The response envelope for `GET /bridge/poll`. */
+export const PollResponseSchema = z.object({
+    /** Commands to execute; empty when the long poll timed out. */
+    commands: z.array(CommandSchema),
+    /** ISO-8601 server timestamp, for behavior-pack clock-skew diagnostics. */
+    server_time: z.string().datetime(),
+});
+//# sourceMappingURL=command.js.map

package/dist/protocol/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/protocol/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,8BAA8B,CAAC;AAEjE,0EAA0E;AAC1E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,EAAE;KACR,KAAK,CAAC,kBAAkB,EAAE,kCAAkC,CAAC,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,6CAA6C;IAC7C,EAAE,EAAE,eAAe;IACnB,6DAA6D;IAC7D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,+DAA+D;IAC/D,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,iEAAiE;IACjE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,iFAAiF;IACjF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CACzC,CAAC,CAAC;AAKH,oDAAoD;AACpD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,+DAA+D;IAC/D,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC;IAChC,2EAA2E;IAC3E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC"}

package/dist/protocol/event.d.ts

@@ -0,0 +1,82 @@
+import { z } from "zod";
+/**
+ * Pattern for a subscription identifier: the literal `sub_` followed by a
+ * 26-char Crockford base32 ULID.
+ */
+export declare const SUBSCRIPTION_ID_PATTERN: RegExp;
+/** A subscription identifier, issued by `mc_event_subscribe`. */
+export declare const SubscriptionIdSchema: z.ZodString;
+/**
+ * A world event observed by the behavior pack for an active subscription.
+ *
+ * The behavior pack does not assign an ordering cursor; the server stamps an
+ * ingest sequence as it buffers events, so `mc_event_poll` cursors stay under
+ * server control.
+ */
+export declare const BridgeEventSchema: z.ZodObject<{
+    /** The subscription this event belongs to. */
+    subscription_id: z.ZodString;
+    /** Event type, e.g. `playerJoin` or `blockBreak`. */
+    event_type: z.ZodString;
+    /** ISO-8601 timestamp at which the event occurred in-world. */
+    occurred_at: z.ZodString;
+    /** Event-specific data. */
+    payload: z.ZodUnknown;
+}, "strip", z.ZodTypeAny, {
+    subscription_id: string;
+    event_type: string;
+    occurred_at: string;
+    payload?: unknown;
+}, {
+    subscription_id: string;
+    event_type: string;
+    occurred_at: string;
+    payload?: unknown;
+}>;
+/** A world event observed by the behavior pack. */
+export type BridgeEvent = z.infer<typeof BridgeEventSchema>;
+/**
+ * The request envelope for `POST /bridge/event`.
+ *
+ * Events are batched: behavior packs fire bursts (e.g. `blockBreak`), and one
+ * HTTP request per event would overwhelm the bridge.
+ */
+export declare const EventReportSchema: z.ZodObject<{
+    events: z.ZodArray<z.ZodObject<{
+        /** The subscription this event belongs to. */
+        subscription_id: z.ZodString;
+        /** Event type, e.g. `playerJoin` or `blockBreak`. */
+        event_type: z.ZodString;
+        /** ISO-8601 timestamp at which the event occurred in-world. */
+        occurred_at: z.ZodString;
+        /** Event-specific data. */
+        payload: z.ZodUnknown;
+    }, "strip", z.ZodTypeAny, {
+        subscription_id: string;
+        event_type: string;
+        occurred_at: string;
+        payload?: unknown;
+    }, {
+        subscription_id: string;
+        event_type: string;
+        occurred_at: string;
+        payload?: unknown;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    events: {
+        subscription_id: string;
+        event_type: string;
+        occurred_at: string;
+        payload?: unknown;
+    }[];
+}, {
+    events: {
+        subscription_id: string;
+        event_type: string;
+        occurred_at: string;
+        payload?: unknown;
+    }[];
+}>;
+/** The request envelope for `POST /bridge/event`. */
+export type EventReport = z.infer<typeof EventReportSchema>;
+//# sourceMappingURL=event.d.ts.map

package/dist/protocol/event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../src/protocol/event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,uBAAuB,QAAiC,CAAC;AAEtE,iEAAiE;AACjE,eAAO,MAAM,oBAAoB,aAEoC,CAAC;AAEtE;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB;IAC5B,8CAA8C;;IAE9C,qDAAqD;;IAErD,+DAA+D;;IAE/D,2BAA2B;;;;;;;;;;;;EAE3B,CAAC;AAEH,mDAAmD;AACnD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;QAnB5B,8CAA8C;;QAE9C,qDAAqD;;QAErD,+DAA+D;;QAE/D,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;EAe3B,CAAC;AAEH,qDAAqD;AACrD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/protocol/event.js

@@ -0,0 +1,37 @@
+import { z } from "zod";
+/**
+ * Pattern for a subscription identifier: the literal `sub_` followed by a
+ * 26-char Crockford base32 ULID.
+ */
+export const SUBSCRIPTION_ID_PATTERN = /^sub_[0-9A-HJKMNP-TV-Z]{26}$/;
+/** A subscription identifier, issued by `mc_event_subscribe`. */
+export const SubscriptionIdSchema = z
+    .string()
+    .regex(SUBSCRIPTION_ID_PATTERN, "expected a sub_<ULID> identifier");
+/**
+ * A world event observed by the behavior pack for an active subscription.
+ *
+ * The behavior pack does not assign an ordering cursor; the server stamps an
+ * ingest sequence as it buffers events, so `mc_event_poll` cursors stay under
+ * server control.
+ */
+export const BridgeEventSchema = z.object({
+    /** The subscription this event belongs to. */
+    subscription_id: SubscriptionIdSchema,
+    /** Event type, e.g. `playerJoin` or `blockBreak`. */
+    event_type: z.string().min(1),
+    /** ISO-8601 timestamp at which the event occurred in-world. */
+    occurred_at: z.string().datetime(),
+    /** Event-specific data. */
+    payload: z.unknown(),
+});
+/**
+ * The request envelope for `POST /bridge/event`.
+ *
+ * Events are batched: behavior packs fire bursts (e.g. `blockBreak`), and one
+ * HTTP request per event would overwhelm the bridge.
+ */
+export const EventReportSchema = z.object({
+    events: z.array(BridgeEventSchema).min(1).max(256),
+});
+//# sourceMappingURL=event.js.map

package/dist/protocol/event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../src/protocol/event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,8BAA8B,CAAC;AAEtE,iEAAiE;AACjE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KAClC,MAAM,EAAE;KACR,KAAK,CAAC,uBAAuB,EAAE,kCAAkC,CAAC,CAAC;AAEtE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,8CAA8C;IAC9C,eAAe,EAAE,oBAAoB;IACrC,qDAAqD;IACrD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,+DAA+D;IAC/D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,2BAA2B;IAC3B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;CACrB,CAAC,CAAC;AAKH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;CACnD,CAAC,CAAC"}