minecraft-bedrock-mcp-server 0.1.0

package/dist/tools/inventory-tools.js

@@ -0,0 +1,52 @@
+import { z } from "zod";
+import { DimensionSchema, EntityIdSchema, ItemPropertiesSchema, ItemTypeSchema, Vector3Schema, } from "./common-schemas.js";
+import { defineQueuedTool } from "./tool-definition.js";
+/** A reference to an item container — an entity, or a block at a location. */
+const ContainerRefSchema = z.object({
+    entity_id: EntityIdSchema.optional(),
+    block: z.object({ dimension: DimensionSchema, location: Vector3Schema }).optional(),
+});
+/** Item spawning and container inventory access. */
+export const inventoryTools = [
+    defineQueuedTool({
+        name: "mc_item_spawn",
+        title: "Spawn an item",
+        description: "Spawns a dropped item entity at a location.",
+        inputShape: {
+            dimension: DimensionSchema,
+            item_type: ItemTypeSchema,
+            location: Vector3Schema,
+            count: z.number().int().positive().optional(),
+            properties: ItemPropertiesSchema.optional(),
+        },
+    }),
+    defineQueuedTool({
+        name: "mc_inventory_get",
+        title: "Get a container's inventory",
+        description: "Returns the items in an entity's or block's inventory.",
+        inputShape: { container: ContainerRefSchema },
+        annotations: { readOnlyHint: true },
+    }),
+    defineQueuedTool({
+        name: "mc_inventory_set_slot",
+        title: "Set an inventory slot",
+        description: "Places an item stack into a specific inventory slot.",
+        inputShape: {
+            container: ContainerRefSchema,
+            slot: z.number().int().nonnegative(),
+            item_type: ItemTypeSchema,
+            count: z.number().int().positive().optional(),
+            properties: ItemPropertiesSchema.optional(),
+        },
+    }),
+    defineQueuedTool({
+        name: "mc_inventory_clear_slot",
+        title: "Clear an inventory slot",
+        description: "Empties a specific inventory slot.",
+        inputShape: {
+            container: ContainerRefSchema,
+            slot: z.number().int().nonnegative(),
+        },
+    }),
+];
+//# sourceMappingURL=inventory-tools.js.map

package/dist/tools/inventory-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inventory-tools.js","sourceRoot":"","sources":["../../src/tools/inventory-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,aAAa,GACd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAuB,MAAM,sBAAsB,CAAC;AAE7E,8EAA8E;AAC9E,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,SAAS,EAAE,cAAc,CAAC,QAAQ,EAAE;IACpC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC,CAAC,QAAQ,EAAE;CACpF,CAAC,CAAC;AAEH,oDAAoD;AACpD,MAAM,CAAC,MAAM,cAAc,GAA8B;IACvD,gBAAgB,CAAC;QACf,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,6CAA6C;QAC1D,UAAU,EAAE;YACV,SAAS,EAAE,eAAe;YAC1B,SAAS,EAAE,cAAc;YACzB,QAAQ,EAAE,aAAa;YACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;YAC7C,UAAU,EAAE,oBAAoB,CAAC,QAAQ,EAAE;SAC5C;KACF,CAAC;IACF,gBAAgB,CAAC;QACf,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,6BAA6B;QACpC,WAAW,EAAE,wDAAwD;QACrE,UAAU,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE;QAC7C,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,CAAC;IACF,gBAAgB,CAAC;QACf,IAAI,EAAE,uBAAuB;QAC7B,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EAAE,sDAAsD;QACnE,UAAU,EAAE;YACV,SAAS,EAAE,kBAAkB;YAC7B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;YACpC,SAAS,EAAE,cAAc;YACzB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;YAC7C,UAAU,EAAE,oBAAoB,CAAC,QAAQ,EAAE;SAC5C;KACF,CAAC;IACF,gBAAgB,CAAC;QACf,IAAI,EAAE,yBAAyB;QAC/B,KAAK,EAAE,yBAAyB;QAChC,WAAW,EAAE,oCAAoC;QACjD,UAAU,EAAE;YACV,SAAS,EAAE,kBAAkB;YAC7B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;SACrC;KACF,CAAC;CACH,CAAC"}

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

@@ -0,0 +1,4 @@
+import { type ToolDefinition } from "./tool-definition.js";
+/** Player queries and player-specific mutations. */
+export declare const playerTools: readonly ToolDefinition[];
+//# sourceMappingURL=player-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"player-tools.d.ts","sourceRoot":"","sources":["../../src/tools/player-tools.ts"],"names":[],"mappings":"AAOA,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAI7E,oDAAoD;AACpD,eAAO,MAAM,WAAW,EAAE,SAAS,cAAc,EA8GhD,CAAC"}

package/dist/tools/player-tools.js

@@ -0,0 +1,117 @@
+import { z } from "zod";
+import { ItemPropertiesSchema, ItemTypeSchema, MessageSchema, Vector3Schema, } from "./common-schemas.js";
+import { defineQueuedTool } from "./tool-definition.js";
+const PlayerSchema = z.string().min(1).describe("Player name.");
+/** Player queries and player-specific mutations. */
+export const playerTools = [
+    defineQueuedTool({
+        name: "mc_player_list",
+        title: "List players",
+        description: "Returns the name, id, location, dimension, and game mode of every online player.",
+        inputShape: {},
+        annotations: { readOnlyHint: true },
+    }),
+    defineQueuedTool({
+        name: "mc_player_send_message",
+        title: "Send a message to a player",
+        description: "Sends a chat message to a single player.",
+        inputShape: { player: PlayerSchema, message: MessageSchema },
+    }),
+    defineQueuedTool({
+        name: "mc_player_send_title",
+        title: "Show a title to a player",
+        description: "Shows a title, and optional subtitle, on a player's screen.",
+        inputShape: {
+            player: PlayerSchema,
+            title: z.string(),
+            subtitle: z.string().optional(),
+            options: z
+                .object({
+                fade_in_ticks: z.number().int().nonnegative().optional(),
+                stay_ticks: z.number().int().nonnegative().optional(),
+                fade_out_ticks: z.number().int().nonnegative().optional(),
+            })
+                .optional(),
+        },
+    }),
+    defineQueuedTool({
+        name: "mc_player_send_actionbar",
+        title: "Show an action bar message",
+        description: "Shows a message on a player's action bar.",
+        inputShape: { player: PlayerSchema, text: z.string() },
+    }),
+    defineQueuedTool({
+        name: "mc_player_set_gamemode",
+        title: "Set a player's game mode",
+        description: "Sets a player's game mode.",
+        inputShape: {
+            player: PlayerSchema,
+            mode: z.enum(["survival", "creative", "adventure", "spectator"]),
+        },
+    }),
+    defineQueuedTool({
+        name: "mc_player_give_item",
+        title: "Give an item to a player",
+        description: "Adds an item stack to a player's inventory.",
+        inputShape: {
+            player: PlayerSchema,
+            item_type: ItemTypeSchema,
+            count: z.number().int().positive().optional(),
+            properties: ItemPropertiesSchema.optional(),
+        },
+    }),
+    defineQueuedTool({
+        name: "mc_player_clear_inventory",
+        title: "Clear a player's inventory",
+        description: "Removes every item from a player's inventory.",
+        inputShape: { player: PlayerSchema },
+        annotations: { destructiveHint: true },
+    }),
+    defineQueuedTool({
+        name: "mc_player_get_inventory",
+        title: "Get a player's inventory",
+        description: "Returns the contents of a player's inventory.",
+        inputShape: { player: PlayerSchema },
+        annotations: { readOnlyHint: true },
+    }),
+    defineQueuedTool({
+        name: "mc_player_set_camera",
+        title: "Set a player's camera",
+        description: "Sets a player's camera to a preset, or to a fixed location and orientation.",
+        inputShape: {
+            player: PlayerSchema,
+            options: z.object({
+                preset: z.string().optional().describe("Camera preset id, e.g. minecraft:free."),
+                location: Vector3Schema.optional(),
+                rotation: z.object({ x: z.number(), y: z.number() }).optional(),
+                facing_location: Vector3Schema.optional(),
+                ease_seconds: z.number().nonnegative().optional(),
+                ease_type: z.string().optional(),
+            }),
+        },
+    }),
+    defineQueuedTool({
+        name: "mc_player_play_sound",
+        title: "Play a sound for a player",
+        description: "Plays a sound for a single player.",
+        inputShape: {
+            player: PlayerSchema,
+            sound: z.string().min(1),
+            options: z
+                .object({
+                location: Vector3Schema.optional(),
+                volume: z.number().nonnegative().optional(),
+                pitch: z.number().positive().optional(),
+            })
+                .optional(),
+        },
+    }),
+    defineQueuedTool({
+        name: "mc_player_kick",
+        title: "Kick a player",
+        description: "Disconnects a player from the server.",
+        inputShape: { player: PlayerSchema, reason: z.string().optional() },
+        annotations: { destructiveHint: true },
+    }),
+];
+//# sourceMappingURL=player-tools.js.map

package/dist/tools/player-tools.js.map

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

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

@@ -0,0 +1,4 @@
+import { type ToolDefinition } from "./tool-definition.js";
+/** Persistent dynamic-property storage. */
+export declare const propertyTools: readonly ToolDefinition[];
+//# sourceMappingURL=property-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"property-tools.d.ts","sourceRoot":"","sources":["../../src/tools/property-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAQ7E,2CAA2C;AAC3C,eAAO,MAAM,aAAa,EAAE,SAAS,cAAc,EAmClD,CAAC"}

package/dist/tools/property-tools.js

@@ -0,0 +1,45 @@
+import { z } from "zod";
+import { EntityIdSchema, Vector3Schema } from "./common-schemas.js";
+import { defineQueuedTool } from "./tool-definition.js";
+/** The scope a dynamic property is stored on — the world, or an entity. */
+const PropertyScopeSchema = z.union([z.literal("world"), z.object({ entity_id: EntityIdSchema })]);
+/** A dynamic property value. */
+const PropertyValueSchema = z.union([z.string(), z.number(), z.boolean(), Vector3Schema]);
+/** Persistent dynamic-property storage. */
+export const propertyTools = [
+    defineQueuedTool({
+        name: "mc_property_get",
+        title: "Get a dynamic property",
+        description: "Returns a dynamic property stored on the world or an entity.",
+        inputShape: { scope: PropertyScopeSchema, name: z.string().min(1) },
+        annotations: { readOnlyHint: true },
+    }),
+    defineQueuedTool({
+        name: "mc_property_set",
+        title: "Set a dynamic property",
+        description: "Stores a dynamic property on the world or an entity.",
+        inputShape: {
+            scope: PropertyScopeSchema,
+            name: z.string().min(1),
+            value: PropertyValueSchema,
+        },
+    }),
+    defineQueuedTool({
+        name: "mc_property_list",
+        title: "List dynamic properties",
+        description: "Returns the names of every dynamic property in a scope.",
+        inputShape: { scope: PropertyScopeSchema },
+        annotations: { readOnlyHint: true },
+    }),
+    defineQueuedTool({
+        name: "mc_property_clear",
+        title: "Clear dynamic properties",
+        description: "Removes one dynamic property, or every property in a scope.",
+        inputShape: {
+            scope: PropertyScopeSchema,
+            name: z.string().min(1).optional().describe("Omit to clear every property in the scope."),
+        },
+        annotations: { destructiveHint: true },
+    }),
+];
+//# sourceMappingURL=property-tools.js.map

package/dist/tools/property-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-tools.js","sourceRoot":"","sources":["../../src/tools/property-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAuB,MAAM,sBAAsB,CAAC;AAE7E,2EAA2E;AAC3E,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC;AAEnG,gCAAgC;AAChC,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;AAE1F,2CAA2C;AAC3C,MAAM,CAAC,MAAM,aAAa,GAA8B;IACtD,gBAAgB,CAAC;QACf,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EAAE,8DAA8D;QAC3E,UAAU,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QACnE,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,CAAC;IACF,gBAAgB,CAAC;QACf,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EAAE,sDAAsD;QACnE,UAAU,EAAE;YACV,KAAK,EAAE,mBAAmB;YAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YACvB,KAAK,EAAE,mBAAmB;SAC3B;KACF,CAAC;IACF,gBAAgB,CAAC;QACf,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,yBAAyB;QAChC,WAAW,EAAE,yDAAyD;QACtE,UAAU,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE;QAC1C,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,CAAC;IACF,gBAAgB,CAAC;QACf,IAAI,EAAE,mBAAmB;QACzB,KAAK,EAAE,0BAA0B;QACjC,WAAW,EAAE,6DAA6D;QAC1E,UAAU,EAAE;YACV,KAAK,EAAE,mBAAmB;YAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;SAC1F;QACD,WAAW,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;KACvC,CAAC;CACH,CAAC"}

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

@@ -0,0 +1,4 @@
+import { type ToolDefinition } from "./tool-definition.js";
+/** Scoreboard objective and score operations. */
+export declare const scoreboardTools: readonly ToolDefinition[];
+//# sourceMappingURL=scoreboard-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scoreboard-tools.d.ts","sourceRoot":"","sources":["../../src/tools/scoreboard-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAK7E,iDAAiD;AACjD,eAAO,MAAM,eAAe,EAAE,SAAS,cAAc,EA6DpD,CAAC"}

package/dist/tools/scoreboard-tools.js

@@ -0,0 +1,68 @@
+import { z } from "zod";
+import { defineQueuedTool } from "./tool-definition.js";
+const ObjectiveSchema = z.string().min(1).describe("Scoreboard objective id.");
+const ParticipantSchema = z.string().min(1).describe("A player name or other scoreboard identity.");
+/** Scoreboard objective and score operations. */
+export const scoreboardTools = [
+    defineQueuedTool({
+        name: "mc_scoreboard_list_objectives",
+        title: "List scoreboard objectives",
+        description: "Returns every scoreboard objective.",
+        inputShape: {},
+        annotations: { readOnlyHint: true },
+    }),
+    defineQueuedTool({
+        name: "mc_scoreboard_add_objective",
+        title: "Add a scoreboard objective",
+        description: "Creates a scoreboard objective.",
+        inputShape: {
+            id: ObjectiveSchema,
+            display_name: z.string().optional(),
+            criteria: z.string().optional().describe("Objective criteria; defaults to dummy."),
+        },
+    }),
+    defineQueuedTool({
+        name: "mc_scoreboard_remove_objective",
+        title: "Remove a scoreboard objective",
+        description: "Deletes a scoreboard objective.",
+        inputShape: { id: ObjectiveSchema },
+        annotations: { destructiveHint: true },
+    }),
+    defineQueuedTool({
+        name: "mc_scoreboard_get_score",
+        title: "Get a score",
+        description: "Returns a participant's score for an objective.",
+        inputShape: { objective: ObjectiveSchema, participant: ParticipantSchema },
+        annotations: { readOnlyHint: true },
+    }),
+    defineQueuedTool({
+        name: "mc_scoreboard_set_score",
+        title: "Set a score",
+        description: "Sets a participant's score for an objective.",
+        inputShape: {
+            objective: ObjectiveSchema,
+            participant: ParticipantSchema,
+            score: z.number().int(),
+        },
+    }),
+    defineQueuedTool({
+        name: "mc_scoreboard_add_score",
+        title: "Add to a score",
+        description: "Adds an amount to a participant's score; pass a negative amount to subtract.",
+        inputShape: {
+            objective: ObjectiveSchema,
+            participant: ParticipantSchema,
+            amount: z.number().int(),
+        },
+    }),
+    defineQueuedTool({
+        name: "mc_scoreboard_reset_participant",
+        title: "Reset a participant",
+        description: "Removes a participant's scores, from one objective or from all of them.",
+        inputShape: {
+            participant: ParticipantSchema,
+            objective: ObjectiveSchema.optional().describe("Omit to reset across every objective."),
+        },
+    }),
+];
+//# sourceMappingURL=scoreboard-tools.js.map

package/dist/tools/scoreboard-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoreboard-tools.js","sourceRoot":"","sources":["../../src/tools/scoreboard-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAuB,MAAM,sBAAsB,CAAC;AAE7E,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC,CAAC;AAC/E,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,6CAA6C,CAAC,CAAC;AAEpG,iDAAiD;AACjD,MAAM,CAAC,MAAM,eAAe,GAA8B;IACxD,gBAAgB,CAAC;QACf,IAAI,EAAE,+BAA+B;QACrC,KAAK,EAAE,4BAA4B;QACnC,WAAW,EAAE,qCAAqC;QAClD,UAAU,EAAE,EAAE;QACd,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,CAAC;IACF,gBAAgB,CAAC;QACf,IAAI,EAAE,6BAA6B;QACnC,KAAK,EAAE,4BAA4B;QACnC,WAAW,EAAE,iCAAiC;QAC9C,UAAU,EAAE;YACV,EAAE,EAAE,eAAe;YACnB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACnC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;SACnF;KACF,CAAC;IACF,gBAAgB,CAAC;QACf,IAAI,EAAE,gCAAgC;QACtC,KAAK,EAAE,+BAA+B;QACtC,WAAW,EAAE,iCAAiC;QAC9C,UAAU,EAAE,EAAE,EAAE,EAAE,eAAe,EAAE;QACnC,WAAW,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;KACvC,CAAC;IACF,gBAAgB,CAAC;QACf,IAAI,EAAE,yBAAyB;QAC/B,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,iDAAiD;QAC9D,UAAU,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,iBAAiB,EAAE;QAC1E,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,CAAC;IACF,gBAAgB,CAAC;QACf,IAAI,EAAE,yBAAyB;QAC/B,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,8CAA8C;QAC3D,UAAU,EAAE;YACV,SAAS,EAAE,eAAe;YAC1B,WAAW,EAAE,iBAAiB;YAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;SACxB;KACF,CAAC;IACF,gBAAgB,CAAC;QACf,IAAI,EAAE,yBAAyB;QAC/B,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,8EAA8E;QAC3F,UAAU,EAAE;YACV,SAAS,EAAE,eAAe;YAC1B,WAAW,EAAE,iBAAiB;YAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;SACzB;KACF,CAAC;IACF,gBAAgB,CAAC;QACf,IAAI,EAAE,iCAAiC;QACvC,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,yEAAyE;QACtF,UAAU,EAAE;YACV,WAAW,EAAE,iBAAiB;YAC9B,SAAS,EAAE,eAAe,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;SACxF;KACF,CAAC;CACH,CAAC"}

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

@@ -0,0 +1,4 @@
+import { type ToolDefinition } from "./tool-definition.js";
+/** Server administration. */
+export declare const serverTools: readonly ToolDefinition[];
+//# sourceMappingURL=server-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server-tools.d.ts","sourceRoot":"","sources":["../../src/tools/server-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE7E,6BAA6B;AAC7B,eAAO,MAAM,WAAW,EAAE,SAAS,cAAc,EAqBhD,CAAC"}

package/dist/tools/server-tools.js

@@ -0,0 +1,25 @@
+import { defineQueuedTool } from "./tool-definition.js";
+/** Server administration. */
+export const serverTools = [
+    defineQueuedTool({
+        name: "mc_server_reload_addons",
+        title: "Reload addons",
+        description: "Reloads behavior and resource pack scripts and functions — the /reload command.",
+        inputShape: {},
+    }),
+    defineQueuedTool({
+        name: "mc_server_save_world",
+        title: "Save the world",
+        description: "Forces the world to save to disk.",
+        inputShape: {},
+        annotations: { idempotentHint: true },
+    }),
+    defineQueuedTool({
+        name: "mc_server_get_status",
+        title: "Get server status",
+        description: "Returns uptime, online player count, and an approximate ticks-per-second.",
+        inputShape: {},
+        annotations: { readOnlyHint: true },
+    }),
+];
+//# sourceMappingURL=server-tools.js.map

package/dist/tools/server-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-tools.js","sourceRoot":"","sources":["../../src/tools/server-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAuB,MAAM,sBAAsB,CAAC;AAE7E,6BAA6B;AAC7B,MAAM,CAAC,MAAM,WAAW,GAA8B;IACpD,gBAAgB,CAAC;QACf,IAAI,EAAE,yBAAyB;QAC/B,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,iFAAiF;QAC9F,UAAU,EAAE,EAAE;KACf,CAAC;IACF,gBAAgB,CAAC;QACf,IAAI,EAAE,sBAAsB;QAC5B,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,mCAAmC;QAChD,UAAU,EAAE,EAAE;QACd,WAAW,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE;KACtC,CAAC;IACF,gBAAgB,CAAC;QACf,IAAI,EAAE,sBAAsB;QAC5B,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,2EAA2E;QACxF,UAAU,EAAE,EAAE;QACd,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,CAAC;CACH,CAAC"}

package/dist/tools/structure-file-tools.d.ts

@@ -0,0 +1,4 @@
+import { type ToolDefinition } from "./tool-definition.js";
+/** Filesystem operations on `.mcstructure` files — these run on the MCP host. */
+export declare const structureFileTools: readonly ToolDefinition[];
+//# sourceMappingURL=structure-file-tools.d.ts.map

package/dist/tools/structure-file-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure-file-tools.d.ts","sourceRoot":"","sources":["../../src/tools/structure-file-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG5E,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,EAAE,SAAS,cAAc,EAoDvD,CAAC"}

package/dist/tools/structure-file-tools.js

@@ -0,0 +1,57 @@
+import { z } from "zod";
+import { defineLocalTool } from "./tool-definition.js";
+import { toolError, toolSuccess } from "./tool-result.js";
+/** Filesystem operations on `.mcstructure` files — these run on the MCP host. */
+export const structureFileTools = [
+    defineLocalTool({
+        name: "mc_structure_file_list",
+        title: "List structure files",
+        description: "Lists the .mcstructure files in the behavior pack's structures folder.",
+        inputShape: {},
+        annotations: { readOnlyHint: true },
+        handler: async (_input, context) => {
+            const files = await context.structureFiles.list();
+            return toolSuccess({ files });
+        },
+    }),
+    defineLocalTool({
+        name: "mc_structure_file_read",
+        title: "Read a structure file",
+        description: "Reads a .mcstructure file and returns its base64-encoded contents.",
+        inputShape: { name: z.string().min(1) },
+        annotations: { readOnlyHint: true },
+        handler: async (input, context) => {
+            const data = await context.structureFiles.read(input.name);
+            return toolSuccess({ name: input.name, base64_data: data.toString("base64") });
+        },
+    }),
+    defineLocalTool({
+        name: "mc_structure_file_write",
+        title: "Write a structure file",
+        description: "Writes a .mcstructure file from base64-encoded contents — for placing " +
+            "externally generated structures into the behavior pack.",
+        inputShape: {
+            name: z.string().min(1),
+            base64_data: z.string().describe("The .mcstructure file contents, base64-encoded."),
+        },
+        handler: async (input, context) => {
+            const data = Buffer.from(input.base64_data, "base64");
+            const info = await context.structureFiles.write(input.name, data);
+            return toolSuccess(info);
+        },
+    }),
+    defineLocalTool({
+        name: "mc_structure_file_delete",
+        title: "Delete a structure file",
+        description: "Deletes a .mcstructure file from the behavior pack's structures folder.",
+        inputShape: { name: z.string().min(1) },
+        annotations: { destructiveHint: true },
+        handler: async (input, context) => {
+            const deleted = await context.structureFiles.remove(input.name);
+            return deleted
+                ? toolSuccess({ name: input.name, deleted: true })
+                : toolError("NOT_FOUND", `no structure file '${input.name}'`);
+        },
+    }),
+];
+//# sourceMappingURL=structure-file-tools.js.map

package/dist/tools/structure-file-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure-file-tools.js","sourceRoot":"","sources":["../../src/tools/structure-file-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAuB,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE1D,iFAAiF;AACjF,MAAM,CAAC,MAAM,kBAAkB,GAA8B;IAC3D,eAAe,CAAC;QACd,IAAI,EAAE,wBAAwB;QAC9B,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE,wEAAwE;QACrF,UAAU,EAAE,EAAE;QACd,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;QACnC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;YACjC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;YAClD,OAAO,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAChC,CAAC;KACF,CAAC;IACF,eAAe,CAAC;QACd,IAAI,EAAE,wBAAwB;QAC9B,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EAAE,oEAAoE;QACjF,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QACvC,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;QACnC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YAChC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3D,OAAO,WAAW,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACjF,CAAC;KACF,CAAC;IACF,eAAe,CAAC;QACd,IAAI,EAAE,yBAAyB;QAC/B,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EACT,wEAAwE;YACxE,yDAAyD;QAC3D,UAAU,EAAE;YACV,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YACvB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;SACpF;QACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YAChC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YACtD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAClE,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;KACF,CAAC;IACF,eAAe,CAAC;QACd,IAAI,EAAE,0BAA0B;QAChC,KAAK,EAAE,yBAAyB;QAChC,WAAW,EAAE,yEAAyE;QACtF,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QACvC,WAAW,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;QACtC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YAChC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAChE,OAAO,OAAO;gBACZ,CAAC,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;gBAClD,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,sBAAsB,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;QAClE,CAAC;KACF,CAAC;CACH,CAAC"}

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

@@ -0,0 +1,4 @@
+import { type ToolDefinition } from "./tool-definition.js";
+/** Script API `StructureManager` operations. */
+export declare const structureTools: readonly ToolDefinition[];
+//# sourceMappingURL=structure-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"structure-tools.d.ts","sourceRoot":"","sources":["../../src/tools/structure-tools.ts"],"names":[],"mappings":"AAOA,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAO7E,gDAAgD;AAChD,eAAO,MAAM,cAAc,EAAE,SAAS,cAAc,EAiFnD,CAAC"}

package/dist/tools/structure-tools.js

@@ -0,0 +1,91 @@
+import { z } from "zod";
+import { BlockStatesSchema, BlockTypeSchema, DimensionSchema, Vector3Schema, } from "./common-schemas.js";
+import { defineQueuedTool } from "./tool-definition.js";
+const StructureIdSchema = z
+    .string()
+    .min(1)
+    .describe("Structure identifier, e.g. mystructures:house.");
+/** Script API `StructureManager` operations. */
+export const structureTools = [
+    defineQueuedTool({
+        name: "mc_structure_list",
+        title: "List structures",
+        description: "Returns the ids of all in-memory and world-saved structures.",
+        inputShape: {},
+        annotations: { readOnlyHint: true },
+    }),
+    defineQueuedTool({
+        name: "mc_structure_get",
+        title: "Get structure metadata",
+        description: "Returns metadata for a structure, such as its size.",
+        inputShape: { id: StructureIdSchema },
+        annotations: { readOnlyHint: true },
+    }),
+    defineQueuedTool({
+        name: "mc_structure_create_empty",
+        title: "Create an empty structure",
+        description: "Creates a new, empty structure of a given size.",
+        inputShape: {
+            id: StructureIdSchema,
+            size: Vector3Schema,
+            save_mode: z.enum(["memory", "world"]).optional(),
+        },
+    }),
+    defineQueuedTool({
+        name: "mc_structure_create_from_world",
+        title: "Capture a structure from the world",
+        description: "Captures the blocks in a bounding box into a new structure.",
+        inputShape: {
+            id: StructureIdSchema,
+            dimension: DimensionSchema,
+            from: Vector3Schema,
+            to: Vector3Schema,
+            options: z
+                .object({
+                include_entities: z.boolean().optional(),
+                include_blocks: z.boolean().optional(),
+                save_mode: z.enum(["memory", "world"]).optional(),
+            })
+                .optional(),
+        },
+    }),
+    defineQueuedTool({
+        name: "mc_structure_place",
+        title: "Place a structure",
+        description: "Places a saved structure into the world.",
+        inputShape: {
+            id: StructureIdSchema,
+            dimension: DimensionSchema,
+            location: Vector3Schema,
+            options: z
+                .object({
+                rotation: z.enum(["None", "Rotate90", "Rotate180", "Rotate270"]).optional(),
+                mirror: z.enum(["None", "X", "Z", "XZ"]).optional(),
+                integrity: z.number().min(0).max(1).optional(),
+                include_entities: z.boolean().optional(),
+                animation_mode: z.enum(["None", "Layers", "Blocks"]).optional(),
+                animation_seconds: z.number().nonnegative().optional(),
+            })
+                .optional(),
+        },
+    }),
+    defineQueuedTool({
+        name: "mc_structure_delete",
+        title: "Delete a structure",
+        description: "Deletes a structure from memory and the world.",
+        inputShape: { id: StructureIdSchema },
+        annotations: { destructiveHint: true },
+    }),
+    defineQueuedTool({
+        name: "mc_structure_set_block",
+        title: "Edit a structure block",
+        description: "Sets a block within an in-memory structure.",
+        inputShape: {
+            id: StructureIdSchema,
+            location: Vector3Schema,
+            block_type: BlockTypeSchema,
+            states: BlockStatesSchema.optional(),
+        },
+    }),
+];
+//# sourceMappingURL=structure-tools.js.map

package/dist/tools/structure-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure-tools.js","sourceRoot":"","sources":["../../src/tools/structure-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,aAAa,GACd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAuB,MAAM,sBAAsB,CAAC;AAE7E,MAAM,iBAAiB,GAAG,CAAC;KACxB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,CAAC,gDAAgD,CAAC,CAAC;AAE9D,gDAAgD;AAChD,MAAM,CAAC,MAAM,cAAc,GAA8B;IACvD,gBAAgB,CAAC;QACf,IAAI,EAAE,mBAAmB;QACzB,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,8DAA8D;QAC3E,UAAU,EAAE,EAAE;QACd,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,CAAC;IACF,gBAAgB,CAAC;QACf,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EAAE,qDAAqD;QAClE,UAAU,EAAE,EAAE,EAAE,EAAE,iBAAiB,EAAE;QACrC,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,CAAC;IACF,gBAAgB,CAAC;QACf,IAAI,EAAE,2BAA2B;QACjC,KAAK,EAAE,2BAA2B;QAClC,WAAW,EAAE,iDAAiD;QAC9D,UAAU,EAAE;YACV,EAAE,EAAE,iBAAiB;YACrB,IAAI,EAAE,aAAa;YACnB,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE;SAClD;KACF,CAAC;IACF,gBAAgB,CAAC;QACf,IAAI,EAAE,gCAAgC;QACtC,KAAK,EAAE,oCAAoC;QAC3C,WAAW,EAAE,6DAA6D;QAC1E,UAAU,EAAE;YACV,EAAE,EAAE,iBAAiB;YACrB,SAAS,EAAE,eAAe;YAC1B,IAAI,EAAE,aAAa;YACnB,EAAE,EAAE,aAAa;YACjB,OAAO,EAAE,CAAC;iBACP,MAAM,CAAC;gBACN,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;gBACxC,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;gBACtC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE;aAClD,CAAC;iBACD,QAAQ,EAAE;SACd;KACF,CAAC;IACF,gBAAgB,CAAC;QACf,IAAI,EAAE,oBAAoB;QAC1B,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,0CAA0C;QACvD,UAAU,EAAE;YACV,EAAE,EAAE,iBAAiB;YACrB,SAAS,EAAE,eAAe;YAC1B,QAAQ,EAAE,aAAa;YACvB,OAAO,EAAE,CAAC;iBACP,MAAM,CAAC;gBACN,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE;gBAC3E,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE;gBACnD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;gBAC9C,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;gBACxC,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;gBAC/D,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;aACvD,CAAC;iBACD,QAAQ,EAAE;SACd;KACF,CAAC;IACF,gBAAgB,CAAC;QACf,IAAI,EAAE,qBAAqB;QAC3B,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,gDAAgD;QAC7D,UAAU,EAAE,EAAE,EAAE,EAAE,iBAAiB,EAAE;QACrC,WAAW,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;KACvC,CAAC;IACF,gBAAgB,CAAC;QACf,IAAI,EAAE,wBAAwB;QAC9B,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EAAE,6CAA6C;QAC1D,UAAU,EAAE;YACV,EAAE,EAAE,iBAAiB;YACrB,QAAQ,EAAE,aAAa;YACvB,UAAU,EAAE,eAAe;YAC3B,MAAM,EAAE,iBAAiB,CAAC,QAAQ,EAAE;SACrC;KACF,CAAC;CACH,CAAC"}

package/dist/tools/tool-definition.d.ts

@@ -0,0 +1,68 @@
+import type { z, ZodRawShape } from "zod";
+import type { CallToolResult, ToolAnnotations } from "@modelcontextprotocol/sdk/types.js";
+import type { SubscriptionRegistry } from "../events/subscription-registry.js";
+import type { Logger } from "../observability/logger.js";
+import type { CommandQueue } from "../queue/command-queue.js";
+import type { StructureFileStore } from "../structures/structure-file-store.js";
+/** Services and per-invocation context available to every tool handler. */
+export interface ToolContext {
+    readonly queue: CommandQueue;
+    readonly subscriptions: SubscriptionRegistry;
+    readonly structureFiles: StructureFileStore;
+    readonly logger: Logger;
+    /** Correlates this invocation across logs and any command it enqueues. */
+    readonly correlationId: string;
+    /** How long a routed command awaits a behavior-pack result. */
+    readonly commandTimeoutMs: number;
+    /** Aborts when the MCP client cancels the request. */
+    readonly signal: AbortSignal;
+}
+/** A tool handler's return — a result, possibly produced asynchronously. */
+export type ToolOutcome = CallToolResult | Promise<CallToolResult>;
+/**
+ * A registered MCP tool: its schema, metadata, and handler.
+ *
+ * The generic input shape is erased here; {@link defineQueuedTool} and
+ * {@link defineLocalTool} preserve it while a handler is authored.
+ */
+export interface ToolDefinition {
+    readonly name: string;
+    readonly title: string;
+    readonly description: string;
+    readonly inputShape: ZodRawShape;
+    readonly annotations?: ToolAnnotations;
+    readonly handler: (input: unknown, context: ToolContext) => ToolOutcome;
+}
+type InputOf<Shape extends ZodRawShape> = z.infer<z.ZodObject<Shape>>;
+/** Configuration for a tool that routes through the command queue. */
+export interface QueuedToolConfig<Shape extends ZodRawShape> {
+    readonly name: string;
+    readonly title: string;
+    readonly description: string;
+    readonly inputShape: Shape;
+    readonly annotations?: ToolAnnotations;
+    /** Maps validated input to the bridge command payload. Defaults to identity. */
+    readonly toPayload?: (input: InputOf<Shape>) => unknown;
+}
+/**
+ * Defines a tool whose handler validates input, enqueues a command whose
+ * `kind` is the tool name, awaits the behavior pack's result, and returns it
+ * as a consistent tool envelope.
+ */
+export declare function defineQueuedTool<Shape extends ZodRawShape>(config: QueuedToolConfig<Shape>): ToolDefinition;
+/** Configuration for a tool whose handler runs on the MCP server host. */
+export interface LocalToolConfig<Shape extends ZodRawShape> {
+    readonly name: string;
+    readonly title: string;
+    readonly description: string;
+    readonly inputShape: Shape;
+    readonly annotations?: ToolAnnotations;
+    readonly handler: (input: InputOf<Shape>, context: ToolContext) => ToolOutcome;
+}
+/**
+ * Defines a tool whose handler runs locally — filesystem operations, or tools
+ * that work directly with the subscription registry.
+ */
+export declare function defineLocalTool<Shape extends ZodRawShape>(config: LocalToolConfig<Shape>): ToolDefinition;
+export {};
+//# sourceMappingURL=tool-definition.d.ts.map

package/dist/tools/tool-definition.d.ts.map

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