Method Schema

cli/plugins/builtin_graphview.go:169–192

Schema describes the tool for the LLM catalog.

()

// Schema describes the tool for the LLM catalog.
func (*BuiltinGraphViewPlugin) Schema() string {
	schema := map[string]interface{}{
		"argsFormat": "flat JSON preferred",
		"description": "Render an interactive, draggable force-directed graph (Obsidian-style) to a self-contained HTML file and open it in the browser. " +
			"Use it to visualize how concepts, entities, files or topics relate — especially to map out the current conversation/session.",
		"flags": []map[string]interface{}{
			{"name": "source", "type": "string", "description": "json (default): you provide nodes/edges. knowledge: the in-core knowledge graph. conversation: a structural graph of this session."},
			{"name": "nodes", "type": "array", "description": "source=json. Array of {id, label, kind?, summary?, weight?}. kind drives node color (e.g. topic, project, file, entity, person)."},
			{"name": "edges", "type": "array", "description": "source=json. Array of {source, target, weight?} where source/target are node ids."},
			{"name": "file", "type": "string", "description": "Path to a JSON file holding {\"nodes\":[...],\"edges\":[...]} — use for large graphs instead of inline args."},
			{"name": "title", "type": "string", "description": "Graph title shown in the toolbar."},
			{"name": "theme", "type": "string", "description": "dark (default) or light."},
			{"name": "output", "type": "string", "description": "Path to write the .html file (default: a temp file)."},
			{"name": "open", "type": "boolean", "description": "Open the result in the default browser (default true)."},
		},
		"examples": []string{
			`{"title":"What we discussed","nodes":[{"id":"oauth","label":"OAuth login","kind":"topic"},{"id":"token","label":"Token exchange","kind":"topic"},{"id":"cli","label":"ChatCLI","kind":"project"}],"edges":[{"source":"cli","target":"oauth"},{"source":"oauth","target":"token","weight":2}]}`,
			`{"source":"knowledge"}`,
			`{"source":"conversation"}`,
		},
	}
	data, _ := json.Marshal(schema)
	return string(data)
}

// Execute parses args and renders the graph.
func (p *BuiltinGraphViewPlugin) Execute(ctx context.Context, args []string) (string, error) {