MiOS/usr/share/mios/ai/v1/tools.json at main · mios-dev/MiOS · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
{
  "object": "mios.tools.registry",
  "version": "v1",
  "manifest_path": "/usr/share/mios/ai/v1/tools.json",
  "endpoint": "http://localhost:8642/v1",
  "served_by": "mios-hermes.container",
  "schema_refs": {
    "chat_completions": "https://platform.openai.com/docs/api-reference/chat/create#chat-create-tools",
    "responses": "https://platform.openai.com/docs/api-reference/responses/create#responses-create-tools"
  },
  "data": [
    {
      "name": "bootc_status",
      "description": "Inspect current bootc state (image ref, deployment, staged update, rollback target).",
      "chat_completions": "/usr/lib/mios/tools/chat-completions-api/bootc_status.json",
      "responses": "/usr/lib/mios/tools/responses-api/bootc_status.json",
      "dispatcher": "/usr/libexec/mios/tools/bootc_status",
      "side_effects": "read-only",
      "schema_output": "/usr/lib/mios/schemas/build_status.schema.json"
    },
    {
      "name": "bootc_switch",
      "description": "Switch to a different image reference. Stages a new deployment; reboot to activate.",
      "chat_completions": "/usr/lib/mios/tools/chat-completions-api/bootc_switch.json",
      "responses": "/usr/lib/mios/tools/responses-api/bootc_switch.json",
      "dispatcher": "/usr/libexec/mios/tools/bootc_switch",
      "side_effects": "mutating",
      "confirm_before_use": true
    },
    {
      "name": "mios_build",
      "description": "Run the OCI build (delegates to mios-pipeline.{ps1,sh} Phase 8). Produces localhost/mios:latest.",
      "chat_completions": "/usr/lib/mios/tools/chat-completions-api/mios_build.json",
      "responses": "/usr/lib/mios/tools/responses-api/mios_build.json",
      "dispatcher": "/usr/libexec/mios/tools/mios_build",
      "side_effects": "mutating",
      "long_running": true,
      "schema_output": "/usr/lib/mios/schemas/build_status.schema.json"
    },
    {
      "name": "mios_build_kb_refresh",
      "description": "Regenerate the local Knowledge Base index. Reads /usr/share/mios/kb/manifest.json and rebuilds the embedding store.",
      "chat_completions": "/usr/lib/mios/tools/chat-completions-api/mios_build_kb_refresh.json",
      "responses": "/usr/lib/mios/tools/responses-api/mios_build_kb_refresh.json",
      "dispatcher": "/usr/libexec/mios/tools/mios_build_kb_refresh",
      "side_effects": "mutating"
    },
    {
      "name": "mios_kargs_validate",
      "description": "Lint usr/lib/bootc/kargs.d/*.toml against the bootc schema (flat kargs = [...] only; no [kargs] header).",
      "chat_completions": "/usr/lib/mios/tools/chat-completions-api/mios_kargs_validate.json",
      "responses": "/usr/lib/mios/tools/responses-api/mios_kargs_validate.json",
      "dispatcher": "/usr/libexec/mios/tools/mios_kargs_validate",
      "side_effects": "read-only",
      "schema_output": "/usr/lib/mios/schemas/kargs_diagnosis.schema.json"
    },
    {
      "name": "packages_md_query",
      "description": "Query the package single-source-of-truth (mios.toml [packages.<section>].pkgs at usr/share/mios/mios.toml). Returns the resolved package list for a given section. Legacy name retained for tool-call compat; underlying source is TOML, not PACKAGES.md.",
      "chat_completions": "/usr/lib/mios/tools/chat-completions-api/packages_md_query.json",
      "responses": "/usr/lib/mios/tools/responses-api/packages_md_query.json",
      "dispatcher": "/usr/libexec/mios/tools/packages_md_query",
      "side_effects": "read-only"
    },
    {
      "name": "repo_overlay_inspect",
      "description": "Diff /usr against the in-repo overlay tree. Reports drift between the deployed root and the canonical source-of-truth in mios.git.",
      "chat_completions": "/usr/lib/mios/tools/chat-completions-api/repo_overlay_inspect.json",
      "responses": "/usr/lib/mios/tools/responses-api/repo_overlay_inspect.json",
      "dispatcher": "/usr/libexec/mios/tools/repo_overlay_inspect",
      "side_effects": "read-only"
    },
    {
      "name": "file_search",
      "description": "OpenAI Responses-API-shaped file_search tool. Backed by the local vector store (Qdrant by default; configurable via etc/mios/kb.conf.toml).",
      "responses": "/usr/lib/mios/tools/responses-api/file_search.json",
      "side_effects": "read-only",
      "responses_only": true,
      "spec_ref": "https://platform.openai.com/docs/guides/tools-file-search"
    },
    {
      "name": "mcp",
      "description": "OpenAI Responses-API-shaped MCP tool. Resolves to the server registry at /usr/share/mios/ai/v1/mcp.json.",
      "responses": "/usr/lib/mios/tools/responses-api/mcp.json",
      "side_effects": "varies-by-server",
      "responses_only": true,
      "registry": "/usr/share/mios/ai/v1/mcp.json",
      "spec_ref": "https://platform.openai.com/docs/guides/tools-remote-mcp"
    }
  ]
}