@nemesis-oss/ollama-sdk 1.7.0 → 1.9.0

package/dist/mcp/tools.json

@@ -1,18 +1,38 @@
 {
   "_comment": "AUTO-GENERATED by `npm run contract:generate`. DO NOT EDIT. Source: contracts/ir/ollama.ir.json.",
   "tools": [
+    {
+      "name": "ollama_balance",
+      "description": "Ollama GET /api/balance (native domain)\n\n- Cloud-only account endpoint — targets https://ollama.com, not the local Ollama server.\n- Requires an Ollama Cloud API key (set via OllamaClient credentials).\n- Takes no parameters. For usage history see the usage operation.\n- Rate limited to 10 requests/minute per user; 429 responses carry a Retry-After header.\n- Use OllamaClient.balance() — the generated NativeApi class does not expose this operation.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false,
+        "description": "GET /api/balance takes no request body."
+      },
+      "annotations": {
+        "title": "balance (Ollama)",
+        "readOnlyHint": true,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": false
+      },
+      "_operationId": "balance"
+    },
     {
       "name": "ollama_blobs",
       "description": "Ollama HEAD /api/blobs/{digest} (native domain)\n\n- HEAD-only endpoint for blob existence checks; declared in OpenAPI but not in the legacy parity manifest.",
       "inputSchema": {
         "type": "object",
         "properties": {
-          "prompt": {
+          "digest": {
             "type": "string",
-            "description": "Input for blobs"
+            "description": "path parameter: digest"
           }
         },
-        "additionalProperties": true
+        "required": ["digest"],
+        "additionalProperties": false,
+        "description": "HEAD /api/blobs/{digest} — 1 parameter."
       },
       "annotations": {
         "title": "blobs (Ollama)",
@@ -388,6 +408,13 @@
             "type": "string",
             "description": "Minimum Ollama version required by the model"
           },
+          "capabilities": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Capabilities to add without removing inherited or inferred capabilities (e.g. `decision` for compatible decision models)"
+          },
           "stream": {
             "type": "boolean",
             "default": true,
@@ -678,13 +705,9 @@
       "description": "Ollama GET /api/ps (native domain)",
       "inputSchema": {
         "type": "object",
-        "properties": {
-          "prompt": {
-            "type": "string",
-            "description": "Input for ps"
-          }
-        },
-        "additionalProperties": true
+        "properties": {},
+        "additionalProperties": false,
+        "description": "GET /api/ps takes no request body."
       },
       "annotations": {
         "title": "ps (Ollama)",
@@ -785,16 +808,186 @@
     },
     {
       "name": "ollama_systemOne",
-      "description": "Ollama POST /v1/systemone (native domain)\n\n- Local-only; Ollama Cloud rejects /v1/systemone.\n- Hard 64 KiB request body limit enforced by the server.\n- No images, no tools, no generation controls (temperature, top_p, etc.).\n- Experimental: behavioral surface may change between Ollama releases.",
+      "description": "Ollama POST /v1/systemone (native domain)\n\n- Local-only; Ollama Cloud rejects /v1/systemone.\n- 64 KiB request limit without images, 32 MiB with images (includes JSON/base64 overhead).\n- No tools, no generation controls (temperature, top_p, etc.).\n- Vision is model-dependent: images are accepted by vision-weighted models (Clef/Clef Flash) but not by text-only models.\n- Experimental: behavioral surface may change between Ollama releases.",
       "inputSchema": {
         "type": "object",
+        "required": ["model", "state", "questions"],
         "properties": {
-          "prompt": {
+          "model": {
             "type": "string",
-            "description": "Input for systemOne"
+            "pattern": "\\S",
+            "description": "Local model trained for System One, such as nimble. Requires compatible GGUF weights and a scoring-capable runner; cloud and MLX/Safetensors models are not supported."
+          },
+          "state": {
+            "description": "A nonempty string, or an object or array serialized as JSON text. Not interpreted as chat messages or multimodal input.",
+            "oneOf": [
+              {
+                "type": "string",
+                "pattern": "\\S"
+              },
+              {
+                "type": "object",
+                "additionalProperties": true
+              },
+              {
+                "type": "array",
+                "items": {}
+              }
+            ]
+          },
+          "images": {
+            "type": "array",
+            "description": "Base64-encoded images shared by all questions, in request order. Requires Clef or Clef Flash with vision weights. URLs and data URLs are not supported.",
+            "items": {
+              "type": "string",
+              "format": "byte"
+            }
+          },
+          "questions": {
+            "type": "object",
+            "description": "Named questions about the shared state. Answers are not passed to later questions.",
+            "minProperties": 1,
+            "maxProperties": 64,
+            "propertyNames": {
+              "pattern": "\\S"
+            },
+            "additionalProperties": {
+              "oneOf": [
+                {
+                  "title": "Choice",
+                  "type": "object",
+                  "required": ["type", "instructions", "criteria"],
+                  "properties": {
+                    "type": {
+                      "type": "string",
+                      "enum": ["choice"]
+                    },
+                    "instructions": {
+                      "description": "A nonempty string, or an object or array serialized as JSON text. Not interpreted as chat messages or multimodal input.",
+                      "oneOf": [
+                        {
+                          "type": "string",
+                          "pattern": "\\S"
+                        },
+                        {
+                          "type": "object",
+                          "additionalProperties": true
+                        },
+                        {
+                          "type": "array",
+                          "items": {}
+                        }
+                      ]
+                    },
+                    "criteria": {
+                      "type": "object",
+                      "description": "Option keys mapped to descriptions. A null description uses the key itself. Keys must not be blank; ties follow the model's option order.",
+                      "minProperties": 2,
+                      "maxProperties": 26,
+                      "propertyNames": {
+                        "pattern": "\\S"
+                      },
+                      "additionalProperties": {
+                        "type": ["string", "null"]
+                      }
+                    }
+                  }
+                },
+                {
+                  "title": "Noul",
+                  "type": "object",
+                  "required": ["type", "instructions"],
+                  "properties": {
+                    "type": {
+                      "type": "string",
+                      "enum": ["noul"]
+                    },
+                    "instructions": {
+                      "description": "A nonempty string, or an object or array serialized as JSON text. Not interpreted as chat messages or multimodal input.",
+                      "oneOf": [
+                        {
+                          "type": "string",
+                          "pattern": "\\S"
+                        },
+                        {
+                          "type": "object",
+                          "additionalProperties": true
+                        },
+                        {
+                          "type": "array",
+                          "items": {}
+                        }
+                      ]
+                    },
+                    "criteria": {
+                      "type": "object",
+                      "description": "Optional descriptions for the two outcomes. Omitted entries use No and Yes.",
+                      "properties": {
+                        "false": {
+                          "type": "string",
+                          "default": "No"
+                        },
+                        "true": {
+                          "type": "string",
+                          "default": "Yes"
+                        }
+                      },
+                      "additionalProperties": false
+                    }
+                  }
+                },
+                {
+                  "title": "Score",
+                  "type": "object",
+                  "required": ["type", "instructions", "criteria"],
+                  "properties": {
+                    "type": {
+                      "type": "string",
+                      "enum": ["score"]
+                    },
+                    "instructions": {
+                      "description": "A nonempty string, or an object or array serialized as JSON text. Not interpreted as chat messages or multimodal input.",
+                      "oneOf": [
+                        {
+                          "type": "string",
+                          "pattern": "\\S"
+                        },
+                        {
+                          "type": "object",
+                          "additionalProperties": true
+                        },
+                        {
+                          "type": "array",
+                          "items": {}
+                        }
+                      ]
+                    },
+                    "criteria": {
+                      "type": "array",
+                      "description": "Descriptions ordered from the lowest score (index 0) to the highest. Defines a scale from 0 to the number of criteria minus 1.",
+                      "minItems": 2,
+                      "maxItems": 26,
+                      "items": {
+                        "type": "string"
+                      }
+                    }
+                  }
+                }
+              ]
+            }
+          },
+          "keep_alive": {
+            "oneOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "number"
+              }
+            ],
+            "description": "How long to keep the model loaded after the request, as a duration string (such as 5m) or seconds. Zero unloads after the request; a negative value keeps it loaded. Defaults to the server's keep-alive setting (5m unless configured otherwise)."
           }
-        },
-        "additionalProperties": true
+        }
       },
       "annotations": {
         "title": "systemOne (Ollama)",
@@ -810,13 +1003,9 @@
       "description": "Ollama GET /api/tags (native domain)",
       "inputSchema": {
         "type": "object",
-        "properties": {
-          "prompt": {
-            "type": "string",
-            "description": "Input for tags"
-          }
-        },
-        "additionalProperties": true
+        "properties": {},
+        "additionalProperties": false,
+        "description": "GET /api/tags takes no request body."
       },
       "annotations": {
         "title": "tags (Ollama)",
@@ -827,18 +1016,32 @@
       },
       "_operationId": "tags"
     },
+    {
+      "name": "ollama_usage",
+      "description": "Ollama GET /api/usage (native domain)\n\n- Cloud-only account endpoint — targets https://ollama.com, not the local Ollama server.\n- Requires an Ollama Cloud API key (set via OllamaClient credentials).\n- Query parameters (not modeled by the generated runtime): range = 24h | 7d | 30d (server default 7d), scope = self | team (server default self; team scope requires a team admin).\n- Rate limited to 10 requests/minute per user; 429 responses carry a Retry-After header.\n- Use OllamaClient.usage() — the generated NativeApi class does not expose this operation.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false,
+        "description": "GET /api/usage takes no request body."
+      },
+      "annotations": {
+        "title": "usage (Ollama)",
+        "readOnlyHint": true,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": false
+      },
+      "_operationId": "usage"
+    },
     {
       "name": "ollama_version",
       "description": "Ollama GET /api/version (native domain)",
       "inputSchema": {
         "type": "object",
-        "properties": {
-          "prompt": {
-            "type": "string",
-            "description": "Input for version"
-          }
-        },
-        "additionalProperties": true
+        "properties": {},
+        "additionalProperties": false,
+        "description": "GET /api/version takes no request body."
       },
       "annotations": {
         "title": "version (Ollama)",
@@ -850,17 +1053,65 @@
       "_operationId": "version"
     },
     {
-      "name": "ollama_openaiChatCompletions",
-      "description": "Ollama POST /v1/chat/completions (openai domain)\n\n- Ollama exposes a subset of the OpenAI Chat Completions request fields; see docs/upstream/ollama-openai-compatibility.mdx.",
+      "name": "ollama_webFetch",
+      "description": "Ollama POST /api/web_fetch (native domain)\n\n- Cloud-only capability endpoint — targets https://ollama.com, not the local Ollama server.\n- Requires an Ollama Cloud API key (set via OllamaClient credentials).\n- Use OllamaClient.webFetch() — the generated NativeApi class does not expose this operation.",
       "inputSchema": {
         "type": "object",
+        "required": ["url"],
         "properties": {
-          "prompt": {
+          "url": {
             "type": "string",
-            "description": "Input for openaiChatCompletions"
+            "format": "uri",
+            "description": "The URL to fetch"
           }
-        },
-        "additionalProperties": true
+        }
+      },
+      "annotations": {
+        "title": "webFetch (Ollama)",
+        "readOnlyHint": false,
+        "destructiveHint": false,
+        "idempotentHint": false,
+        "openWorldHint": false
+      },
+      "_operationId": "webFetch"
+    },
+    {
+      "name": "ollama_webSearch",
+      "description": "Ollama POST /api/web_search (native domain)\n\n- Cloud-only capability endpoint — targets https://ollama.com, not the local Ollama server.\n- Requires an Ollama Cloud API key (set via OllamaClient credentials).\n- Use OllamaClient.webSearch() — the generated NativeApi class does not expose this operation.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["query"],
+        "properties": {
+          "query": {
+            "type": "string",
+            "description": "Search query string"
+          },
+          "max_results": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 10,
+            "default": 5,
+            "description": "Maximum number of results to return"
+          }
+        }
+      },
+      "annotations": {
+        "title": "webSearch (Ollama)",
+        "readOnlyHint": false,
+        "destructiveHint": false,
+        "idempotentHint": false,
+        "openWorldHint": false
+      },
+      "_operationId": "webSearch"
+    },
+    {
+      "name": "ollama_openaiChatCompletions",
+      "description": "Ollama POST /v1/chat/completions (openai domain)\n\n- Ollama exposes a subset of the OpenAI Chat Completions request fields; see docs/upstream/ollama-openai-compatibility.mdx.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false,
+        "description": "POST /v1/chat/completions takes no request body."
       },
       "annotations": {
         "title": "openaiChatCompletions (Ollama)",
@@ -876,13 +1127,9 @@
       "description": "Ollama POST /v1/completions (openai domain)",
       "inputSchema": {
         "type": "object",
-        "properties": {
-          "prompt": {
-            "type": "string",
-            "description": "Input for openaiCompletions"
-          }
-        },
-        "additionalProperties": true
+        "properties": {},
+        "additionalProperties": false,
+        "description": "POST /v1/completions takes no request body."
       },
       "annotations": {
         "title": "openaiCompletions (Ollama)",
@@ -898,13 +1145,9 @@
       "description": "Ollama POST /v1/embeddings (openai domain)",
       "inputSchema": {
         "type": "object",
-        "properties": {
-          "prompt": {
-            "type": "string",
-            "description": "Input for openaiEmbeddings"
-          }
-        },
-        "additionalProperties": true
+        "properties": {},
+        "additionalProperties": false,
+        "description": "POST /v1/embeddings takes no request body."
       },
       "annotations": {
         "title": "openaiEmbeddings (Ollama)",
@@ -920,13 +1163,9 @@
       "description": "Ollama GET /v1/models (openai domain)",
       "inputSchema": {
         "type": "object",
-        "properties": {
-          "prompt": {
-            "type": "string",
-            "description": "Input for openaiModels"
-          }
-        },
-        "additionalProperties": true
+        "properties": {},
+        "additionalProperties": false,
+        "description": "GET /v1/models takes no request body."
       },
       "annotations": {
         "title": "openaiModels (Ollama)",
@@ -943,12 +1182,14 @@
       "inputSchema": {
         "type": "object",
         "properties": {
-          "prompt": {
+          "model": {
             "type": "string",
-            "description": "Input for openaiModelsGetOne"
+            "description": "path parameter: model"
           }
         },
-        "additionalProperties": true
+        "required": ["model"],
+        "additionalProperties": false,
+        "description": "GET /v1/models/{model} — 1 parameter."
       },
       "annotations": {
         "title": "openaiModelsGetOne (Ollama)",
@@ -964,13 +1205,9 @@
       "description": "Ollama POST /v1/responses (openai domain)\n\n- Ollama implements a subset of the OpenAI Responses API; previous_response_id and conversation are explicitly unsupported.",
       "inputSchema": {
         "type": "object",
-        "properties": {
-          "prompt": {
-            "type": "string",
-            "description": "Input for openaiResponses"
-          }
-        },
-        "additionalProperties": true
+        "properties": {},
+        "additionalProperties": false,
+        "description": "POST /v1/responses takes no request body."
       },
       "annotations": {
         "title": "openaiResponses (Ollama)",
@@ -986,13 +1223,9 @@
       "description": "Ollama POST /v1/messages (anthropic domain)\n\n- tool_choice and metadata are explicitly unsupported by Ollama's Anthropic compat layer.\n- Nested cache_control fields under messages[].content[].cache_control are unsupported.",
       "inputSchema": {
         "type": "object",
-        "properties": {
-          "prompt": {
-            "type": "string",
-            "description": "Input for anthropicMessages"
-          }
-        },
-        "additionalProperties": true
+        "properties": {},
+        "additionalProperties": false,
+        "description": "POST /v1/messages takes no request body."
       },
       "annotations": {
         "title": "anthropicMessages (Ollama)",