feat: add tool descriptor planner

src/tools/execution.ts

@@ -0,0 +1,18 @@
+import type { ToolExecutorRef } from "./types.js";
+
+export function formatToolExecutorRef(ref: ToolExecutorRef): string {
+  switch (ref.kind) {
+    case "core":
+      return `core:${ref.executorId}`;
+    case "plugin":
+      return `plugin:${ref.pluginId}:${ref.toolName}`;
+    case "channel":
+      return `channel:${ref.channelId}:${ref.actionId}`;
+    case "mcp":
+      return `mcp:${ref.serverId}:${ref.toolName}`;
+    default: {
+      const exhaustive: never = ref;
+      return exhaustive;
+    }
+  }
+}