Find runnable model files for a task within a RAM/VRAM budget. Fit is estimated; provenOnly needs exact tested hardware.
| Name | Required | Description | Default |
|---|---|---|---|
| os | No | ||
| ctx | No | ||
| task | Yes | ||
| model | No | ||
| ramGb | No | ||
| detail | No | summary | |
| hardware | No | ||
| commercial | No | ||
| provenOnly | No |
| Name | Required | Description | Default |
|---|---|---|---|
| local | No |
Changes observed during successful MCP inspections.
Input schema / additionalPropertiesRemoved value: -falseInput schema / properties / gpuRemoved value: -{
- "description": "Deprecated hardware preset alias.",
- "type": "string"
-}Input schema / properties / hardware / descriptionRemoved value: -"Memory text or preset; provenOnly requires an exact measured hardware class (see tool reference)."Input schema / properties / hardware / maxLengthRemoved value: -80Input schema / properties / model / maxLengthRemoved value: -200Input schema / properties / model / minLengthRemoved value: -1Input schema / properties / modelNameRemoved value: -{
- "description": "Alias for model.",
- "maxLength": 200,
- "minLength": 1,
- "type": "string"
-}Input schema / properties / model_nameRemoved value: -{
- "description": "Alias for model.",
- "maxLength": 200,
- "minLength": 1,
- "type": "string"
-}Input schema / properties / ramGb / descriptionRemoved value: -"System RAM in GB, instead of hardware or gpu."Input schema / properties / ramGb / exclusiveMinimumRemoved value: -0Input schema / properties / ramGb / maximumRemoved value: -2048Input schema / properties / requestedModelRemoved value: -{
- "description": "Alias for model.",
- "maxLength": 200,
- "minLength": 1,
- "type": "string"
-}Input schema / properties / task / maxLengthRemoved value: -120Output schema / additionalPropertiesRemoved value: -trueOutput schema / properties / alternativesRemoved value: -{
- "items": {
- "anyOf": [
- {
- "additionalProperties": true,
- "properties": {
- "board": {
- "type": "object"
- },
- "catalogDescription": {
- "additionalProperties": false,
- "properties": {
- "modelId": {
- "type": "string"
- },
- "schemaVersion": {
- "const": "hugging-bay.catalog-description.v1"
- },
- "task": {
- "type": "string"
- },
- "text": {
- "maxLength": 260,
- "type": "string"
- }
- },
- "required": [
- "schemaVersion",
- "modelId",
- "task",
- "text"
- ],
- "type": "object"
- },
- "details": {
- "properties": {
- "href": {
- "type": "string"
- },
- "tool": {
- "const": "get_artifact"
- }
- },
- "required": [
- "href",
- "tool"
- ],
- "type": "object"
- },
- "downloadable": {
- "type": [
- "boolean",
- "null"
- ]
- },
- "hosted": {
- "type": [
- "boolean",
- "null"
- ]
- },
- "id": {
- "type": "string"
- },
- "licenseLabel": {
- "type": "string"
- },
- "name": {
- "type": "string"
- },
- "next_call": {
- "type": "object"
- },
- "serve_verdict": {
- "additionalProperties": false,
- "properties": {
- "bytes_verified": {
- "type": "boolean"
- },
- "can_download": {
- "type": "boolean"
- },
- "checked_at": {
- "format": "date-time",
- "type": [
- "string",
- "null"
- ]
- },
- "evidence_url": {
- "type": [
- "string",
- "null"
- ]
- },
- "freshness": {
- "enum": [
- "current",
- "stale"
- ],
- "type": "string"
- },
- "note": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "additionalProperties": false,
- "properties": {
- "downloadable": {
- "type": "boolean"
- },
- "summary": {
- "type": "string"
- }
- },
- "required": [
- "summary"
- ],
- "type": "object"
- }
- ]
- },
- "noteMessage": {
- "type": "string"
- },
- "signature": {
- "enum": [
- "signed",
- "unsigned",
- "pending"
- ],
- "type": "string"
- }
- },
- "required": [
- "can_download",
- "bytes_verified",
- "signature",
- "freshness",
- "checked_at",
- "evidence_url"
- ],
- "type": "object"
- },
- "sizeBytes": {
- "type": [
- "number",
- "null"
- ]
- },
- "task": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "required": [
- "id",
- "name",
- "task",
- "sizeBytes",
- "licenseLabel",
- "hosted",
- "downloadable",
- "details"
- ],
- "type": "object"
- },
- {
- "type": "object"
- }
- ]
- },
- "type": "array"
-}Output schema / properties / fallbackRemoved value: -{
- "type": "object"
-}Output schema / properties / noteRemoved value: -{
- "properties": {
- "summary": {
- "type": "string"
- }
- },
- "type": "object"
-}Output schema / properties / recommendationRemoved value: -{
- "anyOf": [
- {
- "anyOf": [
- {
- "additionalProperties": true,
- "properties": {
- "board": {
- "type": "object"
- },
- "catalogDescription": {
- "additionalProperties": false,
- "properties": {
- "modelId": {
- "type": "string"
- },
- "schemaVersion": {
- "const": "hugging-bay.catalog-description.v1"
- },
- "task": {
- "type": "string"
- },
- "text": {
- "maxLength": 260,
- "type": "string"
- }
- },
- "required": [
- "schemaVersion",
- "modelId",
- "task",
- "text"
- ],
- "type": "object"
- },
- "details": {
- "properties": {
- "href": {
- "type": "string"
- },
- "tool": {
- "const": "get_artifact"
- }
- },
- "required": [
- "href",
- "tool"
- ],
- "type": "object"
- },
- "downloadable": {
- "type": [
- "boolean",
- "null"
- ]
- },
- "hosted": {
- "type": [
- "boolean",
- "null"
- ]
- },
- "id": {
- "type": "string"
- },
- "licenseLabel": {
- "type": "string"
- },
- "name": {
- "type": "string"
- },
- "next_call": {
- "type": "object"
- },
- "serve_verdict": {
- "additionalProperties": false,
- "properties": {
- "bytes_verified": {
- "type": "boolean"
- },
- "can_download": {
- "type": "boolean"
- },
- "checked_at": {
- "format": "date-time",
- "type": [
- "string",
- "null"
- ]
- },
- "evidence_url": {
- "type": [
- "string",
- "null"
- ]
- },
- "freshness": {
- "enum": [
- "current",
- "stale"
- ],
- "type": "string"
- },
- "note": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "additionalProperties": false,
- "properties": {
- "downloadable": {
- "type": "boolean"
- },
- "summary": {
- "type": "string"
- }
- },
- "required": [
- "summary"
- ],
- "type": "object"
- }
- ]
- },
- "noteMessage": {
- "type": "string"
- },
- "signature": {
- "enum": [
- "signed",
- "unsigned",
- "pending"
- ],
- "type": "string"
- }
- },
- "required": [
- "can_download",
- "bytes_verified",
- "signature",
- "freshness",
- "checked_at",
- "evidence_url"
- ],
- "type": "object"
- },
- "sizeBytes": {
- "type": [
- "number",
- "null"
- ]
- },
- "task": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "required": [
- "id",
- "name",
- "task",
- "sizeBytes",
- "licenseLabel",
- "hosted",
- "downloadable",
- "details"
- ],
- "type": "object"
- },
- {
- "type": "object"
- }
- ]
- },
- {
- "type": "null"
- }
- ]
-}Input schema / properties / commercial / descriptionRemoved value: -"True to require recorded permission for commercial use."Input schema / properties / ctx / descriptionRemoved value: -"Requested context length in tokens."Input schema / properties / detail / descriptionRemoved value: -"Summary rows by default; full returns detailed rows. Large results include bounded previews and detail links."Input schema / properties / gpu / descriptionPrevious value: -"Deprecated preset id; prefer hardware."New value: +"Deprecated hardware preset alias."Input schema / properties / hardware / descriptionPrevious value: -"Free text or preset for estimates. For provenOnly use an exact class: e2-8gb, e2-16gb, e2-32gb, c3-16gb, c3-32gb, apple-m2-16gb, rtx3060-12, rtx4060-8 or rtx4090-24. Generic memory never matches a measured class. No default."New value: +"Memory text or preset; provenOnly requires an exact measured hardware class (see tool reference)."Input schema / properties / model / descriptionRemoved value: -"Model name or owner/repo to check first; alternatives are labelled explicitly."Input schema / properties / os / descriptionRemoved value: -"Client OS for the tested local server handoff when enabled."Input schema / properties / provenOnly / descriptionRemoved value: -"Require fresh exact-hardware proof; returns testedRunPlan and receiptCard or no recommendation."Input schema / properties / ramGb / descriptionPrevious value: -"System RAM in GB; use instead of hardware or gpu."New value: +"System RAM in GB, instead of hardware or gpu."Input schema / properties / task / descriptionRemoved value: -"Task the model or service should perform."Output schema / properties / alternatives / items / anyOfPrevious value: -[
- {
- "additionalProperties": true,
- "properties": {
- "board": {
- "type": "object"
- },
- "details": {
- "properties": {
- "href": {
- "type": "string"
- },
- "tool": {
- "const": "get_artifact"
- }
- },
- "required": [
- "href",
- "tool"
- ],
- "type": "object"
- },
- "downloadable": {
- "type": [
- "boolean",
- "null"
- ]
- },
- "hosted": {
- "type": [
- "boolean",
- "null"
- ]
- },
- "id": {
- "type": "string"
- },
- "licenseLabel": {
- "type": "string"
- },
- "name": {
- "type": "string"
- },
- "next_call": {
- "type": "object"
- },
- "serve_verdict": {
- "additionalProperties": false,
- "properties": {
- "bytes_verified": {
- "type": "boolean"
- },
- "can_download": {
- "type": "boolean"
- },
- "checked_at": {
- "format": "date-time",
- "type": [
- "string",
- "null"
- ]
- },
- "evidence_url": {
- "type": [
- "string",
- "null"
- ]
- },
- "freshness": {
- "enum": [
- "current",
- "stale"
- ],
- "type": "string"
- },
- "note": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "additionalProperties": false,
- "properties": {
- "downloadable": {
- "type": "boolean"
- },
- "summary": {
- "type": "string"
- }
- },
- "required": [
- "summary"
- ],
- "type": "object"
- }
- ]
- },
- "noteMessage": {
- "description": "Original route note, when a public qualification occupies note.",
- "type": "string"
- },
- "signature": {
- "enum": [
- "signed",
- "unsigned",
- "pending"
- ],
- "type": "string"
- }
- },
- "required": [
- "can_download",
- "bytes_verified",
- "signature",
- "freshness",
- "checked_at",
- "evidence_url"
- ],
- "type": "object"
- },
- "sizeBytes": {
- "type": [
- "number",
- "null"
- ]
- },
- "task": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "required": [
- "id",
- "name",
- "task",
- "sizeBytes",
- "licenseLabel",
- "hosted",
- "downloadable",
- "details"
- ],
- "type": "object"
- },
- {
- "description": "Full details when detail is full, or a separate service handoff.",
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": true,
+ "properties": {
+ "board": {
+ "type": "object"
+ },
+ "catalogDescription": {
+ "additionalProperties": false,
+ "properties": {
+ "modelId": {
+ "type": "string"
+ },
+ "schemaVersion": {
+ "const": "hugging-bay.catalog-description.v1"
+ },
+ "task": {
+ "type": "string"
+ },
+ "text": {
+ "maxLength": 260,
+ "type": "string"
+ }
+ },
+ "required": [
+ "schemaVersion",
+ "modelId",
+ "task",
+ "text"
+ ],
+ "type": "object"
+ },
+ "details": {
+ "properties": {
+ "href": {
+ "type": "string"
+ },
+ "tool": {
+ "const": "get_artifact"
+ }
+ },
+ "required": [
+ "href",
+ "tool"
+ ],
+ "type": "object"
+ },
+ "downloadable": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "hosted": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "licenseLabel": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "next_call": {
+ "type": "object"
+ },
+ "serve_verdict": {
+ "additionalProperties": false,
+ "properties": {
+ "bytes_verified": {
+ "type": "boolean"
+ },
+ "can_download": {
+ "type": "boolean"
+ },
+ "checked_at": {
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "evidence_url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "freshness": {
+ "enum": [
+ "current",
+ "stale"
+ ],
+ "type": "string"
+ },
+ "note": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "downloadable": {
+ "type": "boolean"
+ },
+ "summary": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "summary"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ "noteMessage": {
+ "type": "string"
+ },
+ "signature": {
+ "enum": [
+ "signed",
+ "unsigned",
+ "pending"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "can_download",
+ "bytes_verified",
+ "signature",
+ "freshness",
+ "checked_at",
+ "evidence_url"
+ ],
+ "type": "object"
+ },
+ "sizeBytes": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "task": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "id",
+ "name",
+ "task",
+ "sizeBytes",
+ "licenseLabel",
+ "hosted",
+ "downloadable",
+ "details"
+ ],
+ "type": "object"
+ },
+ {
+ "type": "object"
+ }
+]Output schema / properties / recommendation / anyOfPrevious value: -[
- {
- "anyOf": [
- {
- "additionalProperties": true,
- "properties": {
- "board": {
- "type": "object"
- },
- "details": {
- "properties": {
- "href": {
- "type": "string"
- },
- "tool": {
- "const": "get_artifact"
- }
- },
- "required": [
- "href",
- "tool"
- ],
- "type": "object"
- },
- "downloadable": {
- "type": [
- "boolean",
- "null"
- ]
- },
- "hosted": {
- "type": [
- "boolean",
- "null"
- ]
- },
- "id": {
- "type": "string"
- },
- "licenseLabel": {
- "type": "string"
- },
- "name": {
- "type": "string"
- },
- "next_call": {
- "type": "object"
- },
- "serve_verdict": {
- "additionalProperties": false,
- "properties": {
- "bytes_verified": {
- "type": "boolean"
- },
- "can_download": {
- "type": "boolean"
- },
- "checked_at": {
- "format": "date-time",
- "type": [
- "string",
- "null"
- ]
- },
- "evidence_url": {
- "type": [
- "string",
- "null"
- ]
- },
- "freshness": {
- "enum": [
- "current",
- "stale"
- ],
- "type": "string"
- },
- "note": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "additionalProperties": false,
- "properties": {
- "downloadable": {
- "type": "boolean"
- },
- "summary": {
- "type": "string"
- }
- },
- "required": [
- "summary"
- ],
- "type": "object"
- }
- ]
- },
- "noteMessage": {
- "description": "Original route note, when a public qualification occupies note.",
- "type": "string"
- },
- "signature": {
- "enum": [
- "signed",
- "unsigned",
- "pending"
- ],
- "type": "string"
- }
- },
- "required": [
- "can_download",
- "bytes_verified",
- "signature",
- "freshness",
- "checked_at",
- "evidence_url"
- ],
- "type": "object"
- },
- "sizeBytes": {
- "type": [
- "number",
- "null"
- ]
- },
- "task": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "required": [
- "id",
- "name",
- "task",
- "sizeBytes",
- "licenseLabel",
- "hosted",
- "downloadable",
- "details"
- ],
- "type": "object"
- },
- {
- "description": "Full details when detail is full, or a separate service handoff.",
- "type": "object"
- }
- ]
- },
- {
- "type": "null"
- }
-]New value: +[
+ {
+ "anyOf": [
+ {
+ "additionalProperties": true,
+ "properties": {
+ "board": {
+ "type": "object"
+ },
+ "catalogDescription": {
+ "additionalProperties": false,
+ "properties": {
+ "modelId": {
+ "type": "string"
+ },
+ "schemaVersion": {
+ "const": "hugging-bay.catalog-description.v1"
+ },
+ "task": {
+ "type": "string"
+ },
+ "text": {
+ "maxLength": 260,
+ "type": "string"
+ }
+ },
+ "required": [
+ "schemaVersion",
+ "modelId",
+ "task",
+ "text"
+ ],
+ "type": "object"
+ },
+ "details": {
+ "properties": {
+ "href": {
+ "type": "string"
+ },
+ "tool": {
+ "const": "get_artifact"
+ }
+ },
+ "required": [
+ "href",
+ "tool"
+ ],
+ "type": "object"
+ },
+ "downloadable": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "hosted": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "licenseLabel": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "next_call": {
+ "type": "object"
+ },
+ "serve_verdict": {
+ "additionalProperties": false,
+ "properties": {
+ "bytes_verified": {
+ "type": "boolean"
+ },
+ "can_download": {
+ "type": "boolean"
+ },
+ "checked_at": {
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "evidence_url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "freshness": {
+ "enum": [
+ "current",
+ "stale"
+ ],
+ "type": "string"
+ },
+ "note": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "downloadable": {
+ "type": "boolean"
+ },
+ "summary": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "summary"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ "noteMessage": {
+ "type": "string"
+ },
+ "signature": {
+ "enum": [
+ "signed",
+ "unsigned",
+ "pending"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "can_download",
+ "bytes_verified",
+ "signature",
+ "freshness",
+ "checked_at",
+ "evidence_url"
+ ],
+ "type": "object"
+ },
+ "sizeBytes": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "task": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "id",
+ "name",
+ "task",
+ "sizeBytes",
+ "licenseLabel",
+ "hosted",
+ "downloadable",
+ "details"
+ ],
+ "type": "object"
+ },
+ {
+ "type": "object"
+ }
+ ]
+ },
+ {
+ "type": "null"
+ }
+]Output schema / properties / alternatives / items / anyOfPrevious value: -[
- {
- "additionalProperties": true,
- "properties": {
- "board": {
- "type": "object"
- },
- "details": {
- "properties": {
- "href": {
- "type": "string"
- },
- "tool": {
- "const": "get_artifact"
- }
- },
- "required": [
- "href",
- "tool"
- ],
- "type": "object"
- },
- "downloadable": {
- "type": [
- "boolean",
- "null"
- ]
- },
- "hosted": {
- "type": [
- "boolean",
- "null"
- ]
- },
- "id": {
- "type": "string"
- },
- "licenseLabel": {
- "type": "string"
- },
- "name": {
- "type": "string"
- },
- "next_call": {
- "type": "object"
- },
- "serve_verdict": {
- "additionalProperties": false,
- "properties": {
- "bytes_verified": {
- "type": "boolean"
- },
- "can_download": {
- "type": "boolean"
- },
- "checked_at": {
- "format": "date-time",
- "type": [
- "string",
- "null"
- ]
- },
- "evidence_url": {
- "type": [
- "string",
- "null"
- ]
- },
- "freshness": {
- "enum": [
- "current",
- "stale"
- ],
- "type": "string"
- },
- "signature": {
- "enum": [
- "signed",
- "unsigned",
- "pending"
- ],
- "type": "string"
- }
- },
- "required": [
- "can_download",
- "bytes_verified",
- "signature",
- "freshness",
- "checked_at",
- "evidence_url"
- ],
- "type": "object"
- },
- "sizeBytes": {
- "type": [
- "number",
- "null"
- ]
- },
- "task": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "required": [
- "id",
- "name",
- "task",
- "sizeBytes",
- "licenseLabel",
- "hosted",
- "downloadable",
- "details"
- ],
- "type": "object"
- },
- {
- "description": "Full details when detail is full, or a separate service handoff.",
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": true,
+ "properties": {
+ "board": {
+ "type": "object"
+ },
+ "details": {
+ "properties": {
+ "href": {
+ "type": "string"
+ },
+ "tool": {
+ "const": "get_artifact"
+ }
+ },
+ "required": [
+ "href",
+ "tool"
+ ],
+ "type": "object"
+ },
+ "downloadable": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "hosted": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "licenseLabel": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "next_call": {
+ "type": "object"
+ },
+ "serve_verdict": {
+ "additionalProperties": false,
+ "properties": {
+ "bytes_verified": {
+ "type": "boolean"
+ },
+ "can_download": {
+ "type": "boolean"
+ },
+ "checked_at": {
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "evidence_url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "freshness": {
+ "enum": [
+ "current",
+ "stale"
+ ],
+ "type": "string"
+ },
+ "note": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "downloadable": {
+ "type": "boolean"
+ },
+ "summary": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "summary"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ "noteMessage": {
+ "description": "Original route note, when a public qualification occupies note.",
+ "type": "string"
+ },
+ "signature": {
+ "enum": [
+ "signed",
+ "unsigned",
+ "pending"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "can_download",
+ "bytes_verified",
+ "signature",
+ "freshness",
+ "checked_at",
+ "evidence_url"
+ ],
+ "type": "object"
+ },
+ "sizeBytes": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "task": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "id",
+ "name",
+ "task",
+ "sizeBytes",
+ "licenseLabel",
+ "hosted",
+ "downloadable",
+ "details"
+ ],
+ "type": "object"
+ },
+ {
+ "description": "Full details when detail is full, or a separate service handoff.",
+ "type": "object"
+ }
+]Output schema / properties / recommendation / anyOfPrevious value: -[
- {
- "anyOf": [
- {
- "additionalProperties": true,
- "properties": {
- "board": {
- "type": "object"
- },
- "details": {
- "properties": {
- "href": {
- "type": "string"
- },
- "tool": {
- "const": "get_artifact"
- }
- },
- "required": [
- "href",
- "tool"
- ],
- "type": "object"
- },
- "downloadable": {
- "type": [
- "boolean",
- "null"
- ]
- },
- "hosted": {
- "type": [
- "boolean",
- "null"
- ]
- },
- "id": {
- "type": "string"
- },
- "licenseLabel": {
- "type": "string"
- },
- "name": {
- "type": "string"
- },
- "next_call": {
- "type": "object"
- },
- "serve_verdict": {
- "additionalProperties": false,
- "properties": {
- "bytes_verified": {
- "type": "boolean"
- },
- "can_download": {
- "type": "boolean"
- },
- "checked_at": {
- "format": "date-time",
- "type": [
- "string",
- "null"
- ]
- },
- "evidence_url": {
- "type": [
- "string",
- "null"
- ]
- },
- "freshness": {
- "enum": [
- "current",
- "stale"
- ],
- "type": "string"
- },
- "signature": {
- "enum": [
- "signed",
- "unsigned",
- "pending"
- ],
- "type": "string"
- }
- },
- "required": [
- "can_download",
- "bytes_verified",
- "signature",
- "freshness",
- "checked_at",
- "evidence_url"
- ],
- "type": "object"
- },
- "sizeBytes": {
- "type": [
- "number",
- "null"
- ]
- },
- "task": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "required": [
- "id",
- "name",
- "task",
- "sizeBytes",
- "licenseLabel",
- "hosted",
- "downloadable",
- "details"
- ],
- "type": "object"
- },
- {
- "description": "Full details when detail is full, or a separate service handoff.",
- "type": "object"
- }
- ]
- },
- {
- "type": "null"
- }
-]New value: +[
+ {
+ "anyOf": [
+ {
+ "additionalProperties": true,
+ "properties": {
+ "board": {
+ "type": "object"
+ },
+ "details": {
+ "properties": {
+ "href": {
+ "type": "string"
+ },
+ "tool": {
+ "const": "get_artifact"
+ }
+ },
+ "required": [
+ "href",
+ "tool"
+ ],
+ "type": "object"
+ },
+ "downloadable": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "hosted": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "licenseLabel": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "next_call": {
+ "type": "object"
+ },
+ "serve_verdict": {
+ "additionalProperties": false,
+ "properties": {
+ "bytes_verified": {
+ "type": "boolean"
+ },
+ "can_download": {
+ "type": "boolean"
+ },
+ "checked_at": {
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "evidence_url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "freshness": {
+ "enum": [
+ "current",
+ "stale"
+ ],
+ "type": "string"
+ },
+ "note": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "downloadable": {
+ "type": "boolean"
+ },
+ "summary": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "summary"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ "noteMessage": {
+ "description": "Original route note, when a public qualification occupies note.",
+ "type": "string"
+ },
+ "signature": {
+ "enum": [
+ "signed",
+ "unsigned",
+ "pending"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "can_download",
+ "bytes_verified",
+ "signature",
+ "freshness",
+ "checked_at",
+ "evidence_url"
+ ],
+ "type": "object"
+ },
+ "sizeBytes": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "task": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "id",
+ "name",
+ "task",
+ "sizeBytes",
+ "licenseLabel",
+ "hosted",
+ "downloadable",
+ "details"
+ ],
+ "type": "object"
+ },
+ {
+ "description": "Full details when detail is full, or a separate service handoff.",
+ "type": "object"
+ }
+ ]
+ },
+ {
+ "type": "null"
+ }
+]Output schema / properties / alternatives / items / anyOfPrevious value: -[
- {
- "additionalProperties": true,
- "properties": {
- "board": {
- "type": "object"
- },
- "details": {
- "properties": {
- "href": {
- "type": "string"
- },
- "tool": {
- "const": "get_artifact"
- }
- },
- "required": [
- "href",
- "tool"
- ],
- "type": "object"
- },
- "downloadable": {
- "type": [
- "boolean",
- "null"
- ]
- },
- "hosted": {
- "type": [
- "boolean",
- "null"
- ]
- },
- "id": {
- "type": "string"
- },
- "licenseLabel": {
- "type": "string"
- },
- "name": {
- "type": "string"
- },
- "next_call": {
- "type": "object"
- },
- "serve_verdict": {
- "additionalProperties": false,
- "properties": {
- "bytes_verified": {
- "type": "boolean"
- },
- "can_download": {
- "type": "boolean"
- },
- "checked_at": {
- "format": "date-time",
- "type": [
- "string",
- "null"
- ]
- },
- "evidence_url": {
- "type": [
- "string",
- "null"
- ]
- },
- "freshness": {
- "enum": [
- "current",
- "stale"
- ],
- "type": "string"
- },
- "note": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "additionalProperties": false,
- "properties": {
- "downloadable": {
- "type": "boolean"
- },
- "summary": {
- "type": "string"
- }
- },
- "required": [
- "summary"
- ],
- "type": "object"
- }
- ]
- },
- "noteMessage": {
- "description": "Original route note, when a public qualification occupies note.",
- "type": "string"
- },
- "signature": {
- "enum": [
- "signed",
- "unsigned",
- "pending"
- ],
- "type": "string"
- }
- },
- "required": [
- "can_download",
- "bytes_verified",
- "signature",
- "freshness",
- "checked_at",
- "evidence_url"
- ],
- "type": "object"
- },
- "sizeBytes": {
- "type": [
- "number",
- "null"
- ]
- },
- "task": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "required": [
- "id",
- "name",
- "task",
- "sizeBytes",
- "licenseLabel",
- "hosted",
- "downloadable",
- "details"
- ],
- "type": "object"
- },
- {
- "description": "Full details when detail is full, or a separate service handoff.",
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": true,
+ "properties": {
+ "board": {
+ "type": "object"
+ },
+ "details": {
+ "properties": {
+ "href": {
+ "type": "string"
+ },
+ "tool": {
+ "const": "get_artifact"
+ }
+ },
+ "required": [
+ "href",
+ "tool"
+ ],
+ "type": "object"
+ },
+ "downloadable": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "hosted": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "licenseLabel": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "next_call": {
+ "type": "object"
+ },
+ "serve_verdict": {
+ "additionalProperties": false,
+ "properties": {
+ "bytes_verified": {
+ "type": "boolean"
+ },
+ "can_download": {
+ "type": "boolean"
+ },
+ "checked_at": {
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "evidence_url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "freshness": {
+ "enum": [
+ "current",
+ "stale"
+ ],
+ "type": "string"
+ },
+ "signature": {
+ "enum": [
+ "signed",
+ "unsigned",
+ "pending"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "can_download",
+ "bytes_verified",
+ "signature",
+ "freshness",
+ "checked_at",
+ "evidence_url"
+ ],
+ "type": "object"
+ },
+ "sizeBytes": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "task": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "id",
+ "name",
+ "task",
+ "sizeBytes",
+ "licenseLabel",
+ "hosted",
+ "downloadable",
+ "details"
+ ],
+ "type": "object"
+ },
+ {
+ "description": "Full details when detail is full, or a separate service handoff.",
+ "type": "object"
+ }
+]Output schema / properties / recommendation / anyOfPrevious value: -[
- {
- "anyOf": [
- {
- "additionalProperties": true,
- "properties": {
- "board": {
- "type": "object"
- },
- "details": {
- "properties": {
- "href": {
- "type": "string"
- },
- "tool": {
- "const": "get_artifact"
- }
- },
- "required": [
- "href",
- "tool"
- ],
- "type": "object"
- },
- "downloadable": {
- "type": [
- "boolean",
- "null"
- ]
- },
- "hosted": {
- "type": [
- "boolean",
- "null"
- ]
- },
- "id": {
- "type": "string"
- },
- "licenseLabel": {
- "type": "string"
- },
- "name": {
- "type": "string"
- },
- "next_call": {
- "type": "object"
- },
- "serve_verdict": {
- "additionalProperties": false,
- "properties": {
- "bytes_verified": {
- "type": "boolean"
- },
- "can_download": {
- "type": "boolean"
- },
- "checked_at": {
- "format": "date-time",
- "type": [
- "string",
- "null"
- ]
- },
- "evidence_url": {
- "type": [
- "string",
- "null"
- ]
- },
- "freshness": {
- "enum": [
- "current",
- "stale"
- ],
- "type": "string"
- },
- "note": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "additionalProperties": false,
- "properties": {
- "downloadable": {
- "type": "boolean"
- },
- "summary": {
- "type": "string"
- }
- },
- "required": [
- "summary"
- ],
- "type": "object"
- }
- ]
- },
- "noteMessage": {
- "description": "Original route note, when a public qualification occupies note.",
- "type": "string"
- },
- "signature": {
- "enum": [
- "signed",
- "unsigned",
- "pending"
- ],
- "type": "string"
- }
- },
- "required": [
- "can_download",
- "bytes_verified",
- "signature",
- "freshness",
- "checked_at",
- "evidence_url"
- ],
- "type": "object"
- },
- "sizeBytes": {
- "type": [
- "number",
- "null"
- ]
- },
- "task": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "required": [
- "id",
- "name",
- "task",
- "sizeBytes",
- "licenseLabel",
- "hosted",
- "downloadable",
- "details"
- ],
- "type": "object"
- },
- {
- "description": "Full details when detail is full, or a separate service handoff.",
- "type": "object"
- }
- ]
- },
- {
- "type": "null"
- }
-]New value: +[
+ {
+ "anyOf": [
+ {
+ "additionalProperties": true,
+ "properties": {
+ "board": {
+ "type": "object"
+ },
+ "details": {
+ "properties": {
+ "href": {
+ "type": "string"
+ },
+ "tool": {
+ "const": "get_artifact"
+ }
+ },
+ "required": [
+ "href",
+ "tool"
+ ],
+ "type": "object"
+ },
+ "downloadable": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "hosted": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "licenseLabel": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "next_call": {
+ "type": "object"
+ },
+ "serve_verdict": {
+ "additionalProperties": false,
+ "properties": {
+ "bytes_verified": {
+ "type": "boolean"
+ },
+ "can_download": {
+ "type": "boolean"
+ },
+ "checked_at": {
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "evidence_url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "freshness": {
+ "enum": [
+ "current",
+ "stale"
+ ],
+ "type": "string"
+ },
+ "signature": {
+ "enum": [
+ "signed",
+ "unsigned",
+ "pending"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "can_download",
+ "bytes_verified",
+ "signature",
+ "freshness",
+ "checked_at",
+ "evidence_url"
+ ],
+ "type": "object"
+ },
+ "sizeBytes": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "task": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "id",
+ "name",
+ "task",
+ "sizeBytes",
+ "licenseLabel",
+ "hosted",
+ "downloadable",
+ "details"
+ ],
+ "type": "object"
+ },
+ {
+ "description": "Full details when detail is full, or a separate service handoff.",
+ "type": "object"
+ }
+ ]
+ },
+ {
+ "type": "null"
+ }
+]Output schema / properties / alternatives / items / anyOfPrevious value: -[
- {
- "additionalProperties": true,
- "properties": {
- "board": {
- "type": "object"
- },
- "details": {
- "properties": {
- "href": {
- "type": "string"
- },
- "tool": {
- "const": "get_artifact"
- }
- },
- "required": [
- "href",
- "tool"
- ],
- "type": "object"
- },
- "downloadable": {
- "type": [
- "boolean",
- "null"
- ]
- },
- "hosted": {
- "type": [
- "boolean",
- "null"
- ]
- },
- "id": {
- "type": "string"
- },
- "licenseLabel": {
- "type": "string"
- },
- "name": {
- "type": "string"
- },
- "next_call": {
- "type": "object"
- },
- "sizeBytes": {
- "type": [
- "number",
- "null"
- ]
- },
- "task": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "required": [
- "id",
- "name",
- "task",
- "sizeBytes",
- "licenseLabel",
- "hosted",
- "downloadable",
- "details"
- ],
- "type": "object"
- },
- {
- "description": "Full details when detail is full, or a separate service handoff.",
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": true,
+ "properties": {
+ "board": {
+ "type": "object"
+ },
+ "details": {
+ "properties": {
+ "href": {
+ "type": "string"
+ },
+ "tool": {
+ "const": "get_artifact"
+ }
+ },
+ "required": [
+ "href",
+ "tool"
+ ],
+ "type": "object"
+ },
+ "downloadable": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "hosted": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "licenseLabel": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "next_call": {
+ "type": "object"
+ },
+ "serve_verdict": {
+ "additionalProperties": false,
+ "properties": {
+ "bytes_verified": {
+ "type": "boolean"
+ },
+ "can_download": {
+ "type": "boolean"
+ },
+ "checked_at": {
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "evidence_url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "freshness": {
+ "enum": [
+ "current",
+ "stale"
+ ],
+ "type": "string"
+ },
+ "note": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "downloadable": {
+ "type": "boolean"
+ },
+ "summary": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "summary"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ "noteMessage": {
+ "description": "Original route note, when a public qualification occupies note.",
+ "type": "string"
+ },
+ "signature": {
+ "enum": [
+ "signed",
+ "unsigned",
+ "pending"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "can_download",
+ "bytes_verified",
+ "signature",
+ "freshness",
+ "checked_at",
+ "evidence_url"
+ ],
+ "type": "object"
+ },
+ "sizeBytes": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "task": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "id",
+ "name",
+ "task",
+ "sizeBytes",
+ "licenseLabel",
+ "hosted",
+ "downloadable",
+ "details"
+ ],
+ "type": "object"
+ },
+ {
+ "description": "Full details when detail is full, or a separate service handoff.",
+ "type": "object"
+ }
+]Output schema / properties / fallbackAdded value: +{
+ "type": "object"
+}Output schema / properties / localAdded value: +{
+ "enum": [
+ "found",
+ "none_found",
+ "checking"
+ ]
+}Output schema / properties / recommendation / anyOfPrevious value: -[
- {
- "anyOf": [
- {
- "additionalProperties": true,
- "properties": {
- "board": {
- "type": "object"
- },
- "details": {
- "properties": {
- "href": {
- "type": "string"
- },
- "tool": {
- "const": "get_artifact"
- }
- },
- "required": [
- "href",
- "tool"
- ],
- "type": "object"
- },
- "downloadable": {
- "type": [
- "boolean",
- "null"
- ]
- },
- "hosted": {
- "type": [
- "boolean",
- "null"
- ]
- },
- "id": {
- "type": "string"
- },
- "licenseLabel": {
- "type": "string"
- },
- "name": {
- "type": "string"
- },
- "next_call": {
- "type": "object"
- },
- "sizeBytes": {
- "type": [
- "number",
- "null"
- ]
- },
- "task": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "required": [
- "id",
- "name",
- "task",
- "sizeBytes",
- "licenseLabel",
- "hosted",
- "downloadable",
- "details"
- ],
- "type": "object"
- },
- {
- "description": "Full details when detail is full, or a separate service handoff.",
- "type": "object"
- }
- ]
- },
- {
- "type": "null"
- }
-]New value: +[
+ {
+ "anyOf": [
+ {
+ "additionalProperties": true,
+ "properties": {
+ "board": {
+ "type": "object"
+ },
+ "details": {
+ "properties": {
+ "href": {
+ "type": "string"
+ },
+ "tool": {
+ "const": "get_artifact"
+ }
+ },
+ "required": [
+ "href",
+ "tool"
+ ],
+ "type": "object"
+ },
+ "downloadable": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "hosted": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "licenseLabel": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "next_call": {
+ "type": "object"
+ },
+ "serve_verdict": {
+ "additionalProperties": false,
+ "properties": {
+ "bytes_verified": {
+ "type": "boolean"
+ },
+ "can_download": {
+ "type": "boolean"
+ },
+ "checked_at": {
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "evidence_url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "freshness": {
+ "enum": [
+ "current",
+ "stale"
+ ],
+ "type": "string"
+ },
+ "note": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "downloadable": {
+ "type": "boolean"
+ },
+ "summary": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "summary"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ "noteMessage": {
+ "description": "Original route note, when a public qualification occupies note.",
+ "type": "string"
+ },
+ "signature": {
+ "enum": [
+ "signed",
+ "unsigned",
+ "pending"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "can_download",
+ "bytes_verified",
+ "signature",
+ "freshness",
+ "checked_at",
+ "evidence_url"
+ ],
+ "type": "object"
+ },
+ "sizeBytes": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "task": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "id",
+ "name",
+ "task",
+ "sizeBytes",
+ "licenseLabel",
+ "hosted",
+ "downloadable",
+ "details"
+ ],
+ "type": "object"
+ },
+ {
+ "description": "Full details when detail is full, or a separate service handoff.",
+ "type": "object"
+ }
+ ]
+ },
+ {
+ "type": "null"
+ }
+]Input schema / properties / hardware / descriptionPrevious value: -"Free text or preset: 8gb-laptop, 16gb-laptop, cpu-only, 8gb, rtx3070-8, rtx3060-12, apple-m-16. No default."New value: +"Free text or preset for estimates. For provenOnly use an exact class: e2-8gb, e2-16gb, e2-32gb, c3-16gb, c3-32gb, apple-m2-16gb, rtx3060-12, rtx4060-8 or rtx4090-24. Generic memory never matches a measured class. No default."Input schema / properties / provenOnlyAdded value: +{
+ "description": "Require fresh exact-hardware proof; returns testedRunPlan and receiptCard or no recommendation.",
+ "type": "boolean"
+}Input schema / properties / osAdded value: +{
+ "description": "Client OS for the tested local server handoff when enabled.",
+ "enum": [
+ "macos",
+ "linux",
+ "windows"
+ ],
+ "type": "string"
+}Input schema / properties / modelAdded value: +{
+ "description": "Model name or owner/repo to check first; alternatives are labelled explicitly.",
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+}Input schema / properties / modelNameAdded value: +{
+ "description": "Alias for model.",
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+}Input schema / properties / model_nameAdded value: +{
+ "description": "Alias for model.",
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+}Input schema / properties / requestedModelAdded value: +{
+ "description": "Alias for model.",
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+}Input schema / properties / ramGbAdded value: +{
+ "description": "System RAM in GB; use instead of hardware or gpu.",
+ "exclusiveMinimum": 0,
+ "maximum": 2048,
+ "type": "number"
+}Input schema / properties / detail / descriptionPrevious value: -"Summary rows by default. Use full for detailed rows, or get_artifact with a returned id; large results include bounded previews and detail links."New value: +"Summary rows by default; full returns detailed rows. Large results include bounded previews and detail links."Input schema / properties / commercial / descriptionAdded value: +"True to require recorded permission for commercial use."Input schema / properties / ctx / descriptionAdded value: +"Requested context length in tokens."Input schema / properties / detailAdded value: +{
+ "default": "summary",
+ "description": "Summary rows by default. Use full for detailed rows, or get_artifact with a returned id; large results include bounded previews and detail links.",
+ "enum": [
+ "summary",
+ "full"
+ ],
+ "type": "string"
+}Input schema / properties / task / descriptionAdded value: +"Task the model or service should perform."Output schema / (root)Previous value: -nullNew value: +{
+ "additionalProperties": true,
+ "properties": {
+ "alternatives": {
+ "items": {
+ "anyOf": [
+ {
+ "additionalProperties": true,
+ "properties": {
+ "board": {
+ "type": "object"
+ },
+ "details": {
+ "properties": {
+ "href": {
+ "type": "string"
+ },
+ "tool": {
+ "const": "get_artifact"
+ }
+ },
+ "required": [
+ "href",
+ "tool"
+ ],
+ "type": "object"
+ },
+ "downloadable": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "hosted": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "licenseLabel": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "next_call": {
+ "type": "object"
+ },
+ "sizeBytes": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "task": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "id",
+ "name",
+ "task",
+ "sizeBytes",
+ "licenseLabel",
+ "hosted",
+ "downloadable",
+ "details"
+ ],
+ "type": "object"
+ },
+ {
+ "description": "Full details when detail is full, or a separate service handoff.",
+ "type": "object"
+ }
+ ]
+ },
+ "type": "array"
+ },
+ "note": {
+ "properties": {
+ "summary": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "recommendation": {
+ "anyOf": [
+ {
+ "anyOf": [
+ {
+ "additionalProperties": true,
+ "properties": {
+ "board": {
+ "type": "object"
+ },
+ "details": {
+ "properties": {
+ "href": {
+ "type": "string"
+ },
+ "tool": {
+ "const": "get_artifact"
+ }
+ },
+ "required": [
+ "href",
+ "tool"
+ ],
+ "type": "object"
+ },
+ "downloadable": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "hosted": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "licenseLabel": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "next_call": {
+ "type": "object"
+ },
+ "sizeBytes": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "task": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "id",
+ "name",
+ "task",
+ "sizeBytes",
+ "licenseLabel",
+ "hosted",
+ "downloadable",
+ "details"
+ ],
+ "type": "object"
+ },
+ {
+ "description": "Full details when detail is full, or a separate service handoff.",
+ "type": "object"
+ }
+ ]
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "type": "object"
+}Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=false, so safety is covered. The description adds a genuinely useful reliability caveat — fit is estimated, and provenOnly requires exactly tested hardware — but says nothing else about limits or result confidence beyond that single clause.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two tight, front-loaded sentences with no padding. The second sentence ('provenOnly needs exact tested hardware') is slightly cryptic in isolation, but the overall economy is good.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
An output schema exists so return values needn't be explained, and annotations cover safety. But for a 9-parameter tool with zero schema descriptions and no usage routing, the definition is too thin to let an agent call it confidently.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0% across 9 parameters, so the description must compensate and largely fails. It only hints at task, ramGb, hardware, and provenOnly; os, ctx, model, detail, and commercial are completely undocumented anywhere.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource ('Find runnable model files') plus the governing constraint (task within a RAM/VRAM budget). This distinguishes it reasonably from data-fetching siblings like get_model or get_serve_decision, though those alternatives are never named.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The phrase 'for a task within a RAM/VRAM budget' implies the use case, but the description never says when to prefer this over get_model, get_serve_decision, or deployment_plan, nor any exclusions. Usage is left to inference.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.