@godot-mcp/mcp-server 0.0.0 → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Godot MCP contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,106 @@
-# @godot-mcp/mcp-server
+# Godot MCP
 
-Namespace bootstrap only. Install the first supported release from the `latest` tag.
+Godot MCP is an open-source, security-first MCP server and Godot editor addon. Phase 7 provides reversible installation, authenticated Godot 4.7 editor attachment, six default observe-only tools, explicitly gated runtime/input surfaces, permission-scoped editor authoring, native read-only GDScript debugging, and bounded structured performance evidence.
+
+## Requirements
+
+- macOS (the currently certified platform)
+- Node.js 22
+- pnpm 11.13.0
+- Godot 4.7 stable
+
+Compatibility is evidence-gated by `release/compatibility-matrix.json`. Godot 4.4–4.6 and Linux/Windows remain experimental until their exact matrix cells carry trusted certification receipts; pending cells are not advertised as supported.
+
+## Source quick start
+
+```bash
+pnpm install --frozen-lockfile
+pnpm build
+node /absolute/path/to/godot-mcp/packages/cli/dist/bin.js init --project /absolute/path/to/godot-project
+node /absolute/path/to/godot-mcp/packages/cli/dist/bin.js doctor --project /absolute/path/to/godot-project
+node /absolute/path/to/godot-mcp/packages/cli/dist/bin.js editor --project /absolute/path/to/godot-project
+```
+
+For a verified release-to-release replacement, run `godot-mcp upgrade --project /absolute/path/to/godot-project --source /absolute/path/to/new/addons/godot_mcp`. Upgrade and rollback refuse independently modified installed files and preserve the original uninstall preimage.
+
+Use the `editor` command for the Phase 7-certified launch. It writes a short-lived owner-only startup attestation, then starts Godot with the authenticated editor debugger and native DAP assigned to one loopback port; the debugger binds first, so unauthenticated DAP never acquires a listener. The addon consumes the attestation and connects outward only when a matching MCP runtime publishes a short-lived pairing descriptor. Opening the project through another launcher keeps earlier editor features available, but runtime debugging fails closed because secure startup cannot be proven by copied user arguments alone.
+
+Register the source checkout with Codex using absolute paths:
+
+```bash
+codex mcp add godot -- node /absolute/path/to/godot-mcp/packages/cli/dist/bin.js connect --project /absolute/path/to/godot-project
+```
+
+The default registration remains observe-only. To opt into one MCP-owned instrumented runtime, explicitly grant both its tier and pack:
+
+```bash
+codex mcp add godot-runtime -- node /absolute/path/to/godot-mcp/packages/cli/dist/bin.js connect --project /absolute/path/to/godot-project --grant runtime_control --pack runtime
+```
+
+To launch and automate the owned runtime, grant the input pack separately:
+
+```bash
+codex mcp add godot-runtime-input -- node /absolute/path/to/godot-mcp/packages/cli/dist/bin.js connect --project /absolute/path/to/godot-project --grant runtime_control --pack runtime --pack input
+```
+
+To preview and apply bounded editor mutations, explicitly grant both the mutation tier and editor pack:
+
+```bash
+codex mcp add godot-editor -- node /absolute/path/to/godot-mcp/packages/cli/dist/bin.js connect --project /absolute/path/to/godot-project --grant project_mutate --pack editor
+```
+
+Start a fresh Codex task after registration so the newly registered MCP server is exposed. To stop using the addon while retaining its files, or remove the verified installation completely:
+
+```bash
+node /absolute/path/to/godot-mcp/packages/cli/dist/bin.js disable --project /absolute/path/to/godot-project
+node /absolute/path/to/godot-mcp/packages/cli/dist/bin.js uninstall --project /absolute/path/to/godot-project
+```
+
+Uninstall refuses to remove the addon, project configuration, or `project.godot` if they changed independently after installation.
+
+## Implemented MCP tools
+
+- `godot_session` — attachment, project identity, versions, and grants
+- `godot_capabilities` — currently visible observe/core capabilities
+- `godot_doctor` — installation, plugin, identity, and attachment diagnostics
+- `godot_help` — built-in usage and security-boundary help
+- `godot_query` — bounded editor state, open scene/tree/node metadata, indexed resources, approved project settings, and redacted diagnostics
+- `godot_capture` — bounded PNG from the current 2D or selected 3D editor viewport, returned as MCP image content and persisted as session evidence
+
+The default six tools are read-only and closed-world. A runtime-authorized session additionally exposes:
+
+- `godot_runtime` — launch, bounded runtime queries/control, native GDScript breakpoints/stacks/variables/selector watches, monitor snapshots, and cancellable structured profiles for one authenticated child runtime
+- `godot_runtime_capture` — one to eight ordered running-game PNG frames with verified evidence metadata
+- `godot_input` — bounded events, frame-indexed sequences, non-passive recording, and deterministic replay for the owned runtime
+- `godot_editor` — preview, apply, undo, and redo one bounded scene/node/resource/source authoring batch with durable idempotency and native editor history
+
+For example:
+
+```json
+{ "operation": "scene_tree", "scenePath": "res://main.tscn", "maxDepth": 8, "maxNodes": 250 }
+{ "viewport": "2d", "maxWidth": 1280, "maxHeight": 720 }
+{ "operation": "launch", "scenePath": "res://main.tscn" }
+{ "operation": "debug_breakpoints_set", "handle": { "runId": "<run UUID>", "generation": 1 }, "breakpoints": [{ "sourcePath": "res://player.gd", "line": 42 }] }
+{ "operation": "profile_start", "handle": { "runId": "<run UUID>", "generation": 1 }, "durationMs": 1000, "intervalFrames": 1, "groups": ["frame", "memory"], "retainRaw": false }
+{ "operation": "sequence", "handle": { "runId": "<run UUID>", "generation": 1 }, "mode": "deterministic", "events": [{ "frameOffset": 0, "event": { "type": "action", "action": "jump", "pressed": true, "strengthMillionths": 1000000 } }, { "frameOffset": 1, "event": { "type": "action", "action": "jump", "pressed": false, "strengthMillionths": 0 } }] }
+```
+
+Runtime control and input are off unless their explicit flags are present. Deterministic sequences/replay require a paused owned runtime; offsets are zero-based, so offsets 0–1 process across two rendered frames and leave it paused. Recording captures only MCP-injected events. Receipts and audit summaries omit raw action names, keycodes, coordinates, and trace payloads. There is no OS-global/editor input, arbitrary text, process, filesystem, network, method-call, or GDScript-evaluation primitive.
+
+## Development and certification
+
+```bash
+GODOT_BIN=/opt/homebrew/bin/godot pnpm qa:phase-0-1
+GODOT_BIN=/opt/homebrew/bin/godot pnpm qa:phase-2
+GODOT_BIN=/opt/homebrew/bin/godot pnpm qa:phase-3
+GODOT_BIN=/opt/homebrew/bin/godot pnpm qa:phase-4
+GODOT_BIN=/opt/homebrew/bin/godot pnpm qa:phase-5
+GODOT_BIN=/opt/homebrew/bin/godot pnpm qa:phase-6
+GODOT_BIN=/opt/homebrew/bin/godot pnpm qa:phase-7
+```
+
+The Phase 7 gate certifies secure shared-port editor startup, native-DAP inertness, authenticated editor-session debugging, breakpoints/stacks/variables/selector watches, bounded public monitor snapshots, completed and cancelled profiles, hostile-input rejection, published stdio behavior, and zero owned-state or fixture residue. Earlier gates remain required regressions. See [Phase 7 testing](docs/testing/phase-7.md), [Phase 6 testing](docs/testing/phase-6.md), the [threat model](docs/security/threat-model.md), the [bridge protocol](docs/protocol/bridge-v1.md), and the [master design](docs/superpowers/specs/2026-07-15-godot-mcp-master-design.md).
+
+## Roadmap
+
+Later phases add declarative playtests, imports/builds/exports, evidence retrieval, compatibility lanes, and explicitly gated disposable-fixture unsafe mode. None of those capabilities are claimed by Phase 7.

package/dist/createServer.d.ts

@@ -0,0 +1,20 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type CoreToolDependencies } from "./registerCoreTools.js";
+import { type InputController } from "./registerInputTools.js";
+import { type EditorController } from "./registerEditorTools.js";
+import { type RuntimeController } from "./registerRuntimeTools.js";
+import { type VisualController } from "./registerVisualTools.js";
+import { type ProjectOperationsController } from "./registerProjectTools.js";
+import { type UnsafeFixtureController } from "./registerUnsafeTools.js";
+import { type ExtensionToolDependencies } from "./registerExtensionTools.js";
+export type GodotMcpServerDependencies = CoreToolDependencies & {
+    runtime?: RuntimeController & Partial<InputController>;
+    editor?: EditorController;
+    visual?: VisualController;
+    projectOperations?: ProjectOperationsController;
+    unsafeFixture?: UnsafeFixtureController;
+    extensions?: ExtensionToolDependencies["extensions"];
+    extensionContext?: ExtensionToolDependencies["extensionContext"];
+};
+export declare function createGodotMcpServer(dependencies: GodotMcpServerDependencies): McpServer;
+//# sourceMappingURL=createServer.d.ts.map

package/dist/createServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createServer.d.ts","sourceRoot":"","sources":["../src/createServer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,OAAO,EAAqB,KAAK,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACnF,OAAO,EAAuB,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACtF,OAAO,EAAwB,KAAK,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACzF,OAAO,EAAuB,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACtF,OAAO,EAAwB,KAAK,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACnG,OAAO,EAAuB,KAAK,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAC7F,OAAO,EAA0B,KAAK,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAErG,MAAM,MAAM,0BAA0B,GAAG,oBAAoB,GAAG;IAC9D,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACvD,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,iBAAiB,CAAC,EAAE,2BAA2B,CAAC;IAChD,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACxC,UAAU,CAAC,EAAE,yBAAyB,CAAC,YAAY,CAAC,CAAC;IACrD,gBAAgB,CAAC,EAAE,yBAAyB,CAAC,kBAAkB,CAAC,CAAC;CAClE,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,0BAA0B,GAAG,SAAS,CAwCxF"}

package/dist/createServer.js

@@ -0,0 +1,46 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { PRODUCT_VERSION } from "@godot-mcp/protocol";
+import { registerCoreTools } from "./registerCoreTools.js";
+import { registerInputTools } from "./registerInputTools.js";
+import { registerEditorTools } from "./registerEditorTools.js";
+import { registerRuntimeTools } from "./registerRuntimeTools.js";
+import { registerVisualTools } from "./registerVisualTools.js";
+import { registerProjectTools } from "./registerProjectTools.js";
+import { registerUnsafeTools } from "./registerUnsafeTools.js";
+import { registerExtensionTools } from "./registerExtensionTools.js";
+export function createGodotMcpServer(dependencies) {
+    const server = new McpServer({ name: "godot-mcp", version: PRODUCT_VERSION });
+    registerCoreTools(server, dependencies);
+    if (dependencies.runtime &&
+        dependencies.grants.tiers.includes("runtime_control") &&
+        dependencies.grants.packs.includes("runtime"))
+        registerRuntimeTools(server, { ...dependencies, runtime: dependencies.runtime });
+    if (dependencies.runtime &&
+        dependencies.runtime.input &&
+        dependencies.grants.tiers.includes("runtime_control") &&
+        dependencies.grants.packs.includes("input"))
+        registerInputTools(server, { ...dependencies, runtime: { input: dependencies.runtime.input.bind(dependencies.runtime) } });
+    if (dependencies.editor &&
+        dependencies.grants.tiers.includes("project_mutate") &&
+        dependencies.grants.packs.includes("editor"))
+        registerEditorTools(server, { ...dependencies, editor: dependencies.editor });
+    if (dependencies.visual &&
+        dependencies.grants.tiers.includes("runtime_control") &&
+        dependencies.grants.packs.includes("runtime") &&
+        dependencies.grants.packs.includes("input") &&
+        dependencies.grants.packs.includes("visual"))
+        registerVisualTools(server, { ...dependencies, visual: dependencies.visual });
+    if (dependencies.projectOperations &&
+        dependencies.grants.tiers.includes("project_operate") &&
+        dependencies.grants.packs.includes("project"))
+        registerProjectTools(server, { ...dependencies, projectOperations: dependencies.projectOperations });
+    if (dependencies.unsafeFixture &&
+        dependencies.grants.tiers.includes("unsafe_fixture") &&
+        dependencies.grants.packs.includes("unsafe"))
+        registerUnsafeTools(server, { ...dependencies, unsafeFixture: dependencies.unsafeFixture });
+    if (dependencies.extensions?.visible(dependencies.grants) && dependencies.extensionContext) {
+        registerExtensionTools(server, { ...dependencies, extensions: dependencies.extensions, extensionContext: dependencies.extensionContext });
+    }
+    return server;
+}
+//# sourceMappingURL=createServer.js.map

package/dist/createServer.js.map

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

package/dist/executeTool.d.ts

@@ -0,0 +1,40 @@
+import { type AuditSink, type CommandPolicy, type SessionGrants, type SessionService } from "@godot-mcp/control-plane";
+import { type ProjectIdentity, type ToolResult } from "@godot-mcp/protocol";
+export interface ToolExecutionDependencies {
+    project: ProjectIdentity;
+    grants: SessionGrants;
+    audit: AuditSink;
+    session: SessionService;
+}
+export interface ExecutedPayload<T = unknown> {
+    data: T;
+    evidence?: string[];
+    warnings?: string[];
+    changes?: unknown[];
+    audit?: {
+        targetIdentities: unknown[];
+        preconditions: unknown[];
+        idempotencyKeySha256: string | null;
+        partialEffects: boolean;
+        rollback: "not_needed" | "succeeded" | "failed" | "not_attempted";
+    };
+    image?: {
+        data: Uint8Array;
+        mimeType: "image/png";
+    };
+    images?: Array<{
+        data: Uint8Array;
+        mimeType: "image/png";
+    }>;
+}
+export interface ExecutedToolResult {
+    result: ToolResult;
+    image?: ExecutedPayload["image"];
+    images?: ExecutedPayload["images"];
+}
+export interface ToolExecutionOptions {
+    auditArguments?: unknown | ((correlationId: string) => unknown);
+    auditFallbackArguments?: unknown;
+}
+export declare function executeTool(dependencies: ToolExecutionDependencies, policy: CommandPolicy, argumentsValue: unknown, handler: (correlationId: string) => ExecutedPayload | Promise<ExecutedPayload>, options?: ToolExecutionOptions): Promise<ExecutedToolResult>;
+//# sourceMappingURL=executeTool.d.ts.map

package/dist/executeTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executeTool.d.ts","sourceRoot":"","sources":["../src/executeTool.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,eAAe,CAAC;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,cAAc,CAAC;CACzB;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,IAAI,EAAE,CAAC,CAAC;IACR,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE;QACN,gBAAgB,EAAE,OAAO,EAAE,CAAC;QAC5B,aAAa,EAAE,OAAO,EAAE,CAAC;QACzB,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;QACpC,cAAc,EAAE,OAAO,CAAC;QACxB,QAAQ,EAAE,YAAY,GAAG,WAAW,GAAG,QAAQ,GAAG,eAAe,CAAC;KACnE,CAAC;IACF,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE,WAAW,CAAA;KAAE,CAAC;IACpD,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE,WAAW,CAAA;KAAE,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,oBAAoB;IACnC,cAAc,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;IAChE,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AA2BD,wBAAsB,WAAW,CAC/B,YAAY,EAAE,yBAAyB,EACvC,MAAM,EAAE,aAAa,EACrB,cAAc,EAAE,OAAO,EACvB,OAAO,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,EAC9E,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,kBAAkB,CAAC,CA+E7B"}

package/dist/executeTool.js

@@ -0,0 +1,109 @@
+import { randomUUID } from "node:crypto";
+import { GodotMcpException, authorize, } from "@godot-mcp/control-plane";
+import { GodotMcpErrorSchema, ToolResultSchema, } from "@godot-mcp/protocol";
+function normalizeError(error, correlationId) {
+    if (error instanceof GodotMcpException) {
+        return GodotMcpErrorSchema.parse({
+            code: error.code,
+            message: error.message,
+            retryable: error.retryable,
+            correlationId,
+            partialEffects: error.partialEffects,
+            rollback: error.rollback,
+            failedPhase: error.failedPhase,
+            safeRecovery: error.safeRecovery,
+        });
+    }
+    return GodotMcpErrorSchema.parse({
+        code: "INVALID_REQUEST",
+        message: error instanceof Error ? error.message : "Tool request failed",
+        retryable: false,
+        correlationId,
+        partialEffects: false,
+        rollback: "not_needed",
+        failedPhase: "request",
+        safeRecovery: "Review the error and retry only after correcting the request",
+    });
+}
+export async function executeTool(dependencies, policy, argumentsValue, handler, options = {}) {
+    const correlationId = randomUUID();
+    const startedAt = new Date().toISOString();
+    let auditArguments = typeof options.auditArguments === "function"
+        ? (options.auditFallbackArguments ?? argumentsValue)
+        : (options.auditArguments ?? options.auditFallbackArguments ?? argumentsValue);
+    try {
+        authorize(dependencies.grants, policy);
+        auditArguments = typeof options.auditArguments === "function" ? options.auditArguments(correlationId) : (options.auditArguments ?? argumentsValue);
+        const payload = await handler(correlationId);
+        const evidence = payload.evidence ?? [];
+        const warnings = payload.warnings ?? [];
+        const changes = payload.changes ?? [];
+        const auditFacts = payload.audit;
+        const receipt = await dependencies.audit.append({
+            correlationId,
+            sessionId: dependencies.session.snapshot().attachment?.sessionId ?? null,
+            projectId: dependencies.project.projectId,
+            event: `tool.${policy.command}`,
+            outcome: "success",
+            permissionTier: policy.tier,
+            startedAt,
+            finishedAt: new Date().toISOString(),
+            arguments: auditArguments,
+            errorCode: null,
+            evidence,
+            targetIdentities: auditFacts?.targetIdentities ?? [],
+            preconditions: auditFacts?.preconditions ?? [],
+            changes,
+            idempotencyKeySha256: auditFacts?.idempotencyKeySha256 ?? null,
+            partialEffects: auditFacts?.partialEffects ?? false,
+            rollback: auditFacts?.rollback ?? "not_needed",
+        });
+        return {
+            result: ToolResultSchema.parse({
+                ok: true,
+                data: payload.data,
+                warnings,
+                evidence,
+                changes,
+                auditId: receipt.auditId,
+                correlationId,
+            }),
+            ...(payload.image === undefined ? {} : { image: payload.image }),
+            ...(payload.images === undefined ? {} : { images: payload.images }),
+        };
+    }
+    catch (error) {
+        const normalized = normalizeError(error, correlationId);
+        const receipt = await dependencies.audit.append({
+            correlationId,
+            sessionId: dependencies.session.snapshot().attachment?.sessionId ?? null,
+            projectId: dependencies.project.projectId,
+            event: `tool.${policy.command}`,
+            outcome: "error",
+            permissionTier: policy.tier,
+            startedAt,
+            finishedAt: new Date().toISOString(),
+            arguments: auditArguments,
+            errorCode: normalized.code,
+            evidence: [],
+            targetIdentities: [],
+            preconditions: [],
+            changes: [],
+            idempotencyKeySha256: null,
+            partialEffects: normalized.partialEffects,
+            rollback: normalized.rollback,
+        });
+        return {
+            result: ToolResultSchema.parse({
+                ok: false,
+                data: { error: normalized },
+                warnings: [],
+                evidence: [],
+                changes: [],
+                auditId: receipt.auditId,
+                correlationId,
+            }),
+        };
+    }
+}
+//# sourceMappingURL=executeTool.js.map

package/dist/executeTool.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { createGodotMcpServer, type GodotMcpServerDependencies } from "./createServer.js";
+export { registerUnsafeTools, unsafeAuditArguments, type UnsafeFixtureController, type UnsafeToolDependencies } from "./registerUnsafeTools.js";
+export { registerExtensionTools, type ExtensionToolDependencies } from "./registerExtensionTools.js";
+export { projectAuditArguments, registerProjectTools, type ProjectOperationsController, type ProjectToolDependencies, } from "./registerProjectTools.js";
+export { registerInputTools, type InputController, type InputToolDependencies, } from "./registerInputTools.js";
+export { registerRuntimeTools, type RuntimeController, type RuntimeFrame, type RuntimeToolDependencies, } from "./registerRuntimeTools.js";
+export { registerCoreTools } from "./registerCoreTools.js";
+export { registerEditorTools, summarizeEditorMutationForAudit, type EditorController, type EditorToolDependencies, } from "./registerEditorTools.js";
+export { connectStdio } from "./stdio.js";
+export { toMcpToolResult } from "./toolResult.js";
+export { registerVisualTools, visualAuditArguments, type VisualController, type VisualToolDependencies, } from "./registerVisualTools.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,KAAK,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,KAAK,uBAAuB,EAAE,KAAK,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAChJ,OAAO,EAAE,sBAAsB,EAAE,KAAK,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACrG,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,2BAA2B,EAChC,KAAK,uBAAuB,GAC7B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,qBAAqB,GAC3B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,oBAAoB,EACpB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,uBAAuB,GAC7B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EACL,mBAAmB,EACnB,+BAA+B,EAC/B,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,GAC5B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,GAC5B,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+export { createGodotMcpServer } from "./createServer.js";
+export { registerUnsafeTools, unsafeAuditArguments } from "./registerUnsafeTools.js";
+export { registerExtensionTools } from "./registerExtensionTools.js";
+export { projectAuditArguments, registerProjectTools, } from "./registerProjectTools.js";
+export { registerInputTools, } from "./registerInputTools.js";
+export { registerRuntimeTools, } from "./registerRuntimeTools.js";
+export { registerCoreTools } from "./registerCoreTools.js";
+export { registerEditorTools, summarizeEditorMutationForAudit, } from "./registerEditorTools.js";
+export { connectStdio } from "./stdio.js";
+export { toMcpToolResult } from "./toolResult.js";
+export { registerVisualTools, visualAuditArguments, } from "./registerVisualTools.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAmC,MAAM,mBAAmB,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAA6D,MAAM,0BAA0B,CAAC;AAChJ,OAAO,EAAE,sBAAsB,EAAkC,MAAM,6BAA6B,CAAC;AACrG,OAAO,EACL,qBAAqB,EACrB,oBAAoB,GAGrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,kBAAkB,GAGnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,oBAAoB,GAIrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EACL,mBAAmB,EACnB,+BAA+B,GAGhC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EACL,mBAAmB,EACnB,oBAAoB,GAGrB,MAAM,0BAA0B,CAAC"}

package/dist/registerCoreTools.d.ts

@@ -0,0 +1,25 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type AuditSink, type EvidenceStore, type SessionGrants, type SessionService } from "@godot-mcp/control-plane";
+import { type ProjectIdentity } from "@godot-mcp/protocol";
+export interface BridgeCommandRequester {
+    request<T>(method: "editor.query" | "editor.capture", params: unknown, options?: {
+        timeoutMs?: number;
+        maxResponseBytes?: number;
+        correlationId?: string;
+    }): Promise<{
+        requestId: string;
+        data: T;
+        binary?: Uint8Array;
+        binarySha256?: string;
+    }>;
+}
+export interface CoreToolDependencies {
+    project: ProjectIdentity;
+    grants: SessionGrants;
+    audit: AuditSink;
+    session: SessionService;
+    bridge: () => BridgeCommandRequester | null;
+    evidence: EvidenceStore;
+}
+export declare function registerCoreTools(server: McpServer, dependencies: CoreToolDependencies): void;
+//# sourceMappingURL=registerCoreTools.d.ts.map

package/dist/registerCoreTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerCoreTools.d.ts","sourceRoot":"","sources":["../src/registerCoreTools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAQL,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAKL,KAAK,eAAe,EACrB,MAAM,qBAAqB,CAAC;AAK7B,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,CAAC,EACP,MAAM,EAAE,cAAc,GAAG,gBAAgB,EACzC,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAClF,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,CAAC,CAAC;QAAC,MAAM,CAAC,EAAE,UAAU,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxF;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,eAAe,CAAC;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,MAAM,sBAAsB,GAAG,IAAI,CAAC;IAC5C,QAAQ,EAAE,aAAa,CAAC;CACzB;AAqBD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,oBAAoB,GAAG,IAAI,CAmE7F"}

package/dist/registerCoreTools.js

@@ -0,0 +1,88 @@
+import { randomUUID } from "node:crypto";
+import { z } from "zod";
+import { CORE_CAPABILITIES_POLICY, CORE_CAPTURE_POLICY, CORE_DOCTOR_POLICY, CORE_HELP_POLICY, CORE_QUERY_POLICY, CORE_SESSION_POLICY, GodotMcpException, } from "@godot-mcp/control-plane";
+import { EditorCaptureInputSchema, EditorCaptureResultSchema, EditorQueryInputSchema, ToolResultSchema, } from "@godot-mcp/protocol";
+import { executeTool } from "./executeTool.js";
+import { toMcpToolResult } from "./toolResult.js";
+const annotations = {
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false,
+};
+function requireBridge(bridge) {
+    if (bridge)
+        return bridge;
+    throw new GodotMcpException({
+        code: "NOT_ATTACHED",
+        message: "Godot editor addon is not attached",
+        retryable: true,
+        correlationId: randomUUID(),
+        partialEffects: false,
+        rollback: "not_needed",
+    });
+}
+export function registerCoreTools(server, dependencies) {
+    server.registerTool("godot_session", {
+        title: "Godot session status", description: "Read the attached Godot project, versions, state, and granted capabilities.",
+        inputSchema: z.object({}), outputSchema: ToolResultSchema, annotations,
+    }, async () => toMcpToolResult(await executeTool(dependencies, CORE_SESSION_POLICY, {}, () => ({ data: dependencies.session.snapshot() }))));
+    server.registerTool("godot_capabilities", {
+        title: "Godot capabilities", description: "List the operations visible to this least-privilege session.",
+        inputSchema: z.object({}), outputSchema: ToolResultSchema, annotations,
+    }, async () => toMcpToolResult(await executeTool(dependencies, CORE_CAPABILITIES_POLICY, {}, () => ({ data: dependencies.session.capabilities() }))));
+    server.registerTool("godot_doctor", {
+        title: "Godot MCP doctor", description: "Read installation, engine, bridge, and attachment health without changing the project.",
+        inputSchema: z.object({}), outputSchema: ToolResultSchema, annotations,
+    }, async () => toMcpToolResult(await executeTool(dependencies, CORE_DOCTOR_POLICY, {}, async () => ({ data: await dependencies.session.doctor() }))));
+    server.registerTool("godot_help", {
+        title: "Godot MCP help", description: "Read focused help for a core operation.",
+        inputSchema: z.object({ operation: z.string().optional() }), outputSchema: ToolResultSchema, annotations,
+    }, async ({ operation }) => toMcpToolResult(await executeTool(dependencies, CORE_HELP_POLICY, { operation }, () => ({ data: dependencies.session.help(operation) }))));
+    server.registerTool("godot_query", {
+        title: "Query Godot editor",
+        description: "Read bounded editor state, open scene metadata, indexed resources, approved project settings, or redacted diagnostics.",
+        inputSchema: EditorQueryInputSchema, outputSchema: ToolResultSchema, annotations,
+    }, async (input) => toMcpToolResult(await executeTool(dependencies, CORE_QUERY_POLICY, input, async (correlationId) => {
+        const response = await requireBridge(dependencies.bridge()).request("editor.query", input, {
+            timeoutMs: 10_000, maxResponseBytes: 512 * 1024, correlationId,
+        });
+        return { data: response.data };
+    })));
+    server.registerTool("godot_capture", {
+        title: "Capture Godot editor viewport",
+        description: "Return a bounded PNG from the current 2D or selected 3D editor viewport.",
+        inputSchema: EditorCaptureInputSchema, outputSchema: ToolResultSchema, annotations,
+    }, async (input) => toMcpToolResult(await executeTool(dependencies, CORE_CAPTURE_POLICY, input, async (correlationId) => {
+        const response = await requireBridge(dependencies.bridge()).request("editor.capture", input, {
+            timeoutMs: 15_000, maxResponseBytes: 8 * 1024 * 1024, correlationId,
+        });
+        if (!response.binary)
+            throw new Error("Godot capture response omitted PNG bytes");
+        const metadata = EditorCaptureResultSchema.parse(response.data);
+        const expectedViewportIndex = input.viewport === "3d" ? input.viewportIndex ?? 0 : null;
+        if (metadata.viewport !== input.viewport ||
+            (metadata.viewportIndex ?? null) !== expectedViewportIndex ||
+            metadata.width > input.maxWidth ||
+            metadata.height > input.maxHeight ||
+            metadata.byteLength !== response.binary.byteLength ||
+            metadata.sha256 !== response.binarySha256) {
+            throw new Error("Godot capture metadata does not match verified PNG bytes or request bounds");
+        }
+        const attachment = dependencies.session.snapshot().attachment;
+        if (!attachment)
+            return requireBridge(null);
+        const viewport = metadata.viewport;
+        const width = metadata.width;
+        const height = metadata.height;
+        const evidence = await dependencies.evidence.putPng(attachment.sessionId, response.binary, {
+            viewport, width, height, ...(viewport === "3d" ? { viewportIndex: input.viewportIndex ?? 0 } : {}),
+        });
+        return {
+            data: { ...metadata, sha256: evidence.sha256, byteLength: evidence.byteLength, evidenceUri: evidence.uri, evidenceObservationUri: evidence.observationUri },
+            evidence: [evidence.observationUri],
+            image: { data: response.binary, mimeType: "image/png" },
+        };
+    })));
+}
+//# sourceMappingURL=registerCoreTools.js.map

package/dist/registerCoreTools.js.map

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

package/dist/registerEditorTools.d.ts

@@ -0,0 +1,12 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type EditorMutationInput, type EditorMutationResult } from "@godot-mcp/protocol";
+import { type ToolExecutionDependencies } from "./executeTool.js";
+export interface EditorController {
+    execute(input: EditorMutationInput, correlationId: string): Promise<EditorMutationResult>;
+}
+export interface EditorToolDependencies extends ToolExecutionDependencies {
+    editor: EditorController;
+}
+export declare function summarizeEditorMutationForAudit(input: EditorMutationInput): Record<string, unknown>;
+export declare function registerEditorTools(server: McpServer, dependencies: EditorToolDependencies): void;
+//# sourceMappingURL=registerEditorTools.d.ts.map

package/dist/registerEditorTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerEditorTools.d.ts","sourceRoot":"","sources":["../src/registerEditorTools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAe,KAAK,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAG/E,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAC3F;AAED,MAAM,WAAW,sBAAuB,SAAQ,yBAAyB;IACvE,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA4BnG;AASD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,sBAAsB,GAAG,IAAI,CAsBjG"}

package/dist/registerEditorTools.js

@@ -0,0 +1,59 @@
+import { createHash } from "node:crypto";
+import { EDITOR_POLICY } from "@godot-mcp/control-plane";
+import { EditorMutationInputSchema, ToolResultSchema, } from "@godot-mcp/protocol";
+import { executeTool } from "./executeTool.js";
+import { toMcpToolResult } from "./toolResult.js";
+export function summarizeEditorMutationForAudit(input) {
+    if (input.operation === "undo" || input.operation === "redo") {
+        return {
+            operation: input.operation,
+            actionId: input.actionId,
+            idempotencyKeySha256: createHash("sha256").update(input.idempotencyKey).digest("hex"),
+        };
+    }
+    const stepOperations = {};
+    for (const step of input.steps)
+        stepOperations[step.operation] = (stepOperations[step.operation] ?? 0) + 1;
+    const sourceSteps = input.steps.flatMap((step) => "sourcePath" in step && "content" in step
+        ? [{ sourcePath: String(step.sourcePath), content: String(step.content) }]
+        : []);
+    return {
+        operation: input.operation,
+        stepCount: input.steps.length,
+        stepOperations,
+        ...(sourceSteps.length === 0 ? {} : {
+            sourcePaths: sourceSteps.map((step) => step.sourcePath),
+            sourceContentSha256: sourceSteps.map((step) => createHash("sha256").update(step.content).digest("hex")),
+        }),
+        ...(input.operation === "apply"
+            ? {
+                expectedPlanDigest: input.expectedPlanDigest,
+                idempotencyKeySha256: createHash("sha256").update(input.idempotencyKey).digest("hex"),
+            }
+            : { idempotencyKeySha256: null }),
+    };
+}
+const annotations = {
+    readOnlyHint: false,
+    destructiveHint: true,
+    idempotentHint: false,
+    openWorldHint: false,
+};
+export function registerEditorTools(server, dependencies) {
+    server.registerTool("godot_editor", {
+        title: "Author and mutate Godot editor content",
+        description: "Preview, apply, undo, or redo one bounded transactional editor or authoring batch in an authenticated project.",
+        inputSchema: EditorMutationInputSchema,
+        outputSchema: ToolResultSchema,
+        annotations,
+    }, async (input) => toMcpToolResult(await executeTool(dependencies, EDITOR_POLICY, input, async (correlationId) => {
+        const data = await dependencies.editor.execute(input, correlationId);
+        return {
+            data,
+            warnings: data.warnings,
+            changes: data.changes,
+            audit: data.audit,
+        };
+    }, { auditArguments: summarizeEditorMutationForAudit(input) })));
+}
+//# sourceMappingURL=registerEditorTools.js.map