102 lines
4.9 KiB
Go
102 lines
4.9 KiB
Go
package chattools
|
|
|
|
// The tool names, as the MCP server lists them.
|
|
const (
|
|
ToolShowFile = "show_file"
|
|
ToolShowImage = "show_image"
|
|
ToolShowHTML = "show_html"
|
|
ToolNotify = "notify"
|
|
)
|
|
|
|
// MaxHTMLBytes bounds one show_html document. A larger one is refused, never
|
|
// truncated: a cut document would render as something the model did not write.
|
|
const MaxHTMLBytes = 512 << 10
|
|
|
|
// IsTool reports whether name is one of the Pipelines tools.
|
|
func IsTool(name string) bool {
|
|
switch name {
|
|
case ToolShowFile, ToolShowImage, ToolShowHTML, ToolNotify:
|
|
return true
|
|
}
|
|
return false
|
|
}
|
|
|
|
// Instructions is the MCP initialize instructions text.
|
|
const Instructions = "These tools act on Pipelines, the app the operator reads this chat in, not on your workspace. " +
|
|
"Use show_file / show_image instead of telling the operator a path to open, show_html for diagrams, charts or small visual views, " +
|
|
"and notify only when the operator should look at their phone now."
|
|
|
|
type toolDefinition struct {
|
|
Name string `json:"name"`
|
|
Title string `json:"title,omitempty"`
|
|
Description string `json:"description"`
|
|
InputSchema map[string]any `json:"inputSchema"`
|
|
Annotations map[string]any `json:"annotations,omitempty"`
|
|
}
|
|
|
|
func stringProperty(description string) map[string]any {
|
|
return map[string]any{"type": "string", "description": description}
|
|
}
|
|
|
|
func objectSchema(required []string, properties map[string]any) map[string]any {
|
|
return map[string]any{"type": "object", "properties": properties, "required": required, "additionalProperties": false}
|
|
}
|
|
|
|
// definitions is the tools/list result, in a fixed order.
|
|
func definitions() []toolDefinition {
|
|
return []toolDefinition{
|
|
{
|
|
Name: ToolShowFile,
|
|
Title: "Show a file in the chat",
|
|
Description: "Show the operator an existing file from this machine directly in the Pipelines chat: images appear inline, " +
|
|
"documents (PDF, Markdown, text, CSV, HTML, and others) as a preview card they can tap to open or download. " +
|
|
"Use this instead of telling the operator a path to navigate to. The file must be inside the operator's home directory. " +
|
|
"A relative path is resolved against the chat's working directory.",
|
|
InputSchema: objectSchema([]string{"path"}, map[string]any{
|
|
"path": stringProperty("Absolute path, ~/path, or a path relative to the chat's working directory."),
|
|
"title": stringProperty("Optional short caption shown above the file."),
|
|
}),
|
|
Annotations: map[string]any{"readOnlyHint": true, "openWorldHint": false},
|
|
},
|
|
{
|
|
Name: ToolShowImage,
|
|
Title: "Show an image in the chat",
|
|
Description: "Show the operator an image inline in the Pipelines chat, from a file on this machine (inside the operator's home) " +
|
|
"or from an https:// URL. The URL is loaded by the operator's device without cookies.",
|
|
InputSchema: objectSchema([]string{"url_or_path"}, map[string]any{
|
|
"url_or_path": stringProperty("An https:// image URL, or a file path as for show_file."),
|
|
"title": stringProperty("Optional short caption."),
|
|
"alt": stringProperty("Optional description of the image for accessibility."),
|
|
}),
|
|
Annotations: map[string]any{"readOnlyHint": true},
|
|
},
|
|
{
|
|
Name: ToolShowHTML,
|
|
Title: "Show an HTML view in the chat",
|
|
Description: "Render a self-contained HTML or SVG document inline in the Pipelines chat: diagrams, charts, tables, small visual views. " +
|
|
"It is shown in a sandbox with no scripts, no network and no access to the app: use inline CSS and inline SVG, " +
|
|
"<details> for expandable parts and CSS :hover for interaction; JavaScript does not run and external resources do not load. " +
|
|
"The operator can open it full screen. At most 512 KiB.",
|
|
InputSchema: objectSchema([]string{"html"}, map[string]any{
|
|
"html": stringProperty("The complete HTML (or a bare <svg>) document."),
|
|
"title": stringProperty("Optional short caption."),
|
|
"height_hint": map[string]any{"type": "integer", "description": "Optional preferred inline height in logical pixels (120-600)."},
|
|
}),
|
|
Annotations: map[string]any{"readOnlyHint": true, "openWorldHint": false},
|
|
},
|
|
{
|
|
Name: ToolNotify,
|
|
Title: "Notify the operator's phone",
|
|
Description: "Send a push notification to the operator's phone that opens this chat when tapped. " +
|
|
"Use it sparingly, for things they should know now (a long task finished, you are blocked on them). " +
|
|
"Limited to 5 per minute per chat. Returns whether delivery was accepted.",
|
|
InputSchema: objectSchema([]string{"title", "message"}, map[string]any{
|
|
"title": stringProperty("Short notification title (one line)."),
|
|
"message": stringProperty("Notification text (one or two sentences)."),
|
|
"priority": map[string]any{"type": "string", "enum": []string{"low", "default", "high"}, "description": "Optional priority; default is default."},
|
|
}),
|
|
Annotations: map[string]any{"readOnlyHint": false, "destructiveHint": false, "openWorldHint": true},
|
|
},
|
|
}
|
|
}
|