From 0be055a336c608ef65e5bc6d56d0fa2fbaeb3e89 Mon Sep 17 00:00:00 2001
From: Aiden Cline <aidenpcline@gmail.com>
Date: Fri, 3 Jul 2026 23:25:00 -0500
Subject: [PATCH] docs(core): clarify internal codemode registration

---
 packages/core/src/tool/registry.ts | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/core/src/tool/registry.ts b/packages/core/src/tool/registry.ts
index ba058f52f5..126317242b 100644
--- a/packages/core/src/tool/registry.ts
+++ b/packages/core/src/tool/registry.ts
@@ -25,6 +25,10 @@ export interface Interface {
   readonly materialize: (input: MaterializeInput) => Effect.Effect<Materialization>
   /** Internal registration capability exposed publicly only through Tools.Service. */
   readonly register: (tools: Readonly<Record<string, AnyTool>>) => Effect.Effect<void, RegistrationError, Scope.Scope>
+  /**
+   * Internal only. This is probably the wrong API: it mixes tool registration with CodeMode projection.
+   * Keep it out of PluginContext until the tool catalog has a proper projection mechanism.
+   */
   readonly codeMode: {
     readonly register: (tools: CodeModeTools) => Effect.Effect<void, RegistrationError, Scope.Scope>
   }