trustgraph/trustgraph-cli/trustgraph/cli/show_tools.py

"""
Displays the current agent tool configurations

Shows all configured tools including their types:
- knowledge-query: Tools that query knowledge bases
- structured-query: Tools that query structured data using natural language
- row-embeddings-query: Tools for semantic search on structured data indexes
- text-completion: Tools for text generation
- mcp-tool: References to MCP (Model Context Protocol) tools
- prompt: Tools that execute prompt templates
"""

import argparse
import os
from trustgraph.api import Api, ConfigKey
import json
import tabulate
import textwrap

default_url = os.getenv("TRUSTGRAPH_URL", 'http://localhost:8088/')
default_token = os.getenv("TRUSTGRAPH_TOKEN", None)
default_workspace = os.getenv("TRUSTGRAPH_WORKSPACE", "default")

def show_config(url, token=None, workspace="default"):

    api = Api(url, token=token, workspace=workspace).config()

    values = api.get_values(type="tool")

    for item in values:

        id = item.key
        data = json.loads(item.value)

        tp = data["type"]

        table = []

        table.append(("id", id))
        table.append(("name", data["name"]))
        table.append(("description", data["description"]))
        table.append(("type", tp))

        if tp == "mcp-tool":
            table.append(("mcp-tool", data["mcp-tool"]))

        if tp in ("knowledge-query", "structured-query", "row-embeddings-query"):
            if "collection" in data:
                table.append(("collection", data["collection"]))

        if tp == "row-embeddings-query":
            if "schema-name" in data:
                table.append(("schema-name", data["schema-name"]))
            if "index-name" in data:
                table.append(("index-name", data["index-name"]))
            if "limit" in data:
                table.append(("limit", data["limit"]))

        if tp == "prompt":
            table.append(("template", data["template"]))
            for n, arg in enumerate(data["arguments"]):
                table.append((
                    f"arg {n}",
                    f"{arg['name']}: {arg['type']}\n{arg['description']}"
                ))
        
        # Display group information
        if "group" in data:
            groups = data["group"]
            if groups:
                table.append(("groups", ", ".join(groups)))
            else:
                table.append(("groups", "(empty - no groups)"))
        
        # Display state transition information
        if "state" in data:
            table.append(("next state", data["state"]))
        
        # Display applicable states
        if "applicable-states" in data:
            states = data["applicable-states"]
            if states:
                if "*" in states:
                    table.append(("available in", "all states"))
                else:
                    table.append(("available in", ", ".join(states)))
            else:
                table.append(("available in", "(empty - never available)"))

        print()

        print(tabulate.tabulate(
            table,
            tablefmt="pretty",
            maxcolwidths=[None, 70],
            stralign="left"
        ))
        
    print()

def main():

    parser = argparse.ArgumentParser(
        prog='tg-show-tools',
        description=__doc__,
    )

    parser.add_argument(
        '-u', '--api-url',
        default=default_url,
        help=f'API URL (default: {default_url})',
    )

    parser.add_argument(
        '-t', '--token',
        default=default_token,
        help='Authentication token (default: $TRUSTGRAPH_TOKEN)',
    )

    parser.add_argument(
        '-w', '--workspace',
        default=default_workspace,
        help=f'Workspace (default: {default_workspace})',
    )

    args = parser.parse_args()

    try:

        show_config(
            url=args.api_url,
            token=args.token,

            workspace=args.workspace,
        )

    except Exception as e:

        print("Exception:", e, flush=True)

if __name__ == "__main__":
    main()