Guide agents to show files with show_page and show_file

internal/agents/clients.go

@@ -95,7 +95,8 @@ func (m *Manager) clientTools(l *live) []mcp.Tool {
 		{
 			Name: "show_page",
 			Description: "Show the human a file from the Mac byre runs on in byre's app on a client Mac, rendered in the page view beside this task's transcript, as a browser would show it: an HTML page (loading the stylesheets, scripts and images beside it), a PDF, an image. " +
-				"Use it when the human asks to see a mockup, a preview or a document as it looks.",
+				"Whenever you write or change a file the human should see as it looks (an HTML mockup or preview, a PDF, an image, an SVG), show it with this before your turn ends, without being asked or asking first. " +
+				"Show it on the Mac the human's latest message was sent from.",
 			InputSchema: json.RawMessage(`{
 				"type": "object",
 				"properties": {
@@ -111,7 +112,8 @@ func (m *Manager) clientTools(l *live) []mcp.Tool {
 		{
 			Name: "show_file",
 			Description: "Show the human a file or directory from the Mac byre runs on in byre's app on a client Mac, in this task's Files tab beside its transcript: a file's text (Markdown rendered, images drawn), or a directory's listing. " +
-				"Use it when the human asks to see a file's contents or a directory.",
+				"Whenever you write a file the human should read (a plan, a report, a Markdown doc) or point them at a directory, show it with this before your turn ends, without being asked or asking first. " +
+				"Show it on the Mac the human's latest message was sent from.",
 			InputSchema: json.RawMessage(`{
 				"type": "object",
 				"properties": {