2026-11-05 16:22:12 +08:00

27563 lines
967 KiB
JSON

[
{
"manifest_version": "v2",
"resource_id": "tool.api.agify.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Estimate a population-level age from one first name",
"description": "Calls Agify.io's fixed name endpoint to estimate age and sample count for one first name; it is demographic estimation, not identity lookup or age verification. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"domain_tags": [
"nlp",
"reference"
],
"core_primitives": [
"lookup_name_age_estimate",
"return_agify_json_envelope"
],
"problem_space": "Population-level first-name age estimation; not personal identification, demographics beyond the returned estimate, or deterministic computation."
},
"constraint": {
"io_signature": "Input: one first-name string; output: JSON envelope from the wrapper containing Agify's age/count or HTTP error body with http_status. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"one non-empty first name string"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://api.agify.io/ with query name=<name>; no batch input or caller-selected endpoint",
"HTTP 400-599 responses and request exceptions produce status=error",
"HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"no auth, local cache, retry, or caller-selectable timeout; shared helper uses 25 seconds and User-Agent S-GAR/1.0",
"estimate depends on Agify's current population data and is not a verified individual's age"
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "name",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing Agify's first-name age estimate and count, plus requested URL and HTTP status."
}
},
"routing": {
"family": "first-name-age-estimation",
"intent_tags": [
"estimate age from a first name",
"get Agify demographic age count"
],
"negative_intents": [
"verify a person's actual age",
"identify a person or retrieve a personal profile"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.agify.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://agify.io/",
"license": "free",
"backed_by": "api.agify",
"recognized_public_tool": true,
"auth_required": false,
"source_hash": "sha256:6cb6ae90aded3115fe951617f37fe2c7d73dac17884b1dd6d42c2246ffdec742",
"local_implementation_uri": "file://Pool/resources/tools/api/api.agify.py",
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "name",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing Agify's first-name age estimate and count, plus requested URL and HTTP status."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://api.agify.io/",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
}
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.arxiv.search.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Search arXiv preprints by an all-fields query",
"description": "Queries arXiv's Atom feed endpoint with a fixed all:<query> search and optional max-results value. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"domain_tags": [
"research",
"science",
"search"
],
"core_primitives": [
"search_arxiv_preprints",
"return_feed_in_json_envelope"
],
"problem_space": "Academic preprint discovery by arXiv all-fields query; not full-text retrieval, peer-review validation, or general scholarly database search."
},
"constraint": {
"io_signature": "Input: query string and optional max_results string; output: JSON wrapper envelope with arXiv http_status and feed or HTTP error body. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"one arXiv search phrase",
"optional numeric max-results string; wrapper default is 3"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET http://export.arxiv.org/api/query with search_query=all:<query> and max_results=<value>; no field-specific query syntax exposed",
"only requests.RequestException becomes status=error",
"HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"wrapper does not parse Atom entries or truncate the response; the API controls feed content and result count",
"no auth, cache, or retry; shared helper uses a 25-second timeout and external results can change"
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "query",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "max_results",
"kind": "string",
"required": false,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing the arXiv feed body with requested URL and HTTP status."
}
},
"routing": {
"family": "academic-preprint-search",
"intent_tags": [
"search arXiv preprints",
"find academic papers by all-fields query"
],
"negative_intents": [
"download or summarize full paper PDFs",
"search clinical trials or general web pages"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.arxiv.search.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://info.arxiv.org/help/api/index.html",
"license": "arXiv-nonexclusive",
"recognized_public_tool": true,
"source_hash": "sha256:3f9ebaef9d551cd70ce8bfa275921f08ca50252d8c3327416822aa63a614c924",
"local_implementation_uri": "file://Pool/resources/tools/api/api.arxiv.search.py",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "query",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "max_results",
"kind": "string",
"required": false,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing the arXiv feed body with requested URL and HTTP status."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": null,
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
}
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.clinicaltrials.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Search ClinicalTrials.gov studies by one term",
"description": "Queries ClinicalTrials.gov v2 studies with one query.term and a fixed page size of three. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"domain_tags": [
"health",
"research"
],
"core_primitives": [
"search_registered_clinical_studies",
"return_trial_api_envelope"
],
"problem_space": "Clinical-trial registry discovery; not medical advice, trial eligibility determination, or literature search."
},
"constraint": {
"io_signature": "Input: one clinical-trial search term; output: JSON envelope containing http_status and the ClinicalTrials.gov studies or HTTP error response. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"one free-text query term"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://clinicaltrials.gov/api/v2/studies with query.term=<term> and pageSize=3; no pagination token or other filters exposed",
"only requests.RequestException becomes status=error",
"HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"wrapper preserves the API JSON without local parsing or truncation",
"no auth, cache, or retry; external registry contents and ordering may change"
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "query",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing up to three ClinicalTrials.gov study records, URL, and HTTP status.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "clinical-trial-registry-search",
"intent_tags": [
"search registered clinical trials",
"find studies on ClinicalTrials.gov"
],
"negative_intents": [
"give medical diagnosis or treatment advice",
"search arXiv or general academic literature"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.clinicaltrials.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://clinicaltrials.gov/data-api/api",
"license": "public-domain",
"recognized_public_tool": true,
"source_hash": "sha256:180e592e8a6938d471f019694cb86428867bd89f9bbaf07ac64daa8c4fab4d4c",
"local_implementation_uri": "file://Pool/resources/tools/api/api.clinicaltrials.py",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "query",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing up to three ClinicalTrials.gov study records, URL, and HTTP status.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://clinicaltrials.gov/api/v2/studies",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.coingecko.price.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Read current CoinGecko crypto prices in chosen fiat currencies",
"description": "Calls CoinGecko's fixed simple/price endpoint for one comma-separated coin-id list and an optional quote-currency list defaulting to usd. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"domain_tags": [
"finance",
"crypto"
],
"core_primitives": [
"lookup_crypto_spot_prices",
"return_coin_price_json"
],
"problem_space": "Current cryptocurrency spot-price lookup; not investment advice, historical pricing, exchange execution, or portfolio valuation."
},
"constraint": {
"io_signature": "Input: required coin ids and optional vs_currencies (default usd); output: JSON envelope containing http_status and CoinGecko price mapping or HTTP error body. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"comma-separated CoinGecko coin ids",
"optional comma-separated vs_currencies; wrapper default is usd"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://api.coingecko.com/api/v3/simple/price with ids=<ids> and optional vs_currencies=<currencies>, default usd; no market, history, or exchange filters",
"only requests.RequestException becomes status=error",
"HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"wrapper does not normalize or truncate results; current prices are time-sensitive and API rate limits may apply",
"no auth header, local cache, or retry; external network required and shared timeout is 25 seconds"
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "ids",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "vs_currencies",
"kind": "string",
"required": false,
"cli_position": 2,
"default": "usd",
"description": "Optional comma-separated quote currencies; wrapper defaults to usd."
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing CoinGecko's current coin-to-currency price mapping or HTTP error body, requested URL, and HTTP status; HTTP 400-599 responses and request exceptions produce error envelopes."
}
},
"routing": {
"family": "cryptocurrency-spot-price-lookup",
"intent_tags": [
"get current crypto prices",
"convert coin ids to fiat quote prices"
],
"negative_intents": [
"place a crypto trade or transfer",
"provide investment advice or historical price analysis"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.coingecko.price.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://www.coingecko.com/en/api",
"license": "CC-BY-4.0",
"recognized_public_tool": true,
"source_hash": "sha256:08eca0014ce0b7dd0af2acc57779dffa3db0e8739fa26045c15a76e73dec8a63",
"local_implementation_uri": "file://Pool/resources/tools/api/api.coingecko.price.py",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "ids",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "vs_currencies",
"kind": "string",
"required": false,
"cli_position": 2,
"default": "usd",
"description": "Optional comma-separated quote currencies; wrapper defaults to usd."
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing CoinGecko's current coin-to-currency price mapping or HTTP error body, requested URL, and HTTP status; HTTP 400-599 responses and request exceptions produce error envelopes."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://api.coingecko.com/api/v3/simple/price",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
}
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.crossref.works.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Search Crossref scholarly works and return three metadata records",
"description": "Queries Crossref's fixed works endpoint with one free-text query and rows=3, returning DOI and publication metadata in the shared JSON envelope. It is scholarly metadata discovery, not full-text retrieval or peer-review assessment.",
"domain_tags": [
"scholarly-metadata",
"doi-discovery",
"crossref-works"
],
"core_primitives": [
"search_crossref_works",
"return_doi_metadata_records"
],
"problem_space": "Crossref bibliographic work discovery by query; not full-text academic search, citation-quality judgment, article download, or clinical-trial lookup."
},
"constraint": {
"io_signature": "Input: one Crossref query at CLI position 1. Output: shared JSON envelope containing Crossref message metadata with up to three items, URL, and HTTP status. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"one free-text scholarly title, author, DOI fragment, or topic query"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://api.crossref.org/works with query=<argument> and rows=3",
"no filter, cursor, page, sort, select, mailto, full-text, or caller-selected rows input; all CLI arguments after position 1 are ignored",
"rows=3 is an API request limit; wrapper does not locally parse, paginate, or truncate the Crossref message",
"missing input is not validated and the query parameter is omitted",
"HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit."
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "query",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing up to three Crossref scholarly work metadata records and DOI fields, URL, and HTTP status.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "crossref-bibliographic-work-search",
"intent_tags": [
"search scholarly works by title or topic",
"find DOI and Crossref publication metadata"
],
"negative_intents": [
"retrieve full-text papers or PDFs",
"search clinical trials or judge article quality"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.crossref.works.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://api.crossref.org/",
"license": "public-domain",
"recognized_public_tool": true,
"source_hash": "sha256:23e97bf0ae73c820a774f2c01b24ccc49d622dacd39b3e37b3919fd274cc2736",
"local_implementation_uri": "file://Pool/resources/tools/api/api.crossref.works.py",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "query",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing up to three Crossref scholarly work metadata records and DOI fields, URL, and HTTP status.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://api.crossref.org/works",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.datamuse_words.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Find words related by meaning to one natural-language idea",
"description": "Calls Datamuse's fixed words endpoint with ml=<query> to return words related in meaning, preserving the provider's scored result list in the shared JSON envelope. It is semantic word association, not dictionary definition lookup.",
"domain_tags": [
"semantic-word-association",
"lexical-retrieval",
"datamuse"
],
"core_primitives": [
"find_semantically_related_words",
"return_datamuse_word_list"
],
"problem_space": "Meaning-based word discovery from one idea; not authoritative definitions, translation, spelling correction, or arbitrary web search."
},
"constraint": {
"io_signature": "Input: one meaning query at CLI position 1. Output: shared JSON envelope containing Datamuse word-score objects, URL, and HTTP status. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"one natural-language idea or phrase used as the Datamuse ml query"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://api.datamuse.com/words with query ml=<argument>",
"no relation selector, max count, score threshold, pagination, spelling, pronunciation, or batch input; all CLI arguments after position 1 are ignored",
"wrapper does not locally parse, sort, paginate, or truncate the returned word list",
"missing input is not validated and the ml parameter is omitted from the request",
"HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit."
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "query",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing Datamuse semantically related word-score objects, URL, and HTTP status.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "semantic-word-association",
"intent_tags": [
"find words related by meaning",
"use Datamuse to discover associated words"
],
"negative_intents": [
"look up a word definition or pronunciation",
"translate text or search arbitrary web pages"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.datamuse_words.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://www.datamuse.com/api/",
"license": "free",
"recognized_public_tool": true,
"source_hash": "sha256:2b5ed5c9804f71d9651bd61eec2807ec522fb81390983b92c8924a3c0b6de9bf",
"local_implementation_uri": "file://Pool/resources/tools/api/api.datamuse_words.py",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "query",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing Datamuse semantically related word-score objects, URL, and HTTP status.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://api.datamuse.com/words",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.dictionary.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Look up English definitions and phonetics for one word",
"description": "Fetches the Free Dictionary API English entry endpoint for one word and returns definitions, meanings, phonetics, and provider metadata in the shared JSON envelope. It is lexical lookup, not synonym generation or translation.",
"domain_tags": [
"english-dictionary",
"word-definitions",
"phonetics"
],
"core_primitives": [
"lookup_word_definition",
"return_dictionary_entry_envelope"
],
"problem_space": "English lexical entry lookup for definitions and pronunciation metadata; not word association, translation, spelling correction, or language tutoring."
},
"constraint": {
"io_signature": "Input: word path value at CLI position 1. Output: shared JSON envelope containing Free Dictionary API entry array or provider error, URL, and HTTP status. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"one English word or phrase path segment"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://api.dictionaryapi.dev/api/v2/entries/en/<word>",
"no language selection, part-of-speech filter, synonym query, pagination, or batch input; all CLI arguments after position 1 are ignored",
"wrapper does not URL-encode, parse, paginate, or truncate the provider entry array",
"missing input is not validated and is interpolated into the path",
"HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit."
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "word",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing Free Dictionary API definitions, meanings, phonetics, URL, and HTTP status.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "english-word-definition-lookup",
"intent_tags": [
"look up an English word definition",
"retrieve word phonetics and meanings"
],
"negative_intents": [
"find related words or synonyms",
"translate a word or generate a language lesson"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.dictionary.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://dictionaryapi.dev/",
"license": "MIT",
"recognized_public_tool": true,
"source_hash": "sha256:2f4b159e2ffba023ab357683fa833452547beaf3a67b0be3bf735a2b9cdd696c",
"local_implementation_uri": "file://Pool/resources/tools/api/api.dictionary.py",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "word",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing Free Dictionary API definitions, meanings, phonetics, URL, and HTTP status.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://api.dictionaryapi.dev/api/v2/entries/en/{a(1)}",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.dog_ceo.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Fetch one random Dog CEO image URL for an optional breed",
"description": "Calls Dog CEO's random-image endpoint: with a breed it uses the breed path, and without one it uses the all-breeds random endpoint. The wrapper returns the API's JSON message/status object; it does not download or emit image bytes.",
"domain_tags": [
"dog-breed-media",
"random-image-url",
"animal-reference"
],
"core_primitives": [
"select_random_dog_image",
"return_dog_ceo_json_envelope"
],
"problem_space": "Random dog image URL retrieval by optional breed; not image downloading, breed classification, veterinary information, or image generation."
},
"constraint": {
"io_signature": "Input: optional breed at CLI position 1. Output: shared JSON envelope containing Dog CEO JSON result, URL, and HTTP status. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"optional Dog CEO breed path such as hound or retriever/golden"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"breed supplied: fixed GET https://dog.ceo/api/breed/<breed>/images/random; omitted breed: fixed GET https://dog.ceo/api/breeds/image/random",
"no image bytes, count, list, size, format, pagination, or batch input; all CLI arguments after position 1 are ignored",
"wrapper does not URL-encode, validate, download, parse, paginate, or truncate the provider JSON",
"random selection and provider availability are external and no auth/cache/retry is used",
"HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit."
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "breed",
"kind": "string",
"required": false,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing the Dog CEO random image URL/message, URL, and HTTP status."
}
},
"routing": {
"family": "random-dog-image-url",
"intent_tags": [
"get a random dog image URL",
"retrieve a Dog CEO image by breed"
],
"negative_intents": [
"download or edit image bytes",
"identify a dog breed from a photo"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.dog_ceo.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://dog.ceo/dog-api/",
"license": "MIT",
"recognized_public_tool": true,
"source_hash": "sha256:fc32ec46785580baacaa344d11d84d8be1fbeec142de6d1caa03a9b78d46f480",
"local_implementation_uri": "file://Pool/resources/tools/api/api.dog_ceo.py",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "breed",
"kind": "string",
"required": false,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing the Dog CEO random image URL/message, URL, and HTTP status."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://dog.ceo/api/breed/{a(1)}/images/random",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
}
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.exchangerate.convert.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Convert one amount between two currencies via exchangerate.host",
"description": "Calls exchangerate.host's fixed convert endpoint with required from/to currency codes and an optional amount defaulting to 1. It performs provider-side amount conversion, distinct from Frankfurter's latest reference-rate lookup.",
"domain_tags": [
"currency-conversion",
"foreign-exchange",
"monetary-amounts"
],
"core_primitives": [
"convert_currency_amount",
"return_exchangerate_json_envelope"
],
"problem_space": "Numeric currency conversion for one amount and currency pair; not historical rates, central-bank reference-rate retrieval, or financial advice."
},
"constraint": {
"io_signature": "Input: from currency at CLI position 1, to currency at position 2, and optional amount at position 3. Output: shared JSON envelope containing exchangerate.host conversion result, URL, and HTTP status. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"one source currency code",
"one target currency code",
"optional amount string; wrapper default is 1"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://api.exchangerate.host/convert with from=<arg1>, to=<arg2>, amount=<arg3 or 1>",
"no date, historical range, rate source, rounding, batch conversion, or pagination input; all CLI arguments after position 3 are ignored",
"wrapper does not locally calculate, validate, parse, paginate, or truncate the provider result",
"no auth, cache, retry, or caller-selected timeout",
"HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit."
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "base",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "target",
"kind": "string",
"required": true,
"cli_position": 2
},
{
"name": "amount",
"kind": "string",
"required": false,
"cli_position": 3
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing exchangerate.host conversion result for the requested amount and currency pair, URL, and HTTP status.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "spot-currency-amount-conversion",
"intent_tags": [
"convert an amount between currencies",
"calculate exchangerate.host currency conversion"
],
"negative_intents": [
"look up ECB reference rates without an amount",
"retrieve historical foreign-exchange time series"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.exchangerate.convert.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://exchangerate.host/",
"license": "free",
"recognized_public_tool": true,
"source_hash": "sha256:ad8c664009392a004a1bb4b38227bdc5a560db055f7192a54cb8257bb4024cbf",
"local_implementation_uri": "file://Pool/resources/tools/api/api.exchangerate.convert.py",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "base",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "target",
"kind": "string",
"required": true,
"cli_position": 2
},
{
"name": "amount",
"kind": "string",
"required": false,
"cli_position": 3
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing exchangerate.host conversion result for the requested amount and currency pair, URL, and HTTP status.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://api.exchangerate.host/convert",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.fda_drug.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Search one openFDA drug-label query and return one record",
"description": "Calls openFDA's fixed drug label endpoint with the first CLI argument as the search expression and a fixed limit of one result. It returns regulatory label data, including provider error bodies in the shared success envelope, rather than diagnosing or recommending medication.",
"domain_tags": [
"drug-labels",
"openfda",
"regulatory-reference"
],
"core_primitives": [
"search_drug_labels",
"return_openfda_json_envelope"
],
"problem_space": "OpenFDA drug-label record lookup; not clinical diagnosis, prescribing, adverse-event interpretation, or full pharmacovigilance analysis."
},
"constraint": {
"io_signature": "Input: search expression at CLI position 1. Output: shared JSON envelope containing openFDA drug-label result, URL, and HTTP status. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"one openFDA drug-label search expression, commonly an exact field query such as openfda.brand_name:ASPIRIN"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://api.fda.gov/drug/label.json with search=<argument> and limit=1",
"no caller control for limit, skip, page, sort, endpoint, or database; all CLI arguments after position 1 are ignored",
"wrapper does not locally paginate, parse, or truncate the response beyond the API limit=1",
"missing input is not validated by the wrapper and can yield a provider response",
"HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit."
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "query",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing one openFDA drug-label result, URL, and HTTP status.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "openfda-drug-label-search",
"intent_tags": [
"search openFDA drug labels",
"retrieve regulatory medication label data"
],
"negative_intents": [
"diagnose a patient or recommend treatment",
"search adverse-event analytics or clinical trials"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.fda_drug.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://open.fda.gov/apis/",
"license": "CC0",
"recognized_public_tool": true,
"source_hash": "sha256:11b342a0ad14b1e4a466702c0938e5d0e51bfe32258cf4bc0209ea409a31d314",
"local_implementation_uri": "file://Pool/resources/tools/api/api.fda_drug.py",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "query",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing one openFDA drug-label result, URL, and HTTP status.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://api.fda.gov/drug/label.json",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.frankfurter.rates.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Retrieve Frankfurter ECB reference rates for one currency pair",
"description": "Calls Frankfurter's fixed latest-rates endpoint with optional from/to currency codes, defaulting to USD/EUR, and returns the provider response in the shared JSON envelope. It retrieves reference rates rather than converting an amount.",
"domain_tags": [
"foreign-exchange",
"ecb-reference-rates",
"currency-pairs"
],
"core_primitives": [
"lookup_latest_fx_rate",
"return_frankfurter_json_envelope"
],
"problem_space": "Latest ECB reference-rate lookup for a named currency pair; not amount conversion, historical time-series retrieval, or investment advice."
},
"constraint": {
"io_signature": "Input: optional from currency at CLI position 1 and optional to currency at position 2. Output: shared JSON envelope containing the Frankfurter latest-rates response, URL, and HTTP status. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"optional three-letter base currency code; wrapper default is USD",
"optional three-letter quote currency code; wrapper default is EUR"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://api.frankfurter.app/latest with query from=<from or USD>&to=<to or EUR>",
"no amount, date, historical range, rate selection, pagination, or batch currency input; all other CLI arguments are ignored",
"wrapper does not locally parse, paginate, or truncate the provider result",
"no auth, cache, retry, or caller-selected timeout",
"HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit."
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "from",
"kind": "string",
"required": false,
"default": "USD",
"cli_position": 1
},
{
"name": "to",
"kind": "string",
"required": false,
"default": "EUR",
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing Frankfurter latest ECB reference rates for the requested currency pair, URL, and HTTP status.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "latest-ecb-fx-rate-lookup",
"intent_tags": [
"get latest ECB exchange rate for a currency pair",
"look up Frankfurter reference rates"
],
"negative_intents": [
"convert a monetary amount between currencies",
"retrieve historical exchange-rate time series"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.frankfurter.rates.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://www.frankfurter.app/docs/",
"license": "MIT",
"recognized_public_tool": true,
"source_hash": "sha256:ff646531c573a476ff670960fa55a34a413d975b1bc8e2b8438e19a3ae7775b9",
"local_implementation_uri": "file://Pool/resources/tools/api/api.frankfurter.rates.py",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "from",
"kind": "string",
"required": false,
"default": "USD",
"cli_position": 1
},
{
"name": "to",
"kind": "string",
"required": false,
"default": "EUR",
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing Frankfurter latest ECB reference rates for the requested currency pair, URL, and HTTP status.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://api.frankfurter.app/latest",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.fruityvice.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Look up nutrition metadata for one named fruit",
"description": "Fetches Fruityvice's fixed fruit-by-name endpoint for one fruit and returns the provider's nutrition object in the shared JSON envelope. It is reference data lookup, not dietary advice or calorie calculation.",
"domain_tags": [
"fruit-nutrition",
"food-reference",
"nutrition-metadata"
],
"core_primitives": [
"lookup_fruit_nutrition",
"return_fruityvice_json_envelope"
],
"problem_space": "Named-fruit nutrition metadata retrieval; not medical nutrition counseling, meal planning, food-product barcode lookup, or nutrient recomputation."
},
"constraint": {
"io_signature": "Input: fruit path value at CLI position 1. Output: shared JSON envelope containing Fruityvice fruit nutrition object or provider error, URL, and HTTP status. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"one fruit name path segment understood by Fruityvice"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://www.fruityvice.com/api/fruit/<fruit>",
"no nutrient selection, serving-size conversion, fuzzy search, list endpoint, pagination, or batch input; all CLI arguments after position 1 are ignored",
"wrapper does not URL-encode, parse, paginate, or truncate the provider object",
"missing input is not validated and is interpolated into the path",
"HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit."
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "fruit",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing Fruityvice fruit nutrition metadata, URL, and HTTP status."
}
},
"routing": {
"family": "named-fruit-nutrition-lookup",
"intent_tags": [
"look up fruit nutrition data",
"retrieve Fruityvice metadata for a fruit"
],
"negative_intents": [
"give medical or dietary advice",
"look up packaged products or calculate a custom serving"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.fruityvice.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://www.fruityvice.com/",
"license": "free",
"backed_by": "api.fruityvice",
"recognized_public_tool": true,
"auth_required": false,
"source_hash": "sha256:1a67673884b96ffd0a99800738c0fd1636f2aa3c9a67a4ff2918fe2b7e497045",
"local_implementation_uri": "file://Pool/resources/tools/api/api.fruityvice.py",
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "fruit",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing Fruityvice fruit nutrition metadata, URL, and HTTP status."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://www.fruityvice.com/api/fruit/{a(1)}",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
}
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.genderize.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Estimate aggregate gender probability for one first name",
"description": "Queries Genderize.io with one name parameter and returns the provider's aggregate gender, probability, and count estimate in the shared JSON envelope. It is a population-level name estimate, not a person's verified identity attribute.",
"domain_tags": [
"name-gender-estimation",
"aggregate-demographics",
"genderize"
],
"core_primitives": [
"estimate_name_gender",
"return_genderize_probability"
],
"problem_space": "Aggregate first-name gender probability estimation; not identity verification, self-identification inference, personal profiling, or demographic fact retrieval."
},
"constraint": {
"io_signature": "Input: one name query at CLI position 1. Output: shared JSON envelope containing Genderize estimate, URL, and HTTP status. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"one first-name string for the Genderize name query"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://api.genderize.io/ with query name=<argument>",
"no country filter, batch names, confidence threshold, identity lookup, pagination, or other query input; all CLI arguments after position 1 are ignored",
"wrapper does not locally interpret, validate, paginate, or truncate the provider estimate",
"missing input is not validated and the name parameter is omitted",
"probabilities are aggregate estimates, not individual facts",
"HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit."
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "name",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing Genderize aggregate gender, probability, count estimate, URL, and HTTP status."
}
},
"routing": {
"family": "first-name-gender-probability-estimation",
"intent_tags": [
"estimate gender probability from a first name",
"retrieve Genderize aggregate name statistics"
],
"negative_intents": [
"verify or infer an individual's gender identity",
"identify a person or retrieve a personal profile"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.genderize.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://genderize.io/",
"license": "proprietary-free",
"backed_by": "genderize",
"recognized_public_tool": true,
"source_hash": "sha256:0e47751baa9a55134664d23e3c12925515fa033dc730c0cbd2e82a809b743bf2",
"local_implementation_uri": "file://Pool/resources/tools/api/api.genderize.py",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "name",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing Genderize aggregate gender, probability, count estimate, URL, and HTTP status."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://api.genderize.io/",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
}
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.google_dns.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Resolve a DNS record through Google DoH",
"description": "Queries Google Public DNS-over-HTTPS for required name and optional record type, defaulting type to A. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"domain_tags": [
"dns",
"network-resolution"
],
"core_primitives": [
"resolve_dns",
"query_google_doh"
],
"problem_space": "DNS record resolution; not domain ownership verification, website availability testing, or network intrusion."
},
"constraint": {
"io_signature": "Input: name at CLI position 1 and optional type at position 2. Output: shared JSON envelope with url, http_status, and Google DNS result. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"one DNS name",
"optional DNS record type string; default is A"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://dns.google/resolve with name=<name> and type=<type or A>",
"no DNSSEC, CD, DO, ECS, padding, response-format, pagination, or resolver-selection input",
"wrapper does not locally truncate or interpret Answer/Status fields",
"DNS answers are time-sensitive and resolver-dependent; no auth, cache, or retry"
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "name",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "type",
"kind": "string",
"required": false,
"default": "A",
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing Google DNS status and answer records, URL, and HTTP status."
}
},
"routing": {
"family": "dns-record-resolution",
"intent_tags": [
"resolve a DNS record",
"query Google Public DNS over HTTPS"
],
"negative_intents": [
"verify domain ownership",
"scan a host or diagnose a network intrusion"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.google_dns.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://developers.google.com/speed/public-dns/docs/doh",
"license": "proprietary-free",
"recognized_public_tool": true,
"source_hash": "sha256:a89761c6b84d690b92764512a0bd2fa09323e4edfd3ea23a9822f6b4d528050d",
"local_implementation_uri": "file://Pool/resources/tools/api/api.google_dns.py",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "name",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "type",
"kind": "string",
"required": false,
"default": "A",
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing Google DNS status and answer records, URL, and HTTP status."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://dns.google/resolve",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
}
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.hackernews_item.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Retrieve one Hacker News item by id",
"description": "Fetches the Firebase Hacker News item endpoint for one required numeric item id. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"domain_tags": [
"technology-news",
"community-content"
],
"core_primitives": [
"lookup_hackernews_item",
"retrieve_story_or_comment"
],
"problem_space": "Individual Hacker News story/comment/poll/job reference; not top-story listing, search, moderation, or news summarization."
},
"constraint": {
"io_signature": "Input: id at CLI position 1. Output: shared JSON envelope with url, http_status, and Hacker News item result. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"one Hacker News item id string or integer"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://hacker-news.firebaseio.com/v0/item/<id>.json",
"no topstories, newstories, search, child expansion, pagination, or comment-tree input",
"wrapper does not locally truncate or parse the item",
"deleted/dead/missing items are represented by the API response; no auth, cache, or retry"
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "id",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing one Hacker News item, URL, and HTTP status.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "hackernews-item-lookup",
"intent_tags": [
"look up a Hacker News story",
"retrieve a Hacker News comment or item by id"
],
"negative_intents": [
"list current top stories",
"search or summarize arbitrary news sources"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.hackernews_item.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/HackerNews/API",
"license": "MIT",
"recognized_public_tool": true,
"source_hash": "sha256:4c05b9310cb3c23eb42f65f38aef630092f1847b46ada50282df2df042f8f2bc",
"local_implementation_uri": "file://Pool/resources/tools/api/api.hackernews_item.py",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "id",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing one Hacker News item, URL, and HTTP status.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://hacker-news.firebaseio.com/v0/item/{a(1)}.json",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.ip_api_geo.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Retrieve approximate IP geolocation",
"description": "Calls ip-api.com/json with an optional IP path value; when omitted, the wrapper requests the root /json endpoint. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"domain_tags": [
"ip-geolocation",
"network-geo"
],
"core_primitives": [
"geolocate_ip",
"retrieve_ip_metadata"
],
"problem_space": "Approximate IP geolocation and network metadata; not precise physical tracking, identity resolution, or cybersecurity attribution."
},
"constraint": {
"io_signature": "Input: optional ip at CLI position 1. Output: shared JSON envelope with url, http_status, and ip-api result. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"optional IPv4 or IPv6 address string; omitted value uses the root JSON endpoint"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET http://ip-api.com/json/<ip>, or http://ip-api.com/json when ip is absent",
"no fields, language, callback, batch, pagination, or reverse geocoding input",
"wrapper does not locally truncate or interpret the API status field",
"location is approximate and service license/rate limits apply; no auth, cache, or retry"
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "ip",
"kind": "string",
"required": false,
"default": "",
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing ip-api location/network metadata, URL, and HTTP status."
}
},
"routing": {
"family": "ip-address-geolocation",
"intent_tags": [
"locate an IP approximately",
"retrieve IP country and network metadata"
],
"negative_intents": [
"track a person's exact location",
"identify an attacker or verify identity from an IP"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.ip_api_geo.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://ip-api.com/docs",
"license": "non-commercial-free",
"recognized_public_tool": true,
"source_hash": "sha256:6e6796fd3381b978ea6b79d99303f5cb791713b10cd1dbdd73ba654d2118415d",
"local_implementation_uri": "file://Pool/resources/tools/api/api.ip_api_geo.py",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "ip",
"kind": "string",
"required": false,
"default": "",
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing ip-api location/network metadata, URL, and HTTP status."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": null,
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
}
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.iss_location.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Retrieve the current ISS position",
"description": "Calls the Open Notify ISS-now endpoint with no inputs or query parameters. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"domain_tags": [
"space",
"iss-tracking"
],
"core_primitives": [
"get_iss_position",
"retrieve_spacecraft_location"
],
"problem_space": "Live International Space Station latitude/longitude retrieval; not orbital prediction, trajectory planning, or astronaut status."
},
"constraint": {
"io_signature": "Input: none. Output: shared JSON envelope with url, http_status, and ISS position result. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"no user-bindable input"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET http://api.open-notify.org/iss-now.json with no params",
"position is live at request time and not a historical track or forecast",
"wrapper does not locally truncate or parse the response",
"service availability and coordinate freshness are external; no auth, cache, or retry"
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing current ISS timestamp and latitude/longitude, URL, and HTTP status."
}
},
"routing": {
"family": "live-iss-location",
"intent_tags": [
"find the current ISS position",
"retrieve live space station coordinates"
],
"negative_intents": [
"predict the ISS future orbit",
"track another satellite or spacecraft"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.iss_location.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "http://open-notify.org/Open-Notify-API/",
"license": "free",
"recognized_public_tool": true,
"source_hash": "sha256:5625552c745912d3c127dc2d841e29648fb696afca1706128b6de8ba5f839893",
"local_implementation_uri": "file://Pool/resources/tools/api/api.iss_location.py",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing current ISS timestamp and latitude/longitude, URL, and HTTP status."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": null,
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
}
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.met_museum_art.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Search The Met museum collection",
"description": "Searches The Metropolitan Museum of Art Collection API with one required q parameter. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"domain_tags": [
"museum-art",
"cultural-heritage"
],
"core_primitives": [
"search_met_collection",
"find_artworks"
],
"problem_space": "Museum collection discovery; not artwork authentication, valuation, image licensing, or art criticism."
},
"constraint": {
"io_signature": "Input: q at CLI position 1. Output: shared JSON envelope with url, http_status, and The Met search result. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"one artwork, artist, culture, or collection search string"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://collectionapi.metmuseum.org/public/collection/v1/search with q=<input>",
"no department, date, geography, medium, pagination, or object-detail input",
"wrapper does not locally truncate or parse object IDs",
"search coverage and current collection data are external; no auth, cache, or retry"
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "q",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing The Met search count/object IDs, URL, and HTTP status."
}
},
"routing": {
"family": "museum-artwork-search",
"intent_tags": [
"search The Met art collection",
"find museum artwork object ids"
],
"negative_intents": [
"authenticate an artwork or estimate its value",
"request a museum image license"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.met_museum_art.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://metmuseum.github.io/",
"license": "CC0",
"recognized_public_tool": true,
"source_hash": "sha256:c1ea180830b908f9acd50e63b22d3549aa81bf0609b0574e12661c2da7894403",
"local_implementation_uri": "file://Pool/resources/tools/api/api.met_museum_art.py",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "q",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing The Met search count/object IDs, URL, and HTTP status."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://collectionapi.metmuseum.org/public/collection/v1/search",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
}
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.nager_holidays.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "List public holidays for a country and year",
"description": "Fetches Nager.Date PublicHolidays/<year>/<country_code> using required CLI positions year then country_code. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"domain_tags": [
"public-holidays",
"calendar",
"travel-planning"
],
"core_primitives": [
"lookup_public_holidays",
"retrieve_country_calendar"
],
"problem_space": "Country/year public-holiday reference; not personal calendar scheduling, business closure guarantees, or legal advice."
},
"constraint": {
"io_signature": "Input: year at CLI position 1 and country_code at position 2. Output: shared JSON envelope with url, http_status, and Nager result. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"calendar year string",
"ISO-like country code accepted by Nager.Date"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://date.nager.at/api/v3/PublicHolidays/<year>/<country_code>",
"no subdivision, language, holiday-type, pagination, or date-range input",
"wrapper does not locally truncate or normalize the holiday array",
"coverage and observed-holiday rules depend on Nager.Date data; no auth, cache, or retry"
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "year",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "country_code",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing country/year public-holiday records, URL, and HTTP status.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "country-public-holiday-calendar",
"intent_tags": [
"find public holidays by country and year",
"check a country's holiday calendar"
],
"negative_intents": [
"schedule a personal event",
"guarantee an employer or venue closure"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.nager_holidays.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://date.nager.at/swagger/index.html",
"license": "MIT",
"recognized_public_tool": true,
"source_hash": "sha256:17c4f8fd9723384dc8201b0fafc7915aaa98a589f529382fe9742a0c7e9365df",
"local_implementation_uri": "file://Pool/resources/tools/api/api.nager_holidays.py",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "year",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "country_code",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing country/year public-holiday records, URL, and HTTP status.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://date.nager.at/api/v3/PublicHolidays/{a(1)}/{a(2)}",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.nationalize.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Estimate nationality probabilities for a name",
"description": "Queries Nationalize.io with one required name parameter. The response is a probabilistic demographic estimate, not a verified identity attribute. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"domain_tags": [
"name-demographics",
"identity-estimation"
],
"core_primitives": [
"estimate_name_nationality",
"return_country_probabilities"
],
"problem_space": "Aggregate name-to-nationality probability estimation; not identity verification, ethnicity classification, or person profiling."
},
"constraint": {
"io_signature": "Input: name at CLI position 1. Output: shared JSON envelope with url, http_status, and Nationalize result. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"one personal name string"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://api.nationalize.io/ with name=<input>",
"probabilities are model estimates from aggregate data and do not establish a person's nationality",
"no age, gender, identity, confidence threshold, pagination, or batch input",
"wrapper does not locally truncate or interpret the country probability list; no auth, cache, or retry"
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "name",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing Nationalize name count and country probability estimates, URL, and HTTP status."
}
},
"routing": {
"family": "name-nationality-estimation",
"intent_tags": [
"estimate nationality probabilities from a name",
"retrieve Nationalize country predictions"
],
"negative_intents": [
"verify a person's nationality",
"infer sensitive identity attributes about an individual"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.nationalize.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://nationalize.io/",
"license": "free",
"recognized_public_tool": true,
"source_hash": "sha256:02fa74dde03e3a2f3784950ec9394f8bf2129ec5975d8dc1650a32979519829f",
"local_implementation_uri": "file://Pool/resources/tools/api/api.nationalize.py",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "name",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing Nationalize name count and country probability estimates, URL, and HTTP status."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://api.nationalize.io/",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
}
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.nominatim.geocode.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Forward-geocode a place query with Nominatim",
"description": "Searches Nominatim with required q, fixed format=json, and limit=3. Despite the legacy artifact label, the wrapper returns a JSON array of search objects rather than GeoJSON. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"domain_tags": [
"geocoding",
"openstreetmap"
],
"core_primitives": [
"forward_geocode",
"find_place_candidates"
],
"problem_space": "Place-name to coordinate lookup; not reverse geocoding, map rendering, routing, or address verification."
},
"constraint": {
"io_signature": "Input: q at CLI position 1. Output: shared JSON envelope with url, http_status, and Nominatim JSON result. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"one place, address, or free-form geocoding query"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://nominatim.openstreetmap.org/search with format=json and limit=3",
"no reverse-geocoding mode, country/language/viewbox/bounded inputs",
"API caps the requested result count at three; wrapper does not further truncate or paginate",
"usage policy, rate limits, and result quality are external; no cache or retry"
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "q",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing up to three Nominatim search objects, URL, and HTTP status."
}
},
"routing": {
"family": "forward-geocoding",
"intent_tags": [
"convert an address to coordinates",
"find place candidates with OpenStreetMap"
],
"negative_intents": [
"reverse geocode coordinates",
"calculate a route or render a map"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.nominatim.geocode.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://nominatim.org/release-docs/latest/api/Search/",
"license": "ODbL",
"recognized_public_tool": true,
"source_hash": "sha256:1ded51aa2738d303feed1c07bfd526b2a95e94cb574ebdb916a24e6c3d5a30d7",
"local_implementation_uri": "file://Pool/resources/tools/api/api.nominatim.geocode.py",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "q",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing up to three Nominatim search objects, URL, and HTTP status."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://nominatim.openstreetmap.org/search",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
}
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.open_meteo.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Fetch current weather at coordinates",
"description": "Calls Open-Meteo forecast with required latitude and longitude and fixed current_weather=true. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"domain_tags": [
"weather",
"meteorology"
],
"core_primitives": [
"query_current_weather",
"resolve_coordinate_weather"
],
"problem_space": "Coordinate-based current weather retrieval; not climate forecasting, severe-weather warning, or geocoding."
},
"constraint": {
"io_signature": "Input: latitude at CLI position 1 and longitude at position 2. Output: shared JSON envelope with url, http_status, and Open-Meteo result. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"latitude coordinate string or number",
"longitude coordinate string or number"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://api.open-meteo.com/v1/forecast with current_weather=true",
"no timezone, forecast_days, hourly, units, model, pagination, or geocoding input",
"wrapper does not locally truncate or parse the response",
"no authentication, cache, retry, or weather-alert guarantee"
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "latitude",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "longitude",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing Open-Meteo current weather data, URL, and HTTP status.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "coordinate-current-weather",
"intent_tags": [
"get current weather at coordinates",
"retrieve Open-Meteo weather JSON"
],
"negative_intents": [
"geocode a place name",
"issue a severe-weather warning or climate projection"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.open_meteo.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://open-meteo.com/en/docs",
"license": "CC-BY-4.0",
"recognized_public_tool": true,
"source_hash": "sha256:547b0ef909b79e9c35e5f8566e7aa5b5a38320a965f6c01efb7b2320616b273f",
"local_implementation_uri": "file://Pool/resources/tools/api/api.open_meteo.py",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "latitude",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "longitude",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing Open-Meteo current weather data, URL, and HTTP status.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://api.open-meteo.com/v1/forecast",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.openfoodfacts.product.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Look up an Open Food Facts product by barcode",
"description": "Fetches the Open Food Facts v2 product endpoint for one required barcode. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"domain_tags": [
"food-data",
"product-reference"
],
"core_primitives": [
"lookup_food_product",
"retrieve_barcode_product"
],
"problem_space": "Packaged-food product metadata; not nutrition advice, product recommendation, or barcode generation."
},
"constraint": {
"io_signature": "Input: barcode at CLI position 1. Output: shared JSON envelope with url, http_status, and Open Food Facts result. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"one product barcode string"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://world.openfoodfacts.org/api/v2/product/<barcode>.json",
"no field selection, locale, revision, pagination, or product search input",
"wrapper does not locally truncate or parse the product object",
"coverage and freshness depend on community-maintained product data; no authentication, cache, or retry"
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "barcode",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing one Open Food Facts product response, URL, and HTTP status."
}
},
"routing": {
"family": "food-product-barcode-lookup",
"intent_tags": [
"look up food product by barcode",
"retrieve Open Food Facts nutrition metadata"
],
"negative_intents": [
"recommend a diet or assess medical nutrition",
"search products without a barcode"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.openfoodfacts.product.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://world.openfoodfacts.org/data",
"license": "ODbL",
"recognized_public_tool": true,
"source_hash": "sha256:860ac8b7c6baac2a2db2b2b3593913421aca239a4096769bf9940b1f623b6267",
"local_implementation_uri": "file://Pool/resources/tools/api/api.openfoodfacts.product.py",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "barcode",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing one Open Food Facts product response, URL, and HTTP status."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://world.openfoodfacts.org/api/v2/product/{a(1)}.json",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
}
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.opensky_flights.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Fetch live OpenSky aircraft state vectors",
"description": "Calls the OpenSky states/all endpoint with no query parameters and returns the live aircraft state response. The existing bbox input is ignored because the wrapper reads no CLI arguments. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"domain_tags": [
"aviation",
"flight-tracking"
],
"core_primitives": [
"retrieve_aircraft_states",
"monitor_live_flights"
],
"problem_space": "Live aircraft state-vector retrieval; not route planning, flight-status lookup, or historical/paginated flight search."
},
"constraint": {
"io_signature": "Input: no user-bindable CLI parameters. Output: shared JSON envelope with url, http_status, and OpenSky result. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"no input; endpoint and query parameters are fixed by wrapper"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://opensky-network.org/api/states/all with no params",
"bbox is ignored/not exposed; no geographic filter, time, pagination, or sorting",
"wrapper does not locally truncate or parse the state-vector array",
"live availability, rate limits, and authentication policy are external and may vary"
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing live OpenSky state vectors, URL, and HTTP status."
}
},
"routing": {
"family": "live-aircraft-state-vectors",
"intent_tags": [
"see live aircraft positions",
"retrieve OpenSky flight state vectors"
],
"negative_intents": [
"search flights by route or booking status",
"retrieve historical aircraft tracks or paginated results"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.opensky_flights.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://openskynetwork.github.io/opensky-api/",
"license": "non-commercial",
"recognized_public_tool": true,
"source_hash": "sha256:16cf5d8d4f870ef878c5593f94369d5b9c7da9e43bb5f870e4538906471601b6",
"local_implementation_uri": "file://Pool/resources/tools/api/api.opensky_flights.py",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing live OpenSky state vectors, URL, and HTTP status."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://opensky-network.org/api/states/all",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
}
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.opentrivia.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Generate Open Trivia Database questions",
"description": "Calls OpenTDB with one optional amount argument, defaulting to amount=3. Category and all other filters are ignored because the wrapper never reads them. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"domain_tags": [
"trivia",
"education"
],
"core_primitives": [
"generate_trivia_questions",
"retrieve_quiz_items"
],
"problem_space": "General trivia question retrieval; not an assessment engine, answer validation service, or category-filtered quiz builder."
},
"constraint": {
"io_signature": "Input: optional amount at CLI position 1. Output: shared JSON envelope with url, http_status, and OpenTDB result. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"optional question count string; default is 3"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://opentdb.com/api.php with amount=<arg or 3>",
"category, difficulty, type, encoding, token, and pagination inputs are ignored/not exposed",
"wrapper does not locally truncate, decode HTML entities, or paginate questions",
"no authentication, cache, retry, or guarantee of deterministic question selection"
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "amount",
"kind": "string",
"required": false,
"default": "3",
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing OpenTDB response code and generated trivia questions, URL, and HTTP status."
}
},
"routing": {
"family": "trivia-question-generation",
"intent_tags": [
"generate trivia questions",
"create a small general-knowledge quiz"
],
"negative_intents": [
"generate category-filtered questions",
"grade an assessment or provide authoritative exam content"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.opentrivia.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://opentdb.com/api_config.php",
"license": "CC-BY-SA",
"recognized_public_tool": true,
"source_hash": "sha256:eacc1f32dde2674796aea729aa5d54e63a54e38f8848848164ea9a42d1bfa016",
"local_implementation_uri": "file://Pool/resources/tools/api/api.opentrivia.py",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "amount",
"kind": "string",
"required": false,
"default": "3",
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing OpenTDB response code and generated trivia questions, URL, and HTTP status."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://opentdb.com/api.php",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
}
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.poetrydb.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Retrieve poems by author",
"description": "Fetches PoetryDB author results using the required first CLI argument as the URL path value. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"domain_tags": [
"literature",
"poetry"
],
"core_primitives": [
"lookup_poetry",
"retrieve_author_poems"
],
"problem_space": "Poetry reference retrieval; not literary criticism, author biography, or title search."
},
"constraint": {
"io_signature": "Input: author at CLI position 1. Output: shared JSON envelope with url, http_status, and PoetryDB result. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"one author path value accepted by PoetryDB"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://poetrydb.org/author/<author>",
"title is not an accepted input and no second argument is read",
"wrapper does not URL-encode, parse, locally truncate, or paginate the result",
"no authentication, cache, retry, or guarantee that the author exists"
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "author",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing PoetryDB author results, URL, and HTTP status."
}
},
"routing": {
"family": "poetry-author-lookup",
"intent_tags": [
"find poems by author",
"retrieve PoetryDB author results"
],
"negative_intents": [
"search poems by title",
"write literary criticism or identify plagiarism"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.poetrydb.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/thundercomb/poetrydb",
"license": "GPL-3.0",
"recognized_public_tool": true,
"source_hash": "sha256:d5036831070e779a99d67e00455212863b14b7c8f2aea22ba22f83875145d7c6",
"local_implementation_uri": "file://Pool/resources/tools/api/api.poetrydb.py",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "author",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing PoetryDB author results, URL, and HTTP status."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://poetrydb.org/author/{a(1)}",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
}
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.pokeapi.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Look up one Pokémon resource",
"description": "Fetches https://pokeapi.co/api/v2/pokemon/<name>, lowercasing the required name before path construction. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"domain_tags": [
"gaming-reference",
"pokemon-data"
],
"core_primitives": [
"lookup_pokemon",
"retrieve_pokemon_resource"
],
"problem_space": "Pokémon reference data; not game battle simulation, team optimization, or arbitrary API browsing."
},
"constraint": {
"io_signature": "Input: name at CLI position 1. Output: shared JSON envelope with url, http_status, and Pokémon JSON result. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"one Pokémon name or numeric identifier"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://pokeapi.co/api/v2/pokemon/<lowercased-name>",
"name is lowercased and no other normalization or validation is performed",
"no endpoint selection, pagination, local truncation, cache, retry, or authentication",
"an unknown Pokémon is represented by the API HTTP response in the success envelope"
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "name",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing one Pokémon resource, URL, and HTTP status."
}
},
"routing": {
"family": "pokemon-reference-lookup",
"intent_tags": [
"look up Pokémon data",
"retrieve a Pokémon by name or id"
],
"negative_intents": [
"simulate a Pokémon battle",
"query general gaming or non-Pokémon data"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.pokeapi.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://pokeapi.co/docs/v2",
"license": "BSD-3",
"recognized_public_tool": true,
"source_hash": "sha256:dec98054e5cf12866e6d338524c338ac48d88762be3028117754bd50d033bd8e",
"local_implementation_uri": "file://Pool/resources/tools/api/api.pokeapi.py",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "name",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing one Pokémon resource, URL, and HTTP status."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://pokeapi.co/api/v2/pokemon/{str(arg(1)).lower()}",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
}
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.pubmed.esearch.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Search PubMed biomedical records",
"description": "Runs NCBI E-utilities esearch with db=pubmed, retmode=json, and retmax=5 for one required search term. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"domain_tags": [
"academic-research",
"biomedical-literature"
],
"core_primitives": [
"search_pubmed",
"retrieve_article_ids"
],
"problem_space": "Biomedical literature discovery; not full-text retrieval, clinical diagnosis, or evidence appraisal."
},
"constraint": {
"io_signature": "Input: term at CLI position 1. Output: shared JSON envelope with url, http_status, and PubMed JSON result. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"one PubMed ESearch query term or expression"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://eutils.ncbi.nlm.nih.gov/entrez/eutils/esearch.fcgi with db=pubmed, retmode=json, retmax=5",
"no caller control for database, return mode, page size, pagination, or sort",
"wrapper does not locally truncate or parse the returned JSON",
"no authentication, cache, retry, or full article text"
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "term",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing PubMed ESearch metadata, up to five IDs, URL, and HTTP status.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "pubmed-biomedical-search",
"intent_tags": [
"find biomedical papers",
"search PubMed by query term"
],
"negative_intents": [
"retrieve full article text",
"diagnose a patient or give medical advice"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.pubmed.esearch.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://www.ncbi.nlm.nih.gov/books/NBK25501/",
"license": "public-domain",
"recognized_public_tool": true,
"source_hash": "sha256:ca1cd22feaceb66fcc9479a63465e4668e99901e70280d00e7624bb8c9714ec9",
"local_implementation_uri": "file://Pool/resources/tools/api/api.pubmed.esearch.py",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "term",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Shared JSON envelope containing PubMed ESearch metadata, up to five IDs, URL, and HTTP status.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://eutils.ncbi.nlm.nih.gov/entrez/eutils/esearch.fcgi",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.randomuser.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Generate random synthetic user profiles",
"description": "Calls RandomUser.me's fixed API endpoint with a results count (default 2). HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"domain_tags": [
"data",
"testing"
],
"core_primitives": [
"generate_synthetic_user_profiles",
"return_random_user_json"
],
"problem_space": "Synthetic test/demo profile generation; not real-person lookup, identity verification, or production user provisioning."
},
"constraint": {
"io_signature": "Input: optional results count (default 2); output: JSON envelope containing http_status and generated synthetic user profiles or HTTP error body. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"optional results-count string; wrapper default is 2"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://randomuser.me/api/ with results=<count>; no seed, nationality, gender, pagination, or field filtering exposed",
"only requests.RequestException becomes status=error",
"HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"generated profiles are provider data and wrapper does not locally truncate or validate them",
"no auth, cache, or retry; output is intentionally non-deterministic and external network/rate limits apply"
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "results",
"kind": "string",
"required": false,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing RandomUser.me synthetic profiles and info metadata, URL, and HTTP status."
}
},
"routing": {
"family": "synthetic-user-profile-generation",
"intent_tags": [
"generate fake user profiles for testing",
"create random demo identity data"
],
"negative_intents": [
"find or identify a real person",
"create production accounts or verify identity"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.randomuser.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://randomuser.me/documentation",
"license": "MIT",
"backed_by": "api.randomuser",
"recognized_public_tool": true,
"auth_required": false,
"source_hash": "sha256:ec56eef81598bbe17623d0fad397191988a886e3c4b6d5540110ee6e3d8ca985",
"local_implementation_uri": "file://Pool/resources/tools/api/api.randomuser.py",
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "results",
"kind": "string",
"required": false,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing RandomUser.me synthetic profiles and info metadata, URL, and HTTP status."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://randomuser.me/api/",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
}
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.rest_countries.info.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Look up country facts by country name",
"description": "Calls REST Countries v3.1's fixed name endpoint for one country name. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"domain_tags": [
"geo",
"reference"
],
"core_primitives": [
"lookup_country_profile",
"return_country_reference_data"
],
"problem_space": "Country reference-data lookup; not geocoding, travel advice, current political verification, or weather."
},
"constraint": {
"io_signature": "Input: one country name; output: JSON envelope containing http_status and REST Countries country records or HTTP error body. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"one country name path segment"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://restcountries.com/v3.1/name/<country>; no field selection, exact-match, currency, language, or pagination option",
"only requests.RequestException becomes status=error",
"HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"wrapper does not normalize or truncate the returned array; API may return multiple fuzzy matches",
"no auth, cache, or retry; country metadata can change and external network is required"
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "country",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing REST Countries country record(s), URL, and HTTP status.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "country-reference-profile-lookup",
"intent_tags": [
"look up country population area and currencies",
"retrieve country reference data by name"
],
"negative_intents": [
"geocode an address or coordinate",
"retrieve live weather or current political news"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.rest_countries.info.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://restcountries.com/",
"license": "MPL-2.0",
"recognized_public_tool": true,
"source_hash": "sha256:174331922981b71eadcac522fef780b8c60aae906c18e64e86ae00721063d0dd",
"local_implementation_uri": "file://Pool/resources/tools/api/api.rest_countries.info.py",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "country",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing REST Countries country record(s), URL, and HTTP status.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://restcountries.com/v3.1/name/{a(1)}",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.rickandmorty.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Retrieve Rick and Morty characters, episodes, or locations",
"description": "Calls the Rick and Morty API with an optional resource path (default character) and optional id. The wrapper performs no allowlist validation and may splice any non-empty path segment into the API URL. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"domain_tags": [
"media",
"reference"
],
"core_primitives": [
"lookup_rick_and_morty_resource",
"fetch_optional_entity_id"
],
"problem_space": "Rick and Morty fictional-universe reference lookup; not general media search, episode streaming, or factual biography."
},
"constraint": {
"io_signature": "Input: optional non-empty resource path (default character) and optional id; output: JSON envelope containing http_status and Rick and Morty API JSON or HTTP error body. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"optional non-empty resource path segment; wrapper default character and does not enforce an allowlist",
"optional id string appended as /<id>"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed base https://rickandmortyapi.com/api/<resource>[/<id>]; any non-empty resource segment may be spliced into the URL without allowlist validation",
"only requests.RequestException becomes status=error",
"HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"no filters, search query, pagination controls, or batch ids exposed; wrapper preserves the API response without local parsing or truncation",
"public endpoint needs no auth but has provider rate limits; no cache or retry"
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "resource",
"kind": "string",
"required": false,
"description": "Optional resource path segment; wrapper defaults to character and does not enforce an allowlist.",
"cli_position": 1
},
{
"name": "id",
"kind": "string",
"required": false,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing a Rick and Morty character, episode, location, or collection response, URL, and HTTP status."
}
},
"routing": {
"family": "fictional-universe-entity-lookup",
"intent_tags": [
"look up Rick and Morty characters",
"retrieve Rick and Morty episode or location data"
],
"negative_intents": [
"search real-world people or media databases",
"stream episodes or provide general entertainment recommendations"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.rickandmorty.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://rickandmortyapi.com/documentation",
"license": "MIT",
"backed_by": "api.rickandmorty",
"recognized_public_tool": true,
"auth_required": false,
"source_hash": "sha256:51a498f737f3e785c8dde1d61c36f4396efc891f8b9f0e37a3cab5b84b8cf881",
"local_implementation_uri": "file://Pool/resources/tools/api/api.rickandmorty.py",
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "resource",
"kind": "string",
"required": false,
"cli_position": 1,
"description": "Optional resource path segment; wrapper defaults to character and does not enforce an allowlist."
},
{
"name": "id",
"kind": "string",
"required": false,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing a Rick and Morty character, episode, location, or collection response, URL, and HTTP status."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://rickandmortyapi.com/api/{a(1,",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
}
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.stackexchange.search.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Search Stack Exchange questions by title",
"description": "Queries Stack Exchange API v2.3's fixed search endpoint using an intitle term, a site (default stackoverflow), descending vote order, and vote sort. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"domain_tags": [
"swe",
"knowledge"
],
"core_primitives": [
"search_stackexchange_questions",
"rank_questions_by_votes"
],
"problem_space": "Stack Exchange Q&A discovery by title term; not answer generation, full-network search, or live site moderation."
},
"constraint": {
"io_signature": "Input: title query and optional Stack Exchange site (default stackoverflow); output: JSON envelope containing http_status and the API question result or HTTP error body. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"one title search string",
"optional Stack Exchange API site name; wrapper default stackoverflow"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://api.stackexchange.com/2.3/search with intitle=<q>, site=<site>, order=desc, sort=votes; no page, pagesize, tag, or body filter exposed",
"only requests.RequestException becomes status=error",
"HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"wrapper does not paginate, parse, or truncate the API response; API default page size and quota apply",
"no API key, cache, or retry; external question ordering and quota state are non-deterministic"
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "q",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "site",
"kind": "string",
"required": false,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing Stack Exchange question items and quota/pagination metadata, URL, and HTTP status.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "stackexchange-question-title-search",
"intent_tags": [
"search Stack Overflow questions by title",
"find Stack Exchange Q&A ranked by votes"
],
"negative_intents": [
"write or post an answer",
"search arXiv, Wikipedia, or arbitrary web pages"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.stackexchange.search.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://api.stackexchange.com/docs",
"license": "CC-BY-SA",
"recognized_public_tool": true,
"source_hash": "sha256:55fc37020c08c85746e0c6d995e8b9e8330b6cbeedd012f729a69418fde78ded",
"local_implementation_uri": "file://Pool/resources/tools/api/api.stackexchange.search.py",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "q",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "site",
"kind": "string",
"required": false,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing Stack Exchange question items and quota/pagination metadata, URL, and HTTP status.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://api.stackexchange.com/2.3/search",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.thecocktaildb.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Search cocktail recipes by drink name",
"description": "Calls TheCocktailDB's fixed free search endpoint with one drink-name query. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"domain_tags": [
"food",
"reference"
],
"core_primitives": [
"search_cocktail_recipes",
"return_cocktail_recipe_json"
],
"problem_space": "Cocktail recipe discovery by drink name; not alcohol-safety advice, bartending execution, or meal-recipe search."
},
"constraint": {
"io_signature": "Input: one cocktail-name query; output: JSON envelope containing http_status and TheCocktailDB recipe response or HTTP error body. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"one cocktail or drink name string"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://www.thecocktaildb.com/api/json/v1/1/search.php with s=<query>; no ingredient, category, id, or pagination filter",
"only requests.RequestException becomes status=error",
"HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"wrapper preserves the API response without local parsing or truncation",
"free endpoint has no caller auth but provider rate limits may apply; no cache or retry"
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "query",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing TheCocktailDB cocktail recipe search result, URL, and HTTP status."
}
},
"routing": {
"family": "cocktail-recipe-name-search",
"intent_tags": [
"search cocktail recipes",
"find a drink recipe by name"
],
"negative_intents": [
"search meal recipes",
"provide medical or alcohol-safety advice"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.thecocktaildb.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://www.thecocktaildb.com/api.php",
"license": "free",
"backed_by": "api.thecocktaildb",
"recognized_public_tool": true,
"auth_required": false,
"source_hash": "sha256:3ab7da1ed24fcf43582ef63660575c741727f79497e46c3d561d39853e507141",
"local_implementation_uri": "file://Pool/resources/tools/api/api.thecocktaildb.py",
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "query",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing TheCocktailDB cocktail recipe search result, URL, and HTTP status."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://www.thecocktaildb.com/api/json/v1/1/search.php",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
}
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.themealdb.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Search meal recipes by name",
"description": "Calls TheMealDB's fixed free search endpoint with one meal-name query. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"domain_tags": [
"food",
"reference"
],
"core_primitives": [
"search_meal_recipes",
"return_meal_recipe_json"
],
"problem_space": "Meal recipe discovery by name; not nutrition calculation, dietary safety advice, or ingredient substitution planning."
},
"constraint": {
"io_signature": "Input: one meal-name query; output: JSON envelope containing http_status and TheMealDB recipe response or HTTP error body. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"one meal name or partial-name string"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://www.themealdb.com/api/json/v1/1/search.php with s=<query>; no ingredient, category, area, id, or pagination filter",
"only requests.RequestException becomes status=error",
"HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"wrapper preserves the API response without local parsing or truncation",
"free endpoint has no caller auth but is rate-limited by the provider; no cache or retry"
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "query",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing TheMealDB meal recipe search result, URL, and HTTP status."
}
},
"routing": {
"family": "meal-recipe-name-search",
"intent_tags": [
"search meal recipes",
"find a recipe by meal name"
],
"negative_intents": [
"search cocktail recipes",
"calculate nutrition or give dietary medical advice"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.themealdb.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://www.themealdb.com/api.php",
"license": "free",
"backed_by": "api.themealdb",
"recognized_public_tool": true,
"auth_required": false,
"source_hash": "sha256:577496edb57e7263f5f41437f17c1fbe277dd42635c880d4ac08923143553078",
"local_implementation_uri": "file://Pool/resources/tools/api/api.themealdb.py",
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "query",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing TheMealDB meal recipe search result, URL, and HTTP status."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://www.themealdb.com/api/json/v1/1/search.php",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
}
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.thesportsdb.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Search TheSportsDB teams by name",
"description": "Calls TheSportsDB's fixed v1 free searchteams endpoint with one team-name query. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"domain_tags": [
"sports"
],
"core_primitives": [
"search_sports_teams",
"return_team_database_response"
],
"problem_space": "Sports-team directory lookup; not live scores, fixtures, player search, or sports forecasting."
},
"constraint": {
"io_signature": "Input: one team query string; output: JSON envelope containing http_status and TheSportsDB team-search JSON or HTTP error body. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"one team-name search string"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://www.thesportsdb.com/api/v1/json/3/searchteams.php with t=<query>; no event, player, league, or pagination parameter",
"only requests.RequestException becomes status=error",
"HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"wrapper does not normalize, paginate, or truncate the response",
"uses the public key 3 with no caller auth, cache, or retry; results depend on external database state"
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "query",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing TheSportsDB team-search result, URL, and HTTP status."
}
},
"routing": {
"family": "sports-team-directory-search",
"intent_tags": [
"search sports teams by name",
"look up a team in TheSportsDB"
],
"negative_intents": [
"get live sports scores or fixtures",
"search cocktail, meal, or general entity databases"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.thesportsdb.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://www.thesportsdb.com/api.php",
"license": "proprietary-free",
"recognized_public_tool": true,
"source_hash": "sha256:5a90cd48401fc8e8333288420b4a55d828e4ceaee78a03674a42e14fdd6064df",
"local_implementation_uri": "file://Pool/resources/tools/api/api.thesportsdb.py",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "query",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing TheSportsDB team-search result, URL, and HTTP status."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://www.thesportsdb.com/api/v1/json/3/searchteams.php",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
}
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.universities_hipolabs.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "List universities matching one country name",
"description": "Calls Hipolabs' fixed university search endpoint with one country query. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"domain_tags": [
"education",
"reference"
],
"core_primitives": [
"search_university_domains",
"filter_universities_by_country"
],
"problem_space": "University directory lookup by country; not admissions guidance, accreditation verification, rankings, or geocoding."
},
"constraint": {
"io_signature": "Input: one country string; output: JSON envelope containing http_status and Hipolabs university records or HTTP error body. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"one country name string"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET http://universities.hipolabs.com/search with country=<country>; no city, domain, pagination, or ranking filter exposed",
"only requests.RequestException becomes status=error",
"HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"wrapper preserves the returned array without local normalization or truncation",
"no auth, cache, or retry; directory coverage and ordering are controlled by the external dataset"
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "country",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing Hipolabs university records for the country query, URL, and HTTP status.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "country-university-directory-search",
"intent_tags": [
"find universities in a country",
"list university domains by country"
],
"negative_intents": [
"rank or accredit universities",
"provide admissions or location directions"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.universities_hipolabs.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/Hipo/university-domains-list",
"license": "MIT",
"backed_by": "api.universities_hipolabs",
"recognized_public_tool": true,
"auth_required": false,
"source_hash": "sha256:97528b93e8828ed900e9d760ff8b0c63bcb0d5a73c0affc89ef281ecf5a9d948",
"local_implementation_uri": "file://Pool/resources/tools/api/api.universities_hipolabs.py",
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "country",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing Hipolabs university records for the country query, URL, and HTTP status.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": null,
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.usgs.earthquakes.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Query recent USGS earthquakes as GeoJSON",
"description": "Queries the USGS FDSN event endpoint for GeoJSON earthquakes, fixing limit=5 and exposing only the optional minimum magnitude argument through the wrapper. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"domain_tags": [
"science",
"geo"
],
"core_primitives": [
"query_earthquake_events",
"return_usgs_geojson"
],
"problem_space": "Recent earthquake-event discovery and magnitude filtering; not seismic hazard prediction, geocoding, or emergency advice."
},
"constraint": {
"io_signature": "Input: no user-bindable CLI parameters; output: JSON envelope containing http_status and fixed USGS GeoJSON or HTTP error body; wrapper internally sends minmagnitude=4, limit=5, and format=geojson. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"no user-bindable input; minmagnitude=4, limit=5, and format=geojson are fixed by the wrapper"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://earthquake.usgs.gov/fdsnws/event/1/query; wrapper reads no valid user parameter and always sends minmagnitude=4, limit=5, and format=geojson",
"only requests.RequestException becomes status=error",
"HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"starttime and minmagnitude are not accepted manifest inputs; no caller-controlled limit, pagination, or additional filters",
"API result is capped at five events and wrapper performs no additional parsing or truncation",
"no auth, cache, or retry; live seismic feed and external network make results non-deterministic"
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing up to five USGS earthquake GeoJSON features, URL, and HTTP status.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "usgs-earthquake-event-query",
"intent_tags": [
"find recent earthquakes by magnitude",
"retrieve USGS earthquake GeoJSON"
],
"negative_intents": [
"predict future earthquakes or seismic risk",
"provide emergency response or geocoding data"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.usgs.earthquakes.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://earthquake.usgs.gov/fdsnws/event/1/",
"license": "public-domain",
"recognized_public_tool": true,
"source_hash": "sha256:b7d2919d77212ea45ab3f43e3cea6a62da973f6c587954dcd673e5921544b2af",
"local_implementation_uri": "file://Pool/resources/tools/api/api.usgs.earthquakes.py",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing up to five USGS earthquake GeoJSON features, URL, and HTTP status.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://earthquake.usgs.gov/fdsnws/event/1/query",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.wikipedia.summary.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Fetch a localized Wikipedia article summary",
"description": "Calls the language-specific MediaWiki REST summary endpoint for one URL-quoted page title. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"domain_tags": [
"knowledge",
"search"
],
"core_primitives": [
"lookup_wikipedia_summary",
"select_language_wiki_endpoint"
],
"problem_space": "Encyclopedic article-summary retrieval; not authoritative fact verification, full-page scraping, or general web search."
},
"constraint": {
"io_signature": "Input: page title and optional language code; output: JSON envelope containing http_status and the MediaWiki summary response or HTTP error body. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"one Wikipedia page title",
"optional language subdomain code; wrapper default en"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://<lang>.wikipedia.org/api/rest_v1/page/summary/<URL-quoted-title>; no revision, extract length, or page-content option",
"only requests.RequestException becomes status=error",
"HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"wrapper URL-quotes the title but does not locally parse or truncate the response",
"no auth, cache, or retry; language domain and current article content determine the result"
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "title",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "lang",
"kind": "string",
"required": false,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing the selected-language Wikipedia summary object, URL, and HTTP status."
}
},
"routing": {
"family": "localized-wikipedia-summary",
"intent_tags": [
"get a Wikipedia article summary",
"look up an encyclopedic page by title and language"
],
"negative_intents": [
"scrape the full Wikipedia article",
"search arbitrary websites or verify facts against primary sources"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.wikipedia.summary.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://www.mediawiki.org/wiki/API:REST_API",
"license": "CC-BY-SA",
"recognized_public_tool": true,
"source_hash": "sha256:6d7372532aeb73f112eccb0b1a23ee0df615d65424c068aec7d374eb1f821992",
"local_implementation_uri": "file://Pool/resources/tools/api/api.wikipedia.summary.py",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "title",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "lang",
"kind": "string",
"required": false,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing the selected-language Wikipedia summary object, URL, and HTTP status."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://{lang}.wikipedia.org/api/rest_v1/page/summary/{urllib.parse.quote(a(1))}",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
}
}
},
{
"manifest_version": "v2",
"resource_id": "tool.api.worldbank_indicator.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Fetch World Bank indicator observations for one country",
"description": "Fetches one World Bank country/indicator series using the fixed v2 endpoint, JSON format, and per_page=5. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"domain_tags": [
"economics",
"data"
],
"core_primitives": [
"query_world_bank_indicator",
"return_indicator_observations"
],
"problem_space": "Country-level development-indicator data retrieval; not forecasting, causal analysis, or financial advice."
},
"constraint": {
"io_signature": "Input: country code and World Bank indicator code; output: JSON envelope containing http_status and the World Bank metadata/observation array or HTTP error body. HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"accepted_inputs": [
"World Bank country code or country identifier",
"World Bank indicator code such as a numeric series id"
],
"output_shape": "HTTP 2xx/3xx: {status: \"success\", tool: string, url: string, http_status: integer, result: object|string}. HTTP 4xx/5xx: {status: \"error\", tool: string, url: string, http_status: integer, result: object|string}, exit 1. Request exception: {status: \"error\", tool: string, message: string}, exit 1.",
"limitations": [
"fixed GET https://api.worldbank.org/v2/country/<country>/indicator/<indicator> with format=json and per_page=5; no date range, page, or sort input exposed",
"only requests.RequestException becomes status=error",
"HTTP 2xx/3xx responses produce a success envelope; HTTP 4xx/5xx responses produce an error envelope and a non-zero exit; request exceptions also produce an error envelope and a non-zero exit.",
"wrapper preserves the API JSON and does not locally truncate beyond the API's five-record page",
"no auth, cache, or retry; observations and availability depend on the external World Bank service"
],
"artifact_output": [
"json"
],
"execution_risk": "medium",
"http_status_semantics": {
"success": "HTTP 200-399",
"failure": "HTTP 400-599 or request exception",
"failure_exit_code": 1
}
},
"io": {
"input_contract": [
{
"name": "country",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "indicator",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing the World Bank metadata and up to five indicator observations, URL, and HTTP status.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "world-bank-development-indicator-query",
"intent_tags": [
"retrieve World Bank indicator data",
"compare country development observations"
],
"negative_intents": [
"forecast an economic indicator",
"retrieve cryptocurrency or market prices"
]
},
"execution": {
"runtime": "rest_api",
"uri": "file://Pool/resources/tools/api/api.worldbank_indicator.py",
"execution_status": "active",
"execution_risk": "medium"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://datahelpdesk.worldbank.org/knowledgebase/articles/889392",
"license": "CC-BY-4.0",
"recognized_public_tool": true,
"source_hash": "sha256:fd259635cc8e2e49af8bc6d1474831312344bf3f8d2173ab3201d9a145a4fad0",
"local_implementation_uri": "file://Pool/resources/tools/api/api.worldbank_indicator.py",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"supporting_source_hashes": {
"file://Pool/resources/tools/api/_apilib.py": "sha256:e60bba3d1f3dcd9fcd408042ad7951e52d6ecd66d57cb9a58c249d521c8811a7"
}
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "country",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "indicator",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing the World Bank metadata and up to five indicator observations, URL, and HTTP status.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"rest": {
"endpoint": "https://api.worldbank.org/v2/country/{a(1)}/indicator/{a(2)}",
"auth_required": false,
"auth_evidence": "wrapper_and_shared_adapter_read_no_credentials",
"timeout_seconds": 25,
"success_http_status": "200-399"
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.archive_zip_extract.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Safely extract every regular file from one ZIP archive into an explicit task-workspace directory.",
"description": "Uses Python zipfile to validate all archive members before extraction, rejects traversal and symbolic links, and returns relative extracted-file names plus aggregate size facts.",
"domain_tags": [
"archive",
"zip",
"file-extraction"
],
"core_primitives": [
"extract_zip_archive"
],
"operation_kinds": [
"extract_zip_archive"
],
"problem_space": "Deterministic unpacking of ZIP attachments so downstream tools or agents can inspect their contained files.",
"execution_semantics": {
"determinism": "deterministic",
"side_effects": "declared",
"effect_targets": [
"task_workspace"
],
"modalities": [
"archive",
"file"
]
}
},
"constraint": {
"io_signature": "Input: ZIP file path and destination directory inside the task workspace. Output: typed JSON receipt listing extracted relative file names and aggregate byte count.",
"accepted_inputs": [
"a readable, non-encrypted ZIP archive",
"an output directory within SGAR_WORKSPACE_ROOT"
],
"artifact_input": [
"zip",
"archive",
"file"
],
"artifact_output": [
"json"
],
"output_shape": "Success contains status, tool, extracted_files, extracted_file_count, and total_uncompressed_bytes. Unsafe, malformed, oversized, or unreadable archives return a typed error envelope and non-zero exit.",
"limitations": [
"supports ZIP archives only",
"rejects symbolic links, path traversal, more than 10000 members, or more than 1 GiB declared uncompressed content",
"does not decrypt password-protected members",
"returns a receipt; downstream inspection uses the declared output directory"
]
},
"io": {
"input_contract": [
{
"name": "archive_path",
"kind": "file_path",
"artifact_types": [
"zip",
"archive"
],
"extensions": [
".zip"
],
"required": true,
"cli_position": 1
},
{
"name": "output_directory",
"kind": "directory_path",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Typed ZIP extraction receipt.",
"json_schema": {
"oneOf": [
{
"type": "object",
"properties": {
"status": {
"const": "success"
},
"tool": {
"const": "python-zipfile"
},
"extracted_files": {
"type": "array",
"items": {
"type": "string"
}
},
"extracted_file_count": {
"type": "integer",
"minimum": 0
},
"total_uncompressed_bytes": {
"type": "integer",
"minimum": 0
}
},
"required": [
"status",
"tool",
"extracted_files",
"extracted_file_count",
"total_uncompressed_bytes"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"status": {
"const": "error"
},
"tool": {
"const": "python-zipfile"
},
"message": {
"type": "string",
"minLength": 1
}
},
"required": [
"status",
"tool",
"message"
],
"additionalProperties": false
}
]
},
"result_status": {
"payload_path": "status",
"success_values": [
"success"
],
"failure_values": [
"error"
]
}
}
},
"routing": {
"family": "zip-archive-extraction",
"intent_tags": [
"extract files from a ZIP attachment",
"unpack an archive for downstream inspection"
],
"negative_intents": [
"extract tar or rar archives",
"inspect archive contents without creating files",
"decrypt an archive"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/archive_zip_extract.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://docs.python.org/3/library/zipfile.html",
"license": "PSF-2.0",
"backed_by": "Python standard-library zipfile",
"recognized_public_tool": true,
"source_hash": "sha256:1ec6a6042d6ece481a6a1d897fad4ce55142d55fcdcfd0ad82cd0c907492bc89",
"local_implementation_uri": "file://Pool/resources/tools/script/archive_zip_extract.py"
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"archive",
"zip",
"file-extraction"
]
},
"input_contract": [
{
"name": "archive_path",
"kind": "file_path",
"artifact_types": [
"zip",
"archive"
],
"extensions": [
".zip"
],
"required": true,
"cli_position": 1
},
{
"name": "output_directory",
"kind": "directory_path",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Typed ZIP extraction receipt.",
"json_schema": {
"oneOf": [
{
"type": "object",
"properties": {
"status": {
"const": "success"
},
"tool": {
"const": "python-zipfile"
},
"extracted_files": {
"type": "array",
"items": {
"type": "string"
}
},
"extracted_file_count": {
"type": "integer",
"minimum": 0
},
"total_uncompressed_bytes": {
"type": "integer",
"minimum": 0
}
},
"required": [
"status",
"tool",
"extracted_files",
"extracted_file_count",
"total_uncompressed_bytes"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"status": {
"const": "error"
},
"tool": {
"const": "python-zipfile"
},
"message": {
"type": "string",
"minLength": 1
}
},
"required": [
"status",
"tool",
"message"
],
"additionalProperties": false
}
]
},
"result_status": {
"payload_path": "status",
"success_values": [
"success"
],
"failure_values": [
"error"
]
}
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.bandit_security_scanner.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Run Bandit recursively against one Python file or directory and return its native JSON findings in a wrapper envelope",
"description": "Validates that the target exists, invokes `bandit -r <target> -f json`, and reports Bandit's structured Python security findings without changing source files. Bandit exit codes 0 and 1 both represent a completed scan.",
"core_primitives": [
"scan_python_security_issues_with_bandit",
"recursively_analyze_python_path",
"return_bandit_native_json"
],
"problem_space": "Bandit-specific static security inspection of Python source trees; not general style linting, formatting, dependency CVE lookup, or code remediation.",
"domain_tags": [
"security",
"code-audit",
"Python"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"bandit"
],
"io_signature": "Input: one required existing Python file or directory path; output: one JSON wrapper containing Bandit's parsed JSON report or explicit execution-error fields.",
"accepted_inputs": [
"an existing Python source file path",
"an existing directory path to scan recursively with Bandit"
],
"output_shape": "Completed scan (Bandit exit 0 or 1): {status: \"success\", tool: \"bandit\", target: string, exit_code: 0|1, result: object|array|null, stdout: string|null, stderr: string|null}; parsed Bandit JSON is placed in result and stdout becomes null. Hard Bandit failure: the same keys with status=\"tool_error\", the actual exit_code, result possibly null, stdout containing unparsed output when no JSON parsed, and stderr, followed by that exit code. Missing path or executable and timeout: {status: \"error\", tool: \"bandit\", message: string}, exiting 2, 3, or 4. Missing CLI argument prints usage to stderr and exits 1 without JSON.",
"limitations": [
"always uses recursive mode and Bandit's native JSON formatter with no caller-configurable Bandit flags, profile, severity threshold, confidence threshold, exclusions, or configuration file",
"requires the `bandit` executable on PATH and enforces the shared 120-second timeout",
"does not modify, format, or automatically remediate Python files; Bandit findings use exit code 1 but are treated as a successful scan"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "target_path",
"kind": "path",
"artifact_types": [
"code"
],
"extensions": [
".py"
],
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope containing Bandit's parsed native report, exit code, target, and stdout/stderr or an explicit wrapper error.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "python-bandit-security-scan",
"intent_tags": [
"scan Python source for Bandit security findings",
"run a recursive Bandit JSON security audit"
],
"negative_intents": [
"check Python style or formatting with Black, flake8, or Ruff",
"look up dependency CVEs or audit installed packages",
"rewrite or automatically fix insecure Python code"
],
"dependency_slots": []
},
"utility": {
"latency_ms": 200,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://bandit.readthedocs.io",
"license": "Apache-2.0",
"backed_by": "Bandit security scanner",
"recognized_public_tool": true,
"source_hash": "sha256:9c8616766329a71a261be6a5d563eecd29d9acf619014c66607c2210a2ef1ad9",
"local_implementation_uri": "file://Pool/resources/tools/script/bandit_security_scanner.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/bandit_security_scanner.py",
"execution_status": "active"
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"security",
"code-audit",
"Python"
]
},
"input_contract": [
{
"name": "target_path",
"kind": "path",
"artifact_types": [
"code"
],
"extensions": [
".py"
],
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope containing Bandit's parsed native report, exit code, target, and stdout/stderr or an explicit wrapper error.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [],
"commands": [
"bandit"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.black_format_runner.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Check a Python path with Black and return the proposed formatting diff without modifying files",
"description": "Runs `black --check --diff <target>` against one existing path. It reports whether Black formatting is already satisfied and emits Black's textual diff, but check mode never applies the formatting.",
"core_primitives": [
"check_black_format_compliance",
"produce_black_format_diff",
"preserve_input_files"
],
"problem_space": "Read-only Black formatting compliance and diff generation for Python paths; not source rewriting, lint-rule analysis, or security scanning.",
"domain_tags": [
"python",
"code_formatting",
"development"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"black"
],
"io_signature": "Input: one required existing Black-compatible file or directory path; output: a JSON wrapper with Black's check exit code and untruncated textual diff/stdout and stderr.",
"accepted_inputs": [
"an existing Python source file path accepted by Black",
"an existing directory path accepted by Black for recursive format checking"
],
"output_shape": "Completed check (Black exit 0 or 1): {status: \"success\", tool: \"black\", target: string, exit_code: 0|1, result: null, stdout: string, stderr: string|null}; exit 0 means already formatted and exit 1 means Black would reformat, with any diff in stdout. Other Black exits use the same keys with status=\"tool_error\" and propagate the actual exit code. Missing path/executable/timeout: {status: \"error\", tool: \"black\", message: string}, exiting 2/3/4. Missing argument prints usage to stderr and exits 1 without JSON.",
"limitations": [
"despite the runner name, fixed `--check --diff` flags make this check-only and it never writes formatted code",
"does not expose Black configuration or flags through manifest inputs; Black may still discover project configuration on its own",
"requires `black` on PATH, uses a fixed 120-second timeout, and does not truncate captured stdout or stderr"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "target_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope with Black's check exit code, full proposed diff/stdout, stderr, and target; no file is formatted.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "python-black-format-check-only",
"intent_tags": [
"check whether Python code matches Black formatting",
"preview Black formatting changes as a diff"
],
"negative_intents": [
"apply Black formatting or rewrite Python files",
"lint Python with flake8 or Ruff",
"scan Python code for Bandit security findings"
],
"dependency_slots": []
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://black.readthedocs.io",
"license": "MIT",
"backed_by": "Black formatter",
"recognized_public_tool": true,
"source_hash": "sha256:edaf826f3182fde712383f78555f645f04359f64e5dbccd2af3156ab249ddc47",
"local_implementation_uri": "file://Pool/resources/tools/script/black_format_runner.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/black_format_runner.py",
"execution_status": "active"
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"python",
"code_formatting",
"development"
]
},
"input_contract": [
{
"name": "target_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope with Black's check exit code, full proposed diff/stdout, stderr, and target; no file is formatted.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [],
"commands": [
"black"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.browsertrix_crawl.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Capture a public webpage with Browsertrix Crawler into replayable web-archive artifacts",
"description": "SGAR task-container adapter invoking upstream Browsertrix Crawler. Browsertrix performs browser execution and capture; the adapter only bounds invocation and reports produced artifacts.",
"domain_tags": [
"research",
"web_archive",
"browser"
],
"core_primitives": [
"crawl_public_url",
"capture_browser_network_activity",
"produce_warc_or_wacz_artifacts"
],
"problem_space": "High-fidelity capture of a specified public URL for later evidence review; not web search, citation normalization, or arbitrary browser interaction.",
"operation_kinds": [
"browser_capture"
]
},
"constraint": {
"io_signature": "Input public URL and task-container output directory; output produced WARC/WACZ and crawler logs.",
"accepted_inputs": [
"public HTTP(S) URL"
],
"output_shape": "JSON artifact receipt with produced files and crawler streams.",
"limitations": [
"requires browsertrix-crawler in the supplied task image",
"browser execution can create substantial CPU/memory/disk/network load",
"site JavaScript, robots, CAPTCHA and authentication can prevent complete capture",
"proxy credentials are not configured by default"
],
"artifact_output": [
"warc",
"wacz",
"json"
]
},
"io": {
"input_contract": [
{
"name": "url",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "output_dir",
"kind": "directory",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Capture receipt referencing Browsertrix archive artifacts.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "browser-web-evidence-capture",
"intent_tags": [
"capture a webpage for evidence",
"save browser crawl as WARC/WACZ",
"archive dynamic web content"
],
"negative_intents": [
"search the public web",
"normalize DOI metadata",
"write arbitrary files outside output_dir"
]
},
"execution": {
"runtime": "python_script",
"runtime_scope": "task_container",
"uri": "file://Pool/resources/tools/script/browsertrix_crawl.py",
"execution_status": "active",
"execution_risk": "high"
},
"utility": {
"latency_ms": 10000,
"token_cost_factor": 0.05,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/webrecorder/browsertrix-crawler/tree/v1.14.3",
"version": "1.14.3",
"license": "AGPL-3.0",
"license_url": "https://github.com/webrecorder/browsertrix-crawler/blob/v1.14.3/LICENSE",
"license_sha256": "8486a10c4393cee1c25392769ddd3b2d6c242d6ec7928e1414efff7dfb2f07ef",
"backed_by": "Browsertrix Crawler",
"recognized_public_tool": true,
"native_network_access": true,
"credential_class": "NONE",
"credential_env_names": [],
"third_party_account_required": false,
"paid_service_required": false,
"source_hash": "sha256:aa8b13ae025cb4fc66c75da765de33ea71f21b5da58bfef19831ef9470f8dc16",
"local_implementation_uri": "file://Pool/resources/tools/script/browsertrix_crawl.py"
},
"type_specific": {
"tool": {
"tool_kind": "task_container_cli",
"deterministic": false
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"runtime_requirements": {
"runtime_profile": "task-container",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "task-image-provided",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.cargo_test_runner.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Run the Rust project's default `cargo test` command from a supplied project path",
"description": "Validates one path, chooses it as the working directory when it is a directory or uses its parent when it is a file, then executes `cargo test` with no additional arguments. The wrapper returns captured Cargo output and treats only exit code 0 as success.",
"core_primitives": [
"run_cargo_test",
"select_rust_project_working_directory",
"capture_cargo_test_process_output"
],
"problem_space": "Default Rust test-suite execution through Cargo for one local project path; not language-agnostic testing, test discovery without execution, coverage reporting, or arbitrary Cargo command execution.",
"domain_tags": [
"Rust",
"testing",
"automation"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"cargo executable and a compatible Rust toolchain"
],
"io_signature": "Input: one required existing Rust project directory or a path inside its root; output: a JSON process envelope with Cargo's exit code and full stdout/stderr.",
"accepted_inputs": [
"an existing Rust project directory containing the Cargo project to test",
"an existing file path whose parent directory is the Cargo project working directory"
],
"output_shape": "Passing run: {status: \"success\", tool: \"cargo\", target: string, exit_code: 0, result: null, stdout: string, stderr: string|null}, then process exit 0. Failed tests, compilation failures, or other nonzero Cargo results use the same keys with status=\"tool_error\" and propagate Cargo's exit code. Missing path/executable/300-second timeout: {status: \"error\", tool: \"cargo\", message: string}, exiting 2/3/4. Missing argument prints usage to stderr and exits 1 without JSON.",
"limitations": [
"always runs the default `cargo test` with no package, workspace, feature, target, filter, release, or passthrough test arguments",
"uses a fixed 300-second timeout and captures stdout/stderr without parsing or truncation",
"Cargo may compile code, create or update build artifacts such as `target/`, resolve dependencies, and otherwise produce normal Cargo project side effects",
"a supplied file is not tested individually; only its parent directory is used as the Cargo working directory"
],
"artifact_input": [
"proj_dir"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "proj_dir",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON process envelope containing the default `cargo test` status, actual exit code, target, and full captured stdout/stderr.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "rust-cargo-default-test-runner",
"intent_tags": [
"run the default Rust test suite with cargo test",
"execute Cargo tests for a local Rust project"
],
"negative_intents": [
"run Python, JavaScript, Go, or language-agnostic tests",
"generate Rust test coverage or parse structured test results",
"run arbitrary Cargo subcommands or pass custom cargo test flags"
],
"dependency_slots": []
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://doc.rust-lang.org/cargo",
"license": "MIT/Apache-2.0",
"backed_by": "cargo test",
"recognized_public_tool": true,
"source_hash": "sha256:38cba70891e0e5d0339a5213b60ec6e6b4cee747771035697c1cb9e52a113243",
"local_implementation_uri": "file://Pool/resources/tools/script/cargo_test_runner.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/cargo_test_runner.py",
"execution_status": "active"
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"Rust",
"testing",
"automation"
]
},
"input_contract": [
{
"name": "proj_dir",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON process envelope containing the default `cargo test` status, actual exit code, target, and full captured stdout/stderr.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [
{
"name": "build-essential",
"version": "image-locked",
"required": true
},
{
"name": "rust-1.79.0",
"version": "image-locked",
"required": true
}
],
"commands": [
"cargo",
"cc"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.check_jsonschema_validate.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Validate local JSON or YAML with check-jsonschema 0.38.0",
"description": "Thin SGAR adapter that invokes the upstream check-jsonschema CLI against one local schema and one or more local instances without selecting remote builtin schemas.",
"domain_tags": [
"data",
"validation",
"schema"
],
"core_primitives": [
"validate_json_schema_instances",
"validate_yaml_schema_instances",
"return_validation_diagnostics"
],
"problem_space": "Offline contract validation of file-backed JSON/YAML instances; not schema inference, remote schema retrieval, data repair, or general linting."
},
"constraint": {
"io_signature": "Input local schema path and local instance paths; output validity, diagnostics and upstream exit code.",
"accepted_inputs": [
"local JSON Schema",
"local JSON or YAML instances"
],
"output_shape": "JSON validity envelope with textual diagnostics.",
"limitations": [
"local schema and instance paths only",
"does not fetch remote schemas",
"60-second timeout",
"diagnostics follow upstream CLI formatting"
],
"operation_kinds": [
"local_read",
"schema_validation"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "schema_path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "instance_path",
"kind": "list",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "check-jsonschema validity and diagnostics.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "json-yaml-schema-validation",
"intent_tags": [
"validate JSON against JSON Schema",
"validate YAML files against a local schema"
],
"negative_intents": [
"infer a schema",
"download a remote schema",
"repair invalid data"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/check_jsonschema_validate.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/python-jsonschema/check-jsonschema/tree/0.38.0",
"version": "0.38.0",
"license": "Apache-2.0",
"license_url": "https://github.com/python-jsonschema/check-jsonschema/blob/0.38.0/LICENSE",
"license_sha256": "3e5df383ac91e92a04b63aa16bad328c8a9e39eafb7d5d24e258831f844d39cc",
"upstream_artifact": "https://files.pythonhosted.org/packages/source/c/check-jsonschema/check_jsonschema-0.38.0.tar.gz",
"upstream_artifact_sha256": "bb6899cc24ab0ced664e4646423d35b72db245cea75109c0b9e64d13087d1b8c",
"backed_by": "check-jsonschema",
"recognized_public_tool": true,
"source_hash": "sha256:3f097f1a511d67ffb2576f808c32fceaa1c83947908fe470cbca16739a9cd819",
"local_implementation_uri": "file://Pool/resources/tools/script/check_jsonschema_validate.py"
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "check-jsonschema",
"version": "==0.38.0",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [
"check-jsonschema"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.clang_format_checker.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Check one source file with clang-format dry-run mode without rewriting it",
"description": "Runs `clang-format --dry-run --Werror <file>` for one existing source file. It reports formatting violations through clang-format's exit code and captured diagnostics while leaving the file unchanged.",
"core_primitives": [
"check_clang_format_compliance",
"run_clang_format_dry_run",
"capture_format_diagnostics_without_writes"
],
"problem_space": "Read-only clang-format compliance for a single supported source file; not source formatting, compiler diagnostics, semantic C/C++ linting, or multi-file project traversal.",
"domain_tags": [
"code-quality",
"automation-tools",
"software-engineering"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"clang-format executable"
],
"io_signature": "Input: one required existing source file path accepted by clang-format; output: a JSON process envelope with exit code and full stdout/stderr diagnostics.",
"accepted_inputs": [
"an existing C, C++, Objective-C, Java, JavaScript, or other source file supported by the installed clang-format"
],
"output_shape": "Completed check (clang-format exit 0 or 1): {status: \"success\", tool: \"clang-format\", target: string, exit_code: 0|1, result: null, stdout: string, stderr: string|null}; exit 0 indicates no `--Werror` formatting violation and exit 1 commonly reports a formatting violation. Other exits use the same keys with status=\"tool_error\" and propagate the actual exit code. Missing path/executable/120-second timeout: {status: \"error\", tool: \"clang-format\", message: string}, exiting 2/3/4. Missing argument prints usage to stderr and exits 1 without JSON.",
"limitations": [
"fixed `--dry-run --Werror` flags make this check-only; it never applies clang-format changes",
"checks one supplied file and does not recursively discover project files",
"does not expose style or fallback-style arguments; clang-format may discover configuration according to its normal rules",
"requires `clang-format` on PATH, uses a 120-second timeout, and captures output without parsing or truncation"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope with clang-format dry-run status, actual exit code, target, and full stdout/stderr; the source file is not modified.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "clang-format-check-only",
"intent_tags": [
"check a source file for clang-format compliance",
"run clang-format dry-run with formatting violations as errors"
],
"negative_intents": [
"rewrite or automatically format source files",
"lint C or C++ semantics or compile source code",
"check an entire directory recursively"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/clang_format_checker.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://clang.llvm.org/docs/ClangFormat.html",
"license": "Apache-2.0",
"backed_by": "clang-format",
"recognized_public_tool": true,
"source_hash": "sha256:e8e800ab90a456e311728ec5a31da584b435ab7394fba300fc71fc3085fa03e9",
"local_implementation_uri": "file://Pool/resources/tools/script/clang_format_checker.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"code-quality",
"automation-tools",
"software-engineering"
]
},
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope with clang-format dry-run status, actual exit code, target, and full stdout/stderr; the source file is not modified.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [
{
"name": "clang-format",
"version": "image-locked",
"required": true
}
],
"commands": [
"clang-format"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.coqc_compile_runner.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Compile a Coq .v source file into its .vo proof artifact",
"description": "Runs the task-container coqc compiler on one Coq source file and reports the deterministic compiled artifact.",
"core_primitives": [
"compile_coq_source",
"verify_coq_proof_artifact"
],
"operation_kinds": [
"compile_coq_source"
],
"problem_space": "Deterministic Coq source compilation and proof checking; not proof synthesis or theorem repair.",
"domain_tags": [
"formal_verification",
"coq",
"deterministic_compilation"
]
},
"constraint": {
"io_signature": "Input: one task-container .v source path and optional sibling .vo output path. Output: JSON status envelope with compiler streams, exit code, latency, and produced_files.",
"accepted_inputs": [
"one existing .v file inside the task container",
"optional sibling .vo output path"
],
"output_shape": "{status: ok|failed|timeout, source_path: string, output_path: string, produced_files: [string], exit_code: integer, stdout: string, stderr: string, latency_ms: integer}",
"limitations": [
"requires coqc in the task image",
"does not synthesize or edit source",
"does not access host paths",
"maximum compiler invocation is 180 seconds"
],
"artifact_input": [
"coq_source"
],
"artifact_output": [
"file"
]
},
"io": {
"input_contract": [
{
"name": "source_path",
"kind": "file_path",
"required": true,
"extensions": [
".v"
],
"cli_position": 1
},
{
"name": "output_path",
"kind": "file_path",
"required": false,
"extensions": [
".vo"
],
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "file",
"description": "Deterministically compiled Coq .vo proof artifact.",
"schema_hint": {
"type": "object",
"properties": {
"status": {
"type": "string"
},
"produced_files": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"status",
"produced_files"
],
"additionalProperties": true
}
}
},
"routing": {
"family": "deterministic-formal-compilation",
"intent_tags": [
"compile Coq proof",
"run coqc",
"type check Coq source",
"produce vo artifact"
],
"negative_intents": [
"write Coq source",
"synthesize proof tactics",
"compile Python or C source"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"runtime_scope": "task_container",
"uri": "file://Pool/resources/tools/script/coqc_compile_runner.py",
"execution_status": "active",
"execution_risk": "low"
},
"utility": {
"latency_ms": 1000,
"token_cost_factor": 0.0,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "Coq reference compiler",
"license": "LGPL-compatible",
"backed_by": "coqc",
"recognized_public_tool": true,
"auth_required": false,
"local_implementation_uri": "file://Pool/resources/tools/script/coqc_compile_runner.py",
"source_hash": "sha256:f092b1786e28c5ae22bfc2260a3c2de275348d8a1d74b1c6e628fc943882f164"
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"runtime_requirements": {
"runtime_profile": "task-container",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "task-image-provided",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.cors_headers_checker.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Send one fixed preflight-style OPTIONS request and report selected CORS response headers",
"description": "Normalizes a scheme-less target to HTTPS, sends an OPTIONS request with a fixed example Origin and requested GET method, then returns the HTTP status plus any of five recognized Access-Control response headers. `cors_enabled` only indicates that at least one such header was present.",
"core_primitives": [
"send_cors_preflight_style_options_request",
"extract_selected_access_control_headers",
"report_presence_of_cors_headers"
],
"problem_space": "Single-endpoint observation of selected CORS response headers for one fixed Origin/GET probe; not comprehensive CORS policy validation, browser enforcement simulation, vulnerability certification, or file inspection.",
"domain_tags": [
"web_security",
"http",
"cors"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"requests",
"network access to the target URL"
],
"io_signature": "Input: one required HTTP(S) URL or scheme-less host/path string; output: JSON with normalized URL, response status, coarse header-presence boolean, and selected CORS headers, or a request error.",
"accepted_inputs": [
"an absolute http:// or https:// URL",
"a scheme-less host or host/path string that should be requested over https://"
],
"output_shape": "Successful HTTP exchange: {status: \"success\", tool: \"requests\", url: string, status_code: integer, cors_enabled: boolean, cors_headers: object}; cors_headers contains only present Access-Control-Allow-Origin, -Methods, -Headers, -Credentials, and Access-Control-Max-Age values, and cors_enabled is bool(cors_headers). Request failure: {status: \"error\", tool: \"requests\", url: string, message: string} and exit 1. Missing argument prints usage to stderr and exits 1 without JSON. HTTP error status codes still produce status=\"success\" because raise_for_status is not called.",
"limitations": [
"uses fixed `Origin: https://example.com` and `Access-Control-Request-Method: GET` headers with no caller customization",
"treats the presence of any selected CORS header as cors_enabled and does not judge policy correctness, credential safety, origin reflection, or browser exploitability",
"performs only one OPTIONS request with a 20-second Requests timeout; redirects and other Requests defaults are not exposed",
"scheme-less input is always prefixed with https:// and malformed URLs are reported only through the request exception"
],
"artifact_input": [
"url"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "url",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON report of one fixed OPTIONS probe: normalized URL, HTTP status, selected CORS headers and their coarse presence flag, or a request error.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "http-cors-header-presence-probe",
"intent_tags": [
"inspect selected CORS headers returned by an endpoint",
"send a fixed GET preflight-style OPTIONS probe"
],
"negative_intents": [
"prove that a CORS policy is secure or exploitable",
"test arbitrary origins, methods, headers, or credential scenarios",
"inspect HTTP security headers unrelated to CORS"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/cors_headers_checker.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 50,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://requests.readthedocs.io",
"license": "Apache-2.0",
"backed_by": "CORS header check via requests",
"recognized_public_tool": true,
"source_hash": "sha256:0576a8c291806c24887c46660eb21db1f7804e778e0d5b1bc49f485a201b68d0",
"local_implementation_uri": "file://Pool/resources/tools/script/cors_headers_checker.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"web_security",
"http",
"cors"
]
},
"input_contract": [
{
"name": "url",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON report of one fixed OPTIONS probe: normalized URL, HTTP status, selected CORS headers and their coarse presence flag, or a request error.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.csv_column_filter.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Project an input CSV to named columns and return the resulting CSV text inside JSON",
"description": "Reads one CSV file with pandas defaults, splits the required `columns_to_filter` string on commas, trims and drops empty tokens, verifies every resulting column name exists, and returns the selected columns in their requested order as in-memory CSV text. It does not write an output file or filter rows.",
"core_primitives": [
"read_csv_with_pandas_defaults",
"project_named_csv_columns",
"serialize_projected_rows_as_csv_text"
],
"problem_space": "Exact-name column projection from one local CSV into returned CSV text; not row filtering, data cleansing, aggregation, format conversion to structured JSON rows, or persistent file rewriting.",
"domain_tags": [
"data-processing",
"CSV",
"tools"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"pandas"
],
"io_signature": "Input: one required CSV file path plus required columns_to_filter: string containing exact column names separated by commas (for example `name,email,age`); output: JSON containing selected-column CSV text and metadata or a precise error.",
"accepted_inputs": [
"an existing CSV file readable by pandas.read_csv with default options",
"one comma-separated string of exact column names, such as `name,email,age`; the script applies split(',') and trims each token"
],
"output_shape": "Success: {status: \"success\", tool: \"pandas\", target: string, kept_columns: string[], row_count: integer, csv: string}; csv includes a header and all input rows for only the requested columns. Missing requested columns: {status: \"error\", tool: \"pandas\", message: string, available: string[]} and exit 1. Read/parse/serialization exception: {status: \"error\", tool: \"pandas\", message: string} and exit 1. Missing file: {status: \"error\", message: string} and exit 2. Fewer than two arguments prints usage to stderr and exits 1 without JSON.",
"limitations": [
"filters columns only and never filters rows, evaluates predicates, aggregates values, or modifies the source file",
"uses pandas.read_csv defaults with no delimiter, encoding, dtype, quoting, header, NA, or chunking options",
"loads the entire CSV and generated output into memory and applies no timeout or output truncation",
"column matching is exact after trimming comma-separated tokens; an empty effective list is allowed and produces a zero-column CSV representation"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json",
"csv"
]
},
"io": {
"input_contract": [
{
"name": "file_path",
"kind": "file_path",
"artifact_types": [
"csv"
],
"extensions": [
".csv"
],
"required": true,
"cli_position": 1
},
{
"name": "columns_to_filter",
"kind": "string",
"required": true,
"description": "Comma-separated exact column names; the script splits this single string on commas, trims tokens, and ignores empty tokens.",
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON transport envelope containing selected column names, row count, and the projected dataset as an embedded CSV string, or explicit read/column errors.",
"semantic_output": {
"artifact_type": "csv",
"payload_path": "csv",
"description": "On a success envelope, the csv field is the projected CSV artifact consumed by downstream steps and produced_files aliases."
}
}
},
"routing": {
"family": "csv-column-projection-to-embedded-csv",
"intent_tags": [
"keep selected columns from a CSV file",
"return a CSV column projection as text in JSON"
],
"negative_intents": [
"filter CSV rows by values or conditions",
"write a filtered CSV file to disk",
"convert CSV rows into a JSON array or perform analytics"
],
"dependency_slots": []
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://pandas.pydata.org",
"license": "BSD",
"backed_by": "CSV column projection via pandas",
"recognized_public_tool": true,
"source_hash": "sha256:591e42b841b5d2ce5dee2d31e12443ef09e338a5a539508d5ce3edd37ca3fb0f",
"local_implementation_uri": "file://Pool/resources/tools/script/csv_column_filter.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/csv_column_filter.py",
"execution_status": "active"
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"data-processing",
"CSV",
"tools"
]
},
"input_contract": [
{
"name": "file_path",
"kind": "file_path",
"artifact_types": [
"csv"
],
"extensions": [
".csv"
],
"required": true,
"cli_position": 1
},
{
"name": "columns_to_filter",
"kind": "string",
"required": true,
"description": "Comma-separated exact column names; the script splits this single string on commas, trims tokens, and ignores empty tokens.",
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON transport envelope containing selected column names, row count, and the projected dataset as an embedded CSV string, or explicit read/column errors.",
"semantic_output": {
"artifact_type": "csv",
"payload_path": "csv",
"description": "On a success envelope, the csv field is the projected CSV artifact consumed by downstream steps and produced_files aliases."
}
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "pandas",
"version": "==2.2.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.dependency_cve_checker.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Audit either an existing Python requirements file or the current environment with pip-audit JSON output",
"description": "If the optional argument names an existing path, runs `pip-audit -r <path> -f json`; otherwise runs `pip-audit -f json` against the current Python environment. Known-vulnerability exit code 1 is treated as a completed audit, and no dependency is upgraded or fixed.",
"core_primitives": [
"audit_python_dependencies_with_pip_audit",
"audit_requirements_or_current_environment",
"return_pip_audit_native_json"
],
"problem_space": "Known-vulnerability lookup for Python dependencies represented by one requirements file or installed in the current runtime; not source-code security scanning, license auditing, dependency updating, or multi-ecosystem CVE analysis.",
"domain_tags": [
"security-audit",
"dependency-management",
"python-tools"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"pip-audit executable",
"access to pip-audit's configured vulnerability data sources and any dependency resolution resources it needs"
],
"io_signature": "Input: optional requirements_file path; an existing path selects requirements mode, while omission or a non-existing path selects current-environment mode. Output: JSON wrapper with parsed pip-audit JSON and process metadata or an execution error.",
"accepted_inputs": [
"an existing pip-compatible requirements file path",
"no argument to audit distributions installed in the current Python environment",
"a non-existing path, which is silently treated the same as no argument by this wrapper"
],
"output_shape": "Completed audit (pip-audit exit 0 or 1): {status: \"success\", tool: \"pip-audit\", target: string|null, exit_code: 0|1, result: object|array|null, stdout: string|null, stderr: string|null}; parsed native JSON is stored in result and stdout is null, while exit 1 means vulnerabilities were found. Other pip-audit exits use the same keys with status=\"tool_error\" and propagate the actual exit code. Missing executable or 300-second timeout: {status: \"error\", tool: \"pip-audit\", message: string}, exiting 3 or 4. The wrapper does not emit a missing-path error because a non-existing optional path selects environment mode.",
"limitations": [
"audits only Python packages known to pip-audit's configured advisory sources and does not scan application source like Bandit",
"does not fix, upgrade, pin, install into the project, or rewrite requirement files",
"exposes no pip-audit flags other than fixed JSON output and optional `-r`; it cannot select vulnerability services, formats, aliases, or ignore IDs",
"a typo or non-existing requirements path silently audits the current environment instead, and the command has a fixed 300-second timeout"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "requirements_file",
"kind": "string",
"required": false,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope containing parsed pip-audit findings for an existing requirements file or the current environment, plus target and exit metadata.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "python-pip-audit-known-vulnerability-check",
"intent_tags": [
"audit Python requirements for known vulnerabilities with pip-audit",
"audit the current Python environment for dependency CVEs"
],
"negative_intents": [
"scan Python source code for Bandit security issues",
"upgrade or automatically remediate vulnerable dependencies",
"audit npm, Cargo, operating-system, or other non-Python dependencies"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/dependency_cve_checker.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/pypa/pip-audit",
"license": "Apache-2.0",
"backed_by": "pip-audit",
"recognized_public_tool": true,
"source_hash": "sha256:1e08cda611e6a293cccbf73f662a369bf3bc2fc3f88d11214f8752def83fa273",
"local_implementation_uri": "file://Pool/resources/tools/script/dependency_cve_checker.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"security-audit",
"dependency-management",
"python-tools"
]
},
"input_contract": [
{
"name": "requirements_file",
"kind": "string",
"required": false,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope containing parsed pip-audit findings for an existing requirements file or the current environment, plus target and exit metadata.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [],
"commands": [
"pip-audit"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.dns_query_latency_checker.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Resolve one DNS name once with dnspython and report elapsed resolution time plus returned records",
"description": "Calls the default dnspython resolver for one hostname and optional record type, which defaults to A, measures that single resolve call with a monotonic performance timer, and returns textual resource records and elapsed milliseconds.",
"core_primitives": [
"resolve_dns_record_with_default_resolver",
"measure_single_dns_resolution_duration",
"serialize_dns_answers_as_text"
],
"problem_space": "One-shot DNS resolution timing and answer inspection through the environment's default resolver; not statistical benchmarking, authoritative DNS tracing, configurable nameserver probing, or general network latency testing.",
"domain_tags": [
"networking",
"performance-optimization",
"tools"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"dnspython",
"working DNS resolver configuration and network access as required"
],
"io_signature": "Input: required hostname and optional DNS record_type string defaulting to A; output: JSON with one measured resolution duration and textual answers or a DNS error.",
"accepted_inputs": [
"a hostname or DNS name resolvable by dnspython's default resolver",
"an optional record type supported by the installed dnspython, such as A, AAAA, MX, TXT, or CNAME"
],
"output_shape": "Success: {status: \"success\", tool: \"dnspython\", hostname: string, record_type: string, latency_ms: number rounded to two decimals, records: string[]}. Caught dns.exception.DNSException: {status: \"error\", tool: \"dnspython\", hostname: string, message: string} and exit 1. Missing hostname prints usage to stderr and exits 1 without JSON. Non-DNS exceptions are not caught and may produce a traceback rather than JSON.",
"limitations": [
"performs exactly one resolution, so latency_ms is not an average, percentile, or stable DNS benchmark and may reflect caching",
"uses dnspython's default resolver, nameservers, search behavior, retries, and timeout/lifetime settings with no caller overrides",
"measures the complete resolve call rather than isolated wire latency and does not trace delegation or query authoritative servers",
"does not impose wrapper-level timeout or output truncation; only dnspython DNSException errors receive structured JSON"
],
"artifact_input": [
"hostname"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "hostname",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "record_type",
"kind": "string",
"required": false,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON result for one default-resolver DNS lookup, including hostname, record type, elapsed milliseconds and textual records, or a DNS exception.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "dns-single-query-resolution-timing",
"intent_tags": [
"measure one DNS resolution and inspect returned records",
"resolve a hostname with an optional DNS record type"
],
"negative_intents": [
"benchmark DNS latency with repeated samples or percentiles",
"query a caller-selected DNS server or trace authoritative delegation",
"measure HTTP, ICMP, TCP, or general network latency"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/dns_query_latency_checker.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 50,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://www.dnspython.org",
"license": "ISC",
"backed_by": "DNS resolution + latency via dnspython",
"recognized_public_tool": true,
"source_hash": "sha256:6d93b51f9277bebb25ba6412a024c54ac19611197a035f5e009f5e54a1da850c",
"local_implementation_uri": "file://Pool/resources/tools/script/dns_query_latency_checker.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": false
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"networking",
"performance-optimization",
"tools"
]
},
"input_contract": [
{
"name": "hostname",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "record_type",
"kind": "string",
"required": false,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON result for one default-resolver DNS lookup, including hostname, record type, elapsed milliseconds and textual records, or a DNS exception.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "dnspython",
"version": "==2.7.0",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.docx2text.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Extract nonblank body paragraphs and table cell text from one DOCX into JSON",
"execution_semantics": {
"determinism": "deterministic",
"side_effects": "none",
"effect_targets": []
},
"description": "Opens one existing DOCX with python-docx, joins nonblank top-level document paragraphs with newline characters, and separately returns each table as nested table/row/cell text arrays. The operation is read-only and does not preserve document layout or paragraph/table interleaving.",
"core_primitives": [
"extract_nonblank_docx_body_paragraphs",
"extract_docx_table_cell_text",
"serialize_docx_text_as_json"
],
"problem_space": "Basic text extraction from DOCX body paragraphs and tables for downstream processing; not layout-preserving conversion, OCR, rich-text rendering, document editing, or complete extraction of every Word content part.",
"domain_tags": [
"document_processing",
"file_io",
"text_extraction"
]
},
"constraint": {
"env_requirements": [
"Python 3.x",
"python-docx"
],
"io_signature": "Input: one required existing .docx file path; output: JSON with nonblank body paragraph text, paragraph count, and separately nested table cell strings, or an explicit open/parse error.",
"accepted_inputs": [
"an existing, readable Office Open XML .docx document supported by python-docx"
],
"output_shape": "Success: {status: \"success\", tool: \"python-docx\", target: string, paragraph_count: integer, text: string, tables: string[][][]}; paragraph_count counts only nonblank top-level document paragraphs, text joins them with `\\n`, and tables is indexed as table/row/cell. Missing path: {status: \"error\", message: string} and exit 2. Open or parse failure: {status: \"error\", tool: \"python-docx\", message: string} and exit 1. The declared required input is validated before dispatch; direct CLI invocation without it prints usage and exits 1.",
"limitations": [
"text excludes blank body paragraphs and table content; table strings are returned only in the separate tables array",
"does not preserve the original interleaving of paragraphs and tables, formatting, styles, pagination, images, hyperlinks, or layout",
"does not explicitly extract headers, footers, footnotes, comments, tracked-change semantics, text boxes, or embedded-object text",
"loads and emits the document without an explicit timeout, size limit, or output truncation and never modifies the DOCX"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "file_path",
"kind": "str",
"required": true,
"extensions": [
".docx"
],
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON object containing target path, nonblank body-paragraph count and joined text, plus table/row/cell strings or a parse error.",
"json_schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"oneOf": [
{
"type": "object",
"required": [
"status",
"tool",
"target",
"paragraph_count",
"text",
"tables"
],
"properties": {
"status": {
"const": "success"
},
"tool": {
"const": "python-docx"
},
"target": {
"type": "string"
},
"paragraph_count": {
"type": "integer",
"minimum": 0
},
"text": {
"type": "string"
},
"tables": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"message"
],
"properties": {
"status": {
"const": "error"
},
"tool": {
"const": "python-docx"
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
]
},
"result_status": {
"payload_path": "status",
"success_values": [
"success"
],
"failure_values": [
"error"
]
}
}
},
"routing": {
"family": "docx-basic-paragraph-and-table-text-extraction",
"intent_tags": [
"extract body paragraph text from a DOCX",
"read DOCX table cell text into nested arrays"
],
"negative_intents": [
"preserve DOCX formatting, layout, or paragraph-table order",
"edit, convert, render, or OCR a Word document",
"extract every Word part such as headers, comments, or text boxes"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/docx2text.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://python-docx.readthedocs.io",
"license": "MIT",
"backed_by": "DOCX text extraction via python-docx",
"recognized_public_tool": true,
"source_hash": "sha256:f82efabca2d58ca34f7f7cbf3129c8324c6667316bcddfc54f342f3ca868b56f",
"local_implementation_uri": "file://Pool/resources/tools/script/docx2text.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"document_processing",
"file_io",
"text_extraction"
]
},
"input_contract": [
{
"name": "file_path",
"kind": "str",
"required": true,
"extensions": [
".docx"
],
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON object containing target path, nonblank body-paragraph count and joined text, plus table/row/cell strings or a parse error.",
"json_schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"oneOf": [
{
"type": "object",
"required": [
"status",
"tool",
"target",
"paragraph_count",
"text",
"tables"
],
"properties": {
"status": {
"const": "success"
},
"tool": {
"const": "python-docx"
},
"target": {
"type": "string"
},
"paragraph_count": {
"type": "integer",
"minimum": 0
},
"text": {
"type": "string"
},
"tables": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"message"
],
"properties": {
"status": {
"const": "error"
},
"tool": {
"const": "python-docx"
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
]
},
"result_status": {
"payload_path": "status",
"success_values": [
"success"
],
"failure_values": [
"error"
]
}
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "python-docx",
"version": "==1.1.2",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.dotenv_to_json_converter.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Parse one dotenv file with python-dotenv defaults and return its key/value mapping inside JSON",
"description": "Reads an existing dotenv file through `dotenv_values(path)`, converts the parsed mapping to a dictionary, and emits it under the `json` key with a key count. The tool returns data only; it neither creates a .json file nor mutates the process environment.",
"core_primitives": [
"parse_dotenv_with_python_dotenv_defaults",
"serialize_environment_mapping_as_json",
"count_parsed_dotenv_keys"
],
"problem_space": "Read-only conversion of one dotenv configuration into an in-memory JSON mapping; not environment loading, secret redaction, schema validation, encrypted secret management, or JSON file generation.",
"domain_tags": [
"configuration_management",
"file_processing"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"python-dotenv"
],
"io_signature": "Input: one required existing dotenv-format file path; output: JSON envelope containing the parsed key/value object and key count, with a structured missing-path error only.",
"accepted_inputs": [
"an existing text file in syntax accepted by python-dotenv's dotenv_values default parser"
],
"output_shape": "Success: {status: \"success\", tool: \"python-dotenv\", target: string, key_count: integer, json: object}; values are strings or null according to python-dotenv parsing. Missing path: {status: \"error\", message: string} and exit 2. Missing argument prints usage to stderr and exits 1 without JSON. Parsing, decoding, permission, or other exceptions are not caught and may produce a traceback with a nonzero exit instead of JSON.",
"limitations": [
"uses python-dotenv defaults, including its normal quoting, expansion/interpolation, duplicate-key, and valueless-key behavior, with no parser options exposed",
"returns secret values in plaintext JSON with no masking, allowlist, encryption, or sensitivity detection",
"does not write a JSON artifact, update the source dotenv file, or load values into os.environ",
"has no explicit timeout, size limit, or output truncation and does not wrap parser exceptions"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing the python-dotenv parsed key/value mapping and key count; no JSON file or environment mutation is produced.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "dotenv-to-in-memory-json-mapping",
"intent_tags": [
"parse a dotenv file into a JSON key-value mapping",
"inspect dotenv values and parsed key count"
],
"negative_intents": [
"create or write a JSON file on disk",
"load dotenv values into the process environment",
"redact, encrypt, rotate, or validate secrets"
],
"dependency_slots": []
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/theskumar/python-dotenv",
"license": "BSD",
"backed_by": "python-dotenv",
"recognized_public_tool": true,
"source_hash": "sha256:b552c6b50b7b99a5e19b57ccb88554f50efb7924a6e0594a42168f919e60fdf1",
"local_implementation_uri": "file://Pool/resources/tools/script/dotenv_to_json_converter.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/dotenv_to_json_converter.py",
"execution_status": "active"
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"configuration_management",
"file_processing"
]
},
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing the python-dotenv parsed key/value mapping and key count; no JSON file or environment mutation is produced.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "python-dotenv",
"version": "==1.0.1",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.duckdb_query.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Run bounded read-only analytical SQL with DuckDB 1.5.5",
"description": "Thin SGAR adapter over upstream DuckDB using an in-memory database, fixed memory/thread bounds and a deny policy for mutation, extension installation and remote access.",
"domain_tags": [
"data",
"sql",
"analytics"
],
"core_primitives": [
"execute_analytical_sql",
"query_local_tabular_data",
"return_bounded_rows"
],
"problem_space": "Read-only analytical SQL and local tabular inspection; not database mutation, persistent database management, extension loading, remote SQL, or arbitrary filesystem access."
},
"constraint": {
"io_signature": "Input SQL, explicit local input_refs and max_rows; output columns, bounded rows, count and truncation flag.",
"accepted_inputs": [
"read-only analytical SQL",
"explicit existing local input files"
],
"output_shape": "JSON columns and rows or explicit policy/query error.",
"limitations": [
"denies DDL, DML, ATTACH, COPY, INSTALL, LOAD, PRAGMA, SET and remote URLs",
"in-memory database only",
"256 MB memory and two threads",
"maximum 10000 returned rows"
],
"operation_kinds": [
"local_read",
"analytical_query"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "sql",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Bounded read-only DuckDB query result.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "read-only-analytical-sql",
"intent_tags": [
"analyze tabular data with SQL",
"query CSV JSON or Parquet locally"
],
"negative_intents": [
"modify a database",
"install DuckDB extensions",
"query remote URLs"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/duckdb_query.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/duckdb/duckdb/tree/v1.5.5",
"version": "1.5.5",
"license": "MIT",
"license_url": "https://github.com/duckdb/duckdb/blob/v1.5.5/LICENSE",
"license_sha256": "7e17fd31249fa875cb3b1c5e05c6c3e99b75509f6a2804ca176c217834de1dcb",
"upstream_release": "https://github.com/duckdb/duckdb/releases/tag/v1.5.5",
"backed_by": "DuckDB",
"recognized_public_tool": true,
"source_hash": "sha256:0ee7601668b01c626386ffe984b4d273a7ea0fa52e4de28bf6751b4341d7fd5e",
"local_implementation_uri": "file://Pool/resources/tools/script/duckdb_query.py"
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "duckdb",
"version": "==1.5.5",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.eslint_checker.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Lint one JavaScript/TypeScript target with ESLint native JSON output and a fixed explicit config",
"description": "Runs ESLint with JSON formatting, disables normal config lookup, and supplies the config path from `SGAR_ESLINT_CONFIG` or `/opt/eslint.config.mjs`. It reports rule findings without `--fix` and therefore does not rewrite source files.",
"core_primitives": [
"lint_javascript_typescript_with_eslint",
"apply_explicit_eslint_flat_config",
"return_eslint_native_json_findings"
],
"problem_space": "Read-only ESLint rule analysis for one existing JavaScript/TypeScript-compatible target under one explicit config; not source formatting, automatic fixing, compilation, type checking, or Python linting.",
"domain_tags": [
"JavaScript",
"code-checking",
"development-tools"
]
},
"constraint": {
"env_requirements": [
"Python 3.6+",
"eslint",
"an ESLint configuration file must exist at the path in SGAR_ESLINT_CONFIG, or at /opt/eslint.config.mjs when that environment variable is unset"
],
"io_signature": "Input: one required existing file or path accepted by ESLint; output: JSON execution envelope containing parsed ESLint JSON findings and process metadata or an explicit execution error.",
"accepted_inputs": [
"an existing JavaScript or TypeScript source file supported by the configured ESLint setup",
"an existing path or pattern-free directory argument that the installed ESLint accepts as one target"
],
"output_shape": "Completed lint (ESLint exit 0 or 1): {status: \"success\", tool: \"eslint\", target: string, exit_code: 0|1, result: array|object|null, stdout: string|null, stderr: string|null}; parsed ESLint native JSON is stored in result and stdout becomes null, while exit 1 represents lint findings. Other ESLint exits use the same keys with status=\"tool_error\" and propagate the actual exit code. Missing target/executable/120-second timeout: {status: \"error\", tool: \"eslint\", message: string}, exiting 2/3/4. Missing argument prints usage to stderr and exits 1 without JSON.",
"limitations": [
"fixed `--no-config-lookup --config` behavior ignores ordinary ESLint config discovery and uses only `SGAR_ESLINT_CONFIG` or `/opt/eslint.config.mjs`",
"does not pass `--fix` or `--fix-dry-run`, so it neither changes files nor returns formatter-oriented fixed source",
"exposes no rule, extension, ignore, cache, warning-threshold, or formatter options through inputs",
"requires ESLint and the selected config to be available, uses a fixed 120-second timeout, and does not truncate captured output"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "target_path",
"kind": "str",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope containing parsed ESLint lint findings, target, exit code and stderr/stdout metadata; source files are not fixed.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "javascript-eslint-lint-check-only",
"intent_tags": [
"lint JavaScript or TypeScript with ESLint JSON output",
"check ESLint rule violations using the S-GAR explicit config"
],
"negative_intents": [
"format or automatically fix JavaScript or TypeScript source",
"run a generic syntax compiler or TypeScript type checker",
"lint Python with flake8, Ruff, Black, or Bandit"
],
"dependency_slots": []
},
"utility": {
"latency_ms": 200,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://eslint.org",
"license": "MIT",
"backed_by": "ESLint",
"recognized_public_tool": true,
"source_hash": "sha256:ff966fb4102010a52ce7a7e05d68bfd1a7c98c93b35f97d024bf49a182953bb3",
"local_implementation_uri": "file://Pool/resources/tools/script/eslint_checker.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/eslint_checker.py",
"execution_status": "active"
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"JavaScript",
"code-checking",
"development-tools"
]
},
"input_contract": [
{
"name": "target_path",
"kind": "str",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope containing parsed ESLint lint findings, target, exit code and stderr/stdout metadata; source files are not fixed.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [
{
"name": "eslint",
"version": "==10.0.1",
"required": true
}
],
"system_packages": [],
"commands": [
"eslint"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.eslint_code_formatter.v1",
"resource_type": "Tool",
"status": "inactive",
"capability": {
"summary": "Inactive legacy alias that duplicates eslint_checker exactly and is retained only for compatibility metadata",
"description": "This misnamed legacy resource invokes the same `eslint -f json --no-config-lookup --config <cfg> <file>` command as eslint_checker and adds no capability. It is inactive and excluded from ordinary indexing; if invoked directly, it remains read-only and returns the same ESLint diagnostics without formatting or fixing code.",
"core_primitives": [
"identify_legacy_duplicate_eslint_wrapper",
"inspect_deprecated_formatter_alias_metadata",
"preserve_legacy_output_contract_reference"
],
"problem_space": "Compatibility metadata for an inactive, misnamed duplicate of eslint_checker; not a selectable linting or formatting capability and not a distinct implementation.",
"domain_tags": [
"JavaScript",
"code-quality",
"development-tools"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"eslint executable",
"an ESLint config at SGAR_ESLINT_CONFIG or /opt/eslint.config.mjs"
],
"io_signature": "Input: one required existing file path accepted by the configured ESLint; output: JSON envelope containing parsed lint diagnostics and process metadata, never formatted source code.",
"accepted_inputs": [
"an existing JavaScript or TypeScript source file supported by the selected ESLint configuration"
],
"output_shape": "Completed lint (ESLint exit 0 or 1): {status: \"success\", tool: \"eslint\", target: string, exit_code: 0|1, result: array|object|null, stdout: string|null, stderr: string|null}; parsed native JSON diagnostics are in result and stdout becomes null. Other ESLint exits use the same keys with status=\"tool_error\" and propagate the actual exit code. Missing file/executable/120-second timeout: {status: \"error\", tool: \"eslint\", message: string}, exiting 2/3/4. Missing argument prints usage to stderr and exits 1 without JSON. No success or failure shape contains a formatted_code key.",
"limitations": [
"inactive legacy alias excluded from ordinary index construction and routing; use eslint_checker for the identical supported read-only lint behavior",
"duplicates eslint_checker flags, configuration selection, exit handling, timeout, and output shape exactly, so it provides no separate capability",
"the formatter name is misleading: direct invocation does not return formatted source, produce a diff, apply fixes, or modify files",
"retained only for compatibility metadata and must not be selected for ordinary lint, formatting, or fix requests"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope of read-only ESLint diagnostics and exit metadata; despite the resource name, it contains no formatted code and causes no file writes."
}
},
"routing": {
"family": "inactive-legacy-duplicate-eslint-alias",
"intent_tags": [
"identify legacy duplicate ESLint wrapper",
"inspect deprecated formatter alias metadata"
],
"negative_intents": [
"run ordinary JavaScript or TypeScript lint checks",
"format, rewrite, or automatically fix JavaScript or TypeScript code",
"return formatted source code or a formatting diff",
"select a distinct capability instead of the supported eslint_checker duplicate"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/eslint_code_formatter.py",
"execution_status": "inactive"
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://eslint.org",
"license": "MIT",
"backed_by": "ESLint",
"recognized_public_tool": true,
"source_hash": "sha256:6736f21bf535602b170b79ef67a83033a429f088e69bb16e868f2c074b406de0",
"local_implementation_uri": "file://Pool/resources/tools/script/eslint_code_formatter.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"JavaScript",
"code-quality",
"development-tools"
]
},
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope of read-only ESLint diagnostics and exit metadata; despite the resource name, it contains no formatted code and causes no file writes."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [
{
"name": "eslint",
"version": "==10.0.1",
"required": true
},
{
"name": "prettier",
"version": "==3.9.6",
"required": true
}
],
"system_packages": [],
"commands": [
"eslint",
"prettier"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.flake8_lint_runner.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Run Flake8 on one Python file or directory and return its raw textual findings in a JSON envelope",
"description": "Validates the target path and executes `flake8 <target>` without formatter or fix flags. Flake8 may discover its normal project configuration; findings remain unparsed text in `stdout`, and source files are never modified.",
"core_primitives": [
"lint_python_with_flake8",
"inspect_python_file_or_directory",
"capture_flake8_text_diagnostics"
],
"problem_space": "Read-only Flake8 style and static lint diagnostics for Python files or directories; not formatting, automatic fixing, Bandit security scanning, Ruff-specific linting, or structured finding normalization.",
"domain_tags": [
"python",
"linting",
"code_quality"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"flake8"
],
"io_signature": "Input: one required existing Python file or directory path; output: JSON process envelope containing Flake8's raw text stdout/stderr and exit code.",
"accepted_inputs": [
"an existing Python source file path",
"an existing directory path for Flake8 traversal"
],
"output_shape": "Completed lint (Flake8 exit 0 or 1): {status: \"success\", tool: \"flake8\", target: string, exit_code: 0|1, result: null, stdout: string, stderr: string|null}; exit 0 means no reported violations and exit 1 means findings, whose standard Flake8 lines remain in stdout. Other exits use the same keys with status=\"tool_error\" and propagate the actual exit code. Missing target/executable/120-second timeout: {status: \"error\", tool: \"flake8\", message: string}, exiting 2/3/4. Missing argument prints usage to stderr and exits 1 without JSON.",
"limitations": [
"does not request native JSON or parse Flake8 lines, so result is null and findings are unstructured stdout text inside the outer JSON envelope",
"does not fix, format, or rewrite Python code and offers no caller-selectable Flake8 flags, plugins, ignores, or thresholds",
"Flake8's normal configuration discovery and installed plugin set can affect results",
"requires `flake8` on PATH, uses a fixed 120-second timeout, and captures output without truncation"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "target_path",
"kind": "path",
"artifact_types": [
"code"
],
"extensions": [
".py"
],
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope with Flake8's exit code and raw unparsed text findings in stdout; result remains null and files are unchanged.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "python-flake8-text-lint-check",
"intent_tags": [
"lint Python code with Flake8",
"collect Flake8 textual diagnostics for a file or directory"
],
"negative_intents": [
"format Python with Black or automatically fix lint violations",
"run Ruff-specific lint rules or return structured Ruff JSON",
"scan Python code for Bandit security vulnerabilities"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/flake8_lint_runner.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://flake8.pycqa.org",
"license": "MIT",
"backed_by": "Flake8",
"recognized_public_tool": true,
"source_hash": "sha256:6d109b462254de4a180d41a14a1610fb73c8e64a46f1dc08a8467e57e5079144",
"local_implementation_uri": "file://Pool/resources/tools/script/flake8_lint_runner.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"python",
"linting",
"code_quality"
]
},
"input_contract": [
{
"name": "target_path",
"kind": "path",
"artifact_types": [
"code"
],
"extensions": [
".py"
],
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope with Flake8's exit code and raw unparsed text findings in stdout; result remains null and files are unchanged.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [],
"commands": [
"flake8"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.git_blame_analyzer.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Summarize `git blame --line-porcelain` as blamed-line counts grouped by author name",
"description": "Runs Git blame for one existing file from that file's directory, scans porcelain output for `author ` records, and returns only a total blamed-line count plus an author-to-line-count mapping ordered by frequency. It is a read-only aggregate, not a full blame report.",
"core_primitives": [
"run_git_blame_line_porcelain",
"count_blame_lines_by_author_name",
"summarize_file_authorship_counts"
],
"problem_space": "Coarse per-author line-count summarization for one Git-tracked file; not commit-history analysis, responsibility determination, per-line attribution retrieval, repository mutation, or branch cleanup.",
"domain_tags": [
"version-control",
"software-development",
"code-analysis"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"git"
],
"io_signature": "Input: one required existing file path inside a discoverable Git repository; output: JSON with total blamed lines and counts grouped only by porcelain author name, or a Git/path error.",
"accepted_inputs": [
"an existing file path for which `git blame` can discover a containing repository and produce blame data"
],
"output_shape": "Success: {status: \"success\", tool: \"git\", file: string, total_lines: integer, lines_by_author: object}; lines_by_author maps author display names to blamed-line counts in descending `Counter.most_common()` order, and total_lines counts parsed `author ` records. Missing file: {status: \"error\", message: string} and exit 2. Nonzero git blame: {status: \"error\", tool: \"git\", message: string} and exit 1. Missing argument prints usage to stderr and exits 1 without JSON. Missing Git executable, 60-second timeout, or other subprocess exceptions are uncaught and may yield a traceback instead of JSON.",
"limitations": [
"returns only aggregate counts by author display name and discards commit hashes, emails, timestamps, line numbers, source lines, and per-line attribution",
"author names are not canonical identities; identical names can merge and one person using different names can split across keys",
"does not analyze repository-wide history, infer code ownership or responsibility, compare revisions, or mutate Git state",
"uses the file's parent as `git -C` and an absolute file argument, applies a fixed 60-second timeout, does not truncate output, and does not catch timeout or executable-not-found exceptions"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON summary containing one file path, total parsed blame lines, and blamed-line counts grouped by author display name, or a path/Git error.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "git-read-only-blame-author-count-summary",
"intent_tags": [
"summarize blamed line counts by author for one Git file",
"get a coarse Git blame authorship distribution"
],
"negative_intents": [
"retrieve per-line blame details, commits, dates, or author emails",
"analyze full Git history or determine definitive code ownership",
"delete branches, commit changes, or otherwise mutate a repository"
],
"dependency_slots": []
},
"utility": {
"latency_ms": 200,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://git-scm.com/",
"license": "GPLv2",
"backed_by": "wraps git(1) CLI",
"recognized_public_tool": true,
"source_hash": "sha256:3cf3e42ea3278722849a1bdb7aaebbed1cd3e989f1c44700542e263e055c62d4",
"local_implementation_uri": "file://Pool/resources/tools/script/git_blame_analyzer.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/git_blame_analyzer.py",
"execution_status": "active"
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"version-control",
"software-development",
"code-analysis"
]
},
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON summary containing one file path, total parsed blame lines, and blamed-line counts grouped by author display name, or a path/Git error.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [
{
"name": "git",
"version": "image-locked",
"required": true
}
],
"commands": [
"git"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.git_branch_cleaner.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Read-only audit of local and remote-tracking branches already merged into the repository's current HEAD",
"description": "Runs `git -C <repo> branch -a --merged`, strips Git's current-branch marker from each nonblank output line, and returns the resulting candidate list. Despite the cleaner name, it never deletes, prunes, fetches, or otherwise changes branches or remotes.",
"core_primitives": [
"list_branches_merged_into_head",
"inspect_local_and_remote_tracking_branches",
"report_cleanup_candidates_without_mutation"
],
"problem_space": "Read-only discovery of branch names Git reports as merged into current HEAD; not branch deletion, remote cleanup, stale-branch age analysis, merged-PR detection, or repository mutation.",
"domain_tags": [
"git",
"version-control",
"development-tools"
]
},
"constraint": {
"env_requirements": [
"Python 3.6+",
"git"
],
"io_signature": "Input: repo_path CLI argument, with the script defaulting to `.` when omitted; output: JSON list and count of `git branch -a --merged` lines or a path/Git error.",
"accepted_inputs": [
"an existing local Git repository directory path",
"no CLI argument when the current working directory should be inspected through the declared `.` default"
],
"output_shape": "Success: {status: \"success\", tool: \"git\", repo: string, merged_branch_count: integer, merged_branches: string[]}; entries are stripped nonblank lines from `git branch -a --merged` and may include the current local branch, remote-tracking names, and symbolic remote HEAD text. Non-existing repo path: {status: \"error\", message: string} and exit 2. Nonzero Git result: {status: \"error\", tool: \"git\", message: string} and exit 1. Missing Git executable, 30-second timeout, or other subprocess exceptions are uncaught and may produce a traceback instead of JSON.",
"limitations": [
"despite the cleaner name, this is audit-only and performs no branch deletion, remote deletion, fetch, prune, checkout, or other Git mutation",
"merged means reachable from the repository's current HEAD according to `git branch -a --merged`; no target base branch or revision can be selected",
"does not exclude the current branch, protected branches, default branches, remote HEAD symbolic entries, or branches by age, ownership, or worktree use",
"remote-tracking information may be stale because the wrapper does not fetch or prune; it uses a fixed 30-second timeout and does not catch timeout or executable-not-found exceptions"
],
"artifact_input": [
"repo_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "repo_path",
"kind": "string",
"required": false,
"default": ".",
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON read-only audit containing the count and raw names of local and remote-tracking branches Git reports merged into current HEAD; nothing is deleted.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "git-read-only-merged-branch-audit",
"intent_tags": [
"list branches already merged into the current Git HEAD",
"inspect local and remote-tracking cleanup candidates without deleting them"
],
"negative_intents": [
"delete, prune, or clean local or remote Git branches",
"fetch remotes or refresh remote-tracking branch state",
"find stale branches by age or branches merged into a caller-selected base"
],
"dependency_slots": []
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://git-scm.com/",
"license": "GPLv2",
"backed_by": "wraps git(1) CLI",
"recognized_public_tool": true,
"source_hash": "sha256:c49397c04df51d0386c49213ddd9773b33a8d94108e58dfdec4203590985139d",
"local_implementation_uri": "file://Pool/resources/tools/script/git_branch_cleaner.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/git_branch_cleaner.py",
"execution_status": "active"
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"git",
"version-control",
"development-tools"
]
},
"input_contract": [
{
"name": "repo_path",
"kind": "string",
"required": false,
"default": ".",
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON read-only audit containing the count and raw names of local and remote-tracking branches Git reports merged into current HEAD; nothing is deleted.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [
{
"name": "git",
"version": "image-locked",
"required": true
}
],
"commands": [
"git"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.git_commit_lint.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Lint one existing commit-message file with gitlint and return textual violation lines",
"description": "Runs `gitlint --msg-filename <file>`, records every nonblank stdout line as a violation, and reports whether gitlint returned zero. It is read-only and does not normalize, rewrite, commit, or otherwise modify Git state.",
"core_primitives": [
"lint_commit_message_file_with_gitlint",
"collect_gitlint_stdout_violations",
"report_gitlint_clean_boolean"
],
"problem_space": "Read-only gitlint validation of one commit-message file; not message formatting, commit creation, repository history analysis, hook installation, or commit amendment.",
"domain_tags": [
"git",
"development-tools",
"code-quality"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"gitlint executable"
],
"io_signature": "Input: one required existing commit-message file path; output: JSON with gitlint's actual exit code, clean boolean, nonblank stdout violation lines, and stderr.",
"accepted_inputs": [
"an existing text file containing a Git commit message accepted by gitlint's --msg-filename option"
],
"output_shape": "After any completed gitlint process: {status: \"success\", tool: \"gitlint\", target: string, exit_code: integer, clean: boolean, violations: string[], stderr: string|null}; clean is true only for exit_code 0, violations contains nonblank stdout lines, and the wrapper itself exits 0 even when gitlint returns nonzero. Non-existing file: {status: \"error\", message: string} and exit 2. Missing argument prints usage to stderr and exits 1 without JSON. Missing executable, 60-second timeout, and other subprocess exceptions are uncaught and may produce a traceback instead of JSON.",
"limitations": [
"does not modify or normalize the commit message, create a commit, amend history, or install Git hooks",
"always reports status=success after a completed subprocess and does not propagate gitlint's nonzero exit code; consumers must inspect clean and exit_code",
"returns unparsed nonblank stdout lines rather than structured rule identifiers and may be affected by gitlint's normal configuration discovery",
"uses a fixed 60-second timeout, applies no output truncation, and does not catch timeout or executable-not-found errors"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "commit_msg_file",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON gitlint report containing target, actual gitlint exit code, clean flag, textual violation lines, and stderr; the message file is unchanged.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "git-commit-message-gitlint-check-only",
"intent_tags": [
"lint a Git commit message file with gitlint",
"check whether a commit message satisfies gitlint rules"
],
"negative_intents": [
"format or rewrite a Git commit message",
"create, amend, inspect, or publish Git commits",
"analyze Git diffs, logs, branches, tags, or blame history"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/git_commit_lint.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://jorisroovers.com/gitlint",
"license": "MIT",
"backed_by": "gitlint",
"recognized_public_tool": true,
"source_hash": "sha256:942e46bb203db12bb286f4a6b3983584d5d9c0c813e5b956f6ae6e2cec3d6fab",
"local_implementation_uri": "file://Pool/resources/tools/script/git_commit_lint.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"git",
"development-tools",
"code-quality"
]
},
"input_contract": [
{
"name": "commit_msg_file",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON gitlint report containing target, actual gitlint exit code, clean flag, textual violation lines, and stderr; the message file is unchanged.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "gitlint-core",
"version": "==0.19.1",
"required": true
}
],
"node_packages": [],
"system_packages": [
{
"name": "git",
"version": "image-locked",
"required": true
}
],
"commands": [
"git",
"gitlint"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.git_diff_stat.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Return Git's textual --stat summary for unstaged tracked working-tree changes",
"description": "Runs `git -C <repo> diff --stat` for an optional repository path defaulting to the current directory. It reports the default working-tree-versus-index diff summary without changing repository state.",
"core_primitives": [
"summarize_unstaged_git_diff",
"run_git_diff_stat",
"capture_git_stat_text"
],
"problem_space": "Read-only size summary of the default unstaged tracked-file diff in one repository; not patch retrieval, staged-change inspection, commit-range comparison, untracked-file discovery, or Git mutation.",
"domain_tags": [
"version-control",
"software-development",
"automation"
]
},
"constraint": {
"env_requirements": [
"Python 3.6+",
"git"
],
"io_signature": "Input: optional existing repo_path string defaulting to `.`; output: JSON process envelope with raw `git diff --stat` stdout, stderr, and exit code.",
"accepted_inputs": [
"an existing local Git repository directory path",
"no argument to inspect the current working directory via the `.` default"
],
"output_shape": "Success: {status: \"success\", tool: \"git\", target: string, exit_code: 0, result: null, stdout: string, stderr: string|null}; stdout is Git's unparsed --stat text and may be empty when there are no unstaged tracked changes. Nonzero Git result uses the same keys with status=\"tool_error\" and propagates Git's exit code. Non-existing path, missing executable, or 120-second timeout: {status: \"error\", tool: \"git\", message: string}, exiting 2/3/4. The optional argument defaults to `.` and therefore has no missing-argument usage failure.",
"limitations": [
"uses plain `git diff --stat` with no `--cached`, revisions, pathspecs, numstat, patch, or caller-supplied flags",
"summarizes unstaged tracked-file differences between the working tree and index; staged-only and untracked changes are not represented",
"returns unparsed Git text in stdout with result=null and applies no output truncation",
"requires Git on PATH, uses a fixed 120-second timeout, and never modifies repository state"
],
"artifact_input": [
"repo_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "repo_path",
"kind": "string",
"required": false,
"default": ".",
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope containing unparsed `git diff --stat` text for unstaged tracked changes, plus target and process metadata.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "git-read-only-unstaged-diff-stat",
"intent_tags": [
"summarize unstaged Git working-tree changes",
"get a textual git diff --stat for a repository"
],
"negative_intents": [
"inspect staged changes or compare commits and branches",
"retrieve a full Git patch or structured per-line diff",
"modify, stage, commit, reset, or clean repository files"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/git_diff_stat.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://git-scm.com/",
"license": "GPLv2",
"backed_by": "wraps git(1) CLI",
"recognized_public_tool": true,
"source_hash": "sha256:eb824c8a5f34bb7681977a7e32ebffd9292faa6c84b95ae4433ab416c3606b19",
"local_implementation_uri": "file://Pool/resources/tools/script/git_diff_stat.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"version-control",
"software-development",
"automation"
]
},
"input_contract": [
{
"name": "repo_path",
"kind": "string",
"required": false,
"default": ".",
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope containing unparsed `git diff --stat` text for unstaged tracked changes, plus target and process metadata.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [
{
"name": "git",
"version": "image-locked",
"required": true
}
],
"commands": [
"git"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.git_log_json.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Return up to a requested number of current Git history entries as commit, author, ISO date, and subject objects",
"description": "Runs a fixed `git log` format in an optional repository defaulting to `.` and parses unit-separator-delimited lines into JSON objects. The count defaults to 20 and any non-digit count silently falls back to 20.",
"core_primitives": [
"read_current_git_history",
"parse_fixed_git_log_fields",
"return_commit_metadata_objects"
],
"problem_space": "Structured summary of a bounded prefix of the current repository history; not arbitrary pretty formatting, patch or graph output, revision-range querying, branch mutation, or full commit-object inspection.",
"domain_tags": [
"version-control",
"software-development",
"data-processing"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"git"
],
"io_signature": "Input: optional repo_path defaulting to `.` and optional digit-string count defaulting/falling back to `20`; output: JSON with parsed commit/author/date/subject log entries.",
"accepted_inputs": [
"an existing local Git repository directory path or omission for the current directory",
"an optional non-negative digit string passed to `git log -n`; non-digit text silently uses 20"
],
"output_shape": "Success: {status: \"success\", tool: \"git\", repo: string, count: integer, logs: object[]}, where each log object is {commit: string, author: string, date: string, subject: string}; count is the number actually parsed, not the requested value. Non-existing repo: {status: \"error\", message: string} and exit 2. Nonzero Git result: {status: \"error\", tool: \"git\", message: string} and exit 1. Missing Git executable, 30-second timeout, or other subprocess exceptions are uncaught and may produce a traceback instead of JSON.",
"limitations": [
"uses the repository's default current-history traversal with no revision, branch, path, author, date-range, merge, graph, or ordering controls",
"returns only full commit hash, author display name, ISO date text, and subject; bodies, emails, parents, signatures, refs, stats, and patches are omitted",
"non-digit count values silently become 20, while digit strings including `0` are passed directly to Git",
"uses a fixed 30-second timeout, applies no additional output truncation beyond `-n count`, and does not catch timeout or executable-not-found exceptions"
],
"artifact_input": [
"repo_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "repo_path",
"kind": "string",
"required": false,
"default": ".",
"cli_position": 1
},
{
"name": "count",
"kind": "string",
"required": false,
"default": "20",
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON report containing a bounded list of current-history entries with commit hash, author name, ISO date text, and subject.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "git-read-only-structured-current-log",
"intent_tags": [
"get recent Git commits as structured JSON",
"inspect commit hashes authors dates and subjects"
],
"negative_intents": [
"request a custom Git pretty format or raw text log",
"inspect commit patches, bodies, stats, graph, or signatures",
"create, amend, revert, reset, or otherwise mutate Git history"
],
"dependency_slots": []
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://git-scm.com/",
"license": "GPLv2",
"backed_by": "wraps git(1) CLI",
"recognized_public_tool": true,
"source_hash": "sha256:6f6c69381607df81244f894f253d8a3cb2114744a2226a6f6aeffb0375a49c42",
"local_implementation_uri": "file://Pool/resources/tools/script/git_log_json.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/git_log_json.py",
"execution_status": "active"
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"version-control",
"software-development",
"data-processing"
]
},
"input_contract": [
{
"name": "repo_path",
"kind": "string",
"required": false,
"default": ".",
"cli_position": 1
},
{
"name": "count",
"kind": "string",
"required": false,
"default": "20",
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON report containing a bounded list of current-history entries with commit hash, author name, ISO date text, and subject.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [
{
"name": "git",
"version": "image-locked",
"required": true
}
],
"commands": [
"git"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.git_log_pretty_format.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Return a fixed tab-separated recent Git log format inside a JSON process envelope",
"description": "Runs Git log for one required repository with a fixed short-hash, author, ISO date, and subject format. The optional digit-string max count defaults to 50; output remains unparsed text in stdout rather than structured log objects.",
"core_primitives": [
"render_fixed_pretty_git_log",
"limit_recent_commit_lines",
"capture_tab_separated_log_text"
],
"problem_space": "Read-only human-readable recent Git log text in one fixed tab-separated layout; not structured JSON records, arbitrary pretty-format execution, revision-range search, patch output, or history mutation.",
"domain_tags": [
"version-control",
"software-engineering",
"tools"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"git executable"
],
"io_signature": "Input: required existing repo_path and optional digit-string max_count defaulting/falling back to `50`; output: JSON envelope whose stdout contains fixed tab-separated Git log lines.",
"accepted_inputs": [
"an existing local Git repository directory path",
"an optional non-negative digit string for the maximum commit count; non-digit text silently uses 50"
],
"output_shape": "Success: {status: \"success\", tool: \"git\", target: string, exit_code: 0, result: null, stdout: string, stderr: string|null}; each stdout line uses `<short hash>\\t<author>\\t<ISO date>\\t<subject>`. Nonzero Git result uses the same keys with status=\"tool_error\" and propagates Git's exit code. Non-existing repo, missing Git, or 120-second timeout: {status: \"error\", tool: \"git\", message: string}, exiting 2/3/4. Missing repo argument prints usage to stderr and exits 1 without JSON.",
"limitations": [
"the pretty format is fixed to short hash, author display name, ISO date, and subject; callers cannot provide arbitrary Git format placeholders",
"returns unparsed tab-separated stdout with result=null rather than structured commit objects; use git_log_json for parsed fields",
"uses current default history traversal with no revision, branch, path, author, date-range, graph, body, stat, or patch options",
"non-digit max_count silently becomes 50; the wrapper uses a fixed 120-second timeout and no output truncation beyond the Git count"
],
"artifact_input": [
"repo_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "repo_path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "max_count",
"kind": "string",
"required": false,
"default": "50",
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope whose stdout contains fixed tab-separated recent Git log lines; no structured log array is produced.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "git-read-only-fixed-pretty-log-text",
"intent_tags": [
"display recent Git commits in a fixed tab-separated format",
"get short hash author ISO date and subject log lines"
],
"negative_intents": [
"return parsed JSON commit objects",
"use a caller-defined Git pretty format or revision range",
"inspect patches or modify Git history"
],
"dependency_slots": []
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://git-scm.com",
"license": "GPLv2",
"backed_by": "",
"recognized_public_tool": true,
"source_hash": "sha256:e9648a42681c6c5c08cc987db3b5764c45c65277e9966b8802c9503e6ae768b2",
"local_implementation_uri": "file://Pool/resources/tools/script/git_log_pretty_format.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/git_log_pretty_format.py",
"execution_status": "active"
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"version-control",
"software-engineering",
"tools"
]
},
"input_contract": [
{
"name": "repo_path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "max_count",
"kind": "string",
"required": false,
"default": "50",
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope whose stdout contains fixed tab-separated recent Git log lines; no structured log array is produced.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [
{
"name": "git",
"version": "image-locked",
"required": true
}
],
"commands": [
"git"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.git_merge_conflicts_scanner.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Search tracked working-tree files for line-leading Git conflict-marker text and return at most 200 matching lines",
"description": "Runs a fixed `git grep -nE` pattern for lines beginning with seven `<`, `=`, or `>` marker characters. It reports matching file names and a full match count, truncates marker details to 200 lines, and never resolves or edits conflicts.",
"core_primitives": [
"grep_tracked_files_for_conflict_markers",
"count_line_leading_marker_matches",
"list_files_with_marker_text"
],
"problem_space": "Heuristic read-only search for unresolved-looking marker text in tracked working-tree files; not Git index conflict-stage detection, merge-state validation, conflict resolution, or repository mutation.",
"domain_tags": [
"version-control",
"software-engineering",
"automation-tools"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"git executable"
],
"io_signature": "Input: one required existing repository path; output: JSON with unique matching files, total marker-line count, and at most the first 200 raw git-grep lines.",
"accepted_inputs": [
"an existing local Git repository directory whose tracked working-tree files should be searched"
],
"output_shape": "After any completed Git process: {status: \"success\", tool: \"git\", target: string, conflicted_files: string[], conflict_marker_count: integer, markers: string[]}; conflicted_files and count use every nonblank stdout line, while markers is truncated to lines[:200]. The Git exit code and stderr are omitted, so grep exit 1 (no matches) and hard Git failures can both appear as success with empty arrays. Non-existing path: {status: \"error\", message: string} and exit 2. Missing argument prints usage to stderr and exits 1 without JSON. Missing Git, 120-second timeout, and other subprocess exceptions are uncaught and may produce a traceback.",
"limitations": [
"detects only tracked-file lines beginning exactly with `<<<<<<<`, `=======`, or `>>>>>>>`; indented markers and nontracked files are missed, while legitimate matching text can be a false positive",
"does not inspect unmerged index stages via `git diff --diff-filter=U` or verify that the repository is in a merge/rebase conflict state",
"ignores Git's return code and stderr, so repository or command failures can be indistinguishable from a clean scan",
"returns at most 200 marker detail lines although counts/files use all stdout, uses a fixed 120-second timeout, and never edits or resolves files"
],
"artifact_input": [
"repo_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "repo_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON heuristic marker scan with all matching files, total line count, and at most 200 raw grep lines; Git failures are not distinguished from no matches.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "git-read-only-conflict-marker-grep",
"intent_tags": [
"scan tracked Git files for unresolved conflict marker text",
"list files containing line-leading merge marker patterns"
],
"negative_intents": [
"resolve or edit merge conflicts",
"reliably inspect Git unmerged index stages or merge state",
"scan untracked files or arbitrary non-Git directories"
],
"dependency_slots": []
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://git-scm.com",
"license": "GPLv2",
"backed_by": "",
"recognized_public_tool": true,
"source_hash": "sha256:4f14150afba9604c389a812fc29ca47f3fe69314d58442407791215bbbecf459",
"local_implementation_uri": "file://Pool/resources/tools/script/git_merge_conflicts_scanner.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/git_merge_conflicts_scanner.py",
"execution_status": "active"
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"version-control",
"software-engineering",
"automation-tools"
]
},
"input_contract": [
{
"name": "repo_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON heuristic marker scan with all matching files, total line count, and at most 200 raw grep lines; Git failures are not distinguished from no matches.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [
{
"name": "git",
"version": "image-locked",
"required": true
}
],
"commands": [
"git"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.git_submodule_status.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Return recursive Git submodule status as unparsed command-line text",
"description": "Runs `git -C <repo> submodule status --recursive` for one required existing repository and captures its stdout. It reports nested submodule state text without initializing, updating, syncing, fetching, or modifying submodules.",
"core_primitives": [
"inspect_recursive_git_submodule_status",
"capture_submodule_commit_lines",
"preserve_repository_state"
],
"problem_space": "Read-only recursive submodule status inspection for one Git repository; not submodule initialization, update, synchronization, cloning, removal, or structured dependency-health validation.",
"domain_tags": [
"version-control",
"software-engineering",
"development-tools"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"git executable"
],
"io_signature": "Input: one required existing Git repository path; output: JSON process envelope with raw recursive `git submodule status` stdout, stderr, and exit code.",
"accepted_inputs": [
"an existing local Git repository directory whose submodules should be listed recursively"
],
"output_shape": "Success: {status: \"success\", tool: \"git\", target: string, exit_code: 0, result: null, stdout: string, stderr: string|null}; stdout contains Git's unparsed recursive submodule lines and may be empty when no submodules exist. Nonzero Git result uses the same keys with status=\"tool_error\" and propagates Git's exit code. Non-existing path, missing executable, or 120-second timeout: {status: \"error\", tool: \"git\", message: string}, exiting 2/3/4. Missing argument prints usage to stderr and exits 1 without JSON.",
"limitations": [
"returns unparsed Git text with result=null; consumers must interpret leading space, `-`, `+`, or `U` status markers and commit/path text",
"always uses `--recursive` and exposes no pathspec, cached, summary, or other Git submodule options",
"does not initialize, update, sync, fetch, clone, deinitialize, or repair submodules and does not verify remote availability",
"requires Git on PATH, uses a fixed 120-second timeout, and captures output without truncation"
],
"artifact_input": [
"repo_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "repo_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope containing raw recursive `git submodule status` text and process metadata; no submodule state is changed.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "git-read-only-recursive-submodule-status",
"intent_tags": [
"inspect recursive Git submodule status",
"list submodule commits and paths without updating them"
],
"negative_intents": [
"initialize update sync fetch or clone Git submodules",
"return parsed submodule status objects or dependency health conclusions",
"inspect ordinary branches tags logs or working-tree diffs"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/git_submodule_status.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://git-scm.com",
"license": "GPLv2",
"backed_by": "",
"recognized_public_tool": true,
"source_hash": "sha256:d2c708e174c71f41e21efd399f9686a0bce0d742e1e0a5394034c12cb72f53be",
"local_implementation_uri": "file://Pool/resources/tools/script/git_submodule_status.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"version-control",
"software-engineering",
"development-tools"
]
},
"input_contract": [
{
"name": "repo_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope containing raw recursive `git submodule status` text and process metadata; no submodule state is changed.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [
{
"name": "git",
"version": "image-locked",
"required": true
}
],
"commands": [
"git"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.git_tags_inspector.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "List local Git tag names with direct object IDs and creator-date text in a fixed tab-separated format",
"description": "Runs `git tag -l` with a fixed refname/objectname/creatordate format for one repository. It returns raw text, does not peel annotated tags to commits, and performs no fetch, verification, creation, or deletion.",
"core_primitives": [
"list_local_git_tags",
"render_tag_object_and_creator_date",
"capture_tab_separated_tag_text"
],
"problem_space": "Read-only inventory of locally present Git refs/tags in one fixed text format; not release discovery from remotes, peeled commit resolution, signature validation, semantic-version analysis, or tag mutation.",
"domain_tags": [
"version-control",
"software-engineering",
"development-tools"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"git executable"
],
"io_signature": "Input: one required existing Git repository path; output: JSON process envelope whose stdout contains tab-separated local tag name, direct short object ID, and creator date lines.",
"accepted_inputs": [
"an existing local Git repository directory whose currently available tags should be listed"
],
"output_shape": "Success: {status: \"success\", tool: \"git\", target: string, exit_code: 0, result: null, stdout: string, stderr: string|null}; each stdout line is `<tag name>\\t<direct short object ID>\\t<creator date ISO text>`. Nonzero Git result uses the same keys with status=\"tool_error\" and propagates Git's exit code. Non-existing path, missing executable, or 120-second timeout: {status: \"error\", tool: \"git\", message: string}, exiting 2/3/4. Missing argument prints usage to stderr and exits 1 without JSON.",
"limitations": [
"returns unparsed tab-separated stdout with result=null and does not identify whether each tag is lightweight or annotated",
"`%(objectname:short)` is the direct ref target and can be an annotated tag object rather than the peeled commit",
"lists only locally available tags with Git's default ordering; it does not fetch remotes, inspect messages, verify signatures, or analyze semantic versions",
"uses a fixed 120-second timeout, captures output without truncation, and never creates, moves, pushes, or deletes tags"
],
"artifact_input": [
"repo_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "repo_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope whose stdout contains fixed tab-separated local tag names, direct short object IDs, and creator dates.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "git-read-only-local-tag-list-text",
"intent_tags": [
"list locally available Git tags with object IDs",
"inspect Git tag names and creator dates as text"
],
"negative_intents": [
"create delete move push or fetch Git tags",
"resolve annotated tags to peeled commits or verify signatures",
"inspect Git branches logs diffs or releases from a remote service"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/git_tags_inspector.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://git-scm.com",
"license": "GPLv2",
"backed_by": "",
"recognized_public_tool": true,
"source_hash": "sha256:91fe85be1bef7ceeb14cad38861b0f546bc2426bc640f93fd6620b3d566109fb",
"local_implementation_uri": "file://Pool/resources/tools/script/git_tags_inspector.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"version-control",
"software-engineering",
"development-tools"
]
},
"input_contract": [
{
"name": "repo_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope whose stdout contains fixed tab-separated local tag names, direct short object IDs, and creator dates.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [
{
"name": "git",
"version": "image-locked",
"required": true
}
],
"commands": [
"git"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.go_fmt_checker.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Check one Go source file with `gofmt -l -d` and return its listing and diff without rewriting it",
"description": "Runs gofmt's list-and-diff modes for one existing file. Formatting differences remain raw stdout text, and because no `-w` flag is used the source file is unchanged.",
"core_primitives": [
"check_gofmt_compliance",
"produce_gofmt_diff",
"preserve_go_source_file"
],
"problem_space": "Read-only gofmt compliance preview for one Go source file; not formatting application, Go linting, compilation, testing, package traversal, or source rewriting.",
"domain_tags": [
"go",
"code_quality",
"formatting"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"gofmt executable from a Go toolchain"
],
"io_signature": "Input: one required existing Go source file path; output: JSON process envelope with raw `gofmt -l -d` stdout/diff, stderr, and exit code.",
"accepted_inputs": [
"an existing Go source file accepted by gofmt"
],
"output_shape": "Completed check: {status: \"success\", tool: \"gofmt\", target: string, exit_code: 0, result: null, stdout: string, stderr: string|null}; nonempty stdout lists the file and/or shows the proposed diff, while already formatted input normally yields empty stdout. Nonzero gofmt result uses the same keys with status=\"tool_error\" and propagates its exit code. Non-existing path, missing executable, or 120-second timeout: {status: \"error\", tool: \"gofmt\", message: string}, exiting 2/3/4. Missing argument prints usage to stderr and exits 1 without JSON.",
"limitations": [
"fixed `-l -d` flags make this check-only; it never uses `-w` and never formats the file in place",
"gofmt normally exits 0 even when formatting changes are needed, so consumers must inspect stdout rather than exit_code alone",
"checks only the supplied path and does not discover Go packages or recursively walk a project",
"returns unparsed listing/diff text with result=null, uses a fixed 120-second timeout, and applies no output truncation"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope containing raw gofmt list/diff stdout and process metadata; the Go source file is not modified.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "go-gofmt-check-only-diff",
"intent_tags": [
"check whether a Go file matches gofmt",
"preview gofmt changes as a diff"
],
"negative_intents": [
"apply gofmt or rewrite Go source files",
"run Go tests coverage builds or compilation",
"lint Go semantics or inspect an entire project recursively"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/go_fmt_checker.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://go.dev",
"license": "BSD",
"backed_by": "gofmt",
"recognized_public_tool": true,
"source_hash": "sha256:1ac522c41a48226b0c7330e6591e13551f830ce90173cb3ff044e8e0eff7e8c8",
"local_implementation_uri": "file://Pool/resources/tools/script/go_fmt_checker.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"go",
"code_quality",
"formatting"
]
},
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope containing raw gofmt list/diff stdout and process metadata; the Go source file is not modified.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [
{
"name": "go1.22.5",
"version": "image-locked",
"required": true
}
],
"commands": [
"gofmt"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.go_test_coverage.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Run `go test -cover ./...` from a Go project path and return combined textual test and per-package coverage output",
"description": "Uses a supplied directory as the working directory or a supplied file's parent, then compiles and runs all recursively matched Go packages with basic coverage reporting. It returns nonblank stdout/stderr lines and a passed boolean, but no coverage profile or parsed metrics.",
"core_primitives": [
"run_recursive_go_tests_with_cover",
"capture_per_package_coverage_text",
"report_go_test_pass_boolean"
],
"problem_space": "Execution of recursive Go package tests with basic `-cover` text; not static coverage analysis, coverprofile generation, line-level uncovered-code mapping, structured metric extraction, or a no-execution report reader.",
"domain_tags": [
"Go",
"testing",
"software-engineering"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"go executable and a compatible Go toolchain",
"project dependencies and any runtime services required by the tests"
],
"io_signature": "Input: one required existing Go project directory or file whose parent becomes the working directory; output: JSON with Go's exit code, pass boolean, and combined nonblank stdout/stderr lines.",
"accepted_inputs": [
"an existing Go module or package directory from which `go test -cover ./...` can run",
"an existing file path whose parent directory should be used as the Go test working directory"
],
"output_shape": "After any completed Go process: {status: \"success\", tool: \"go test\", target: string, exit_code: integer, passed: boolean, output: string[]}; output is nonblank lines from stdout followed by stderr, and passed is true only for exit_code 0. The wrapper itself exits 0 even for failed tests or Go command errors. Non-existing input: {status: \"error\", message: string} and exit 2. Missing argument prints usage to stderr and exits 1 without JSON. Missing Go executable, 300-second timeout, and other subprocess exceptions are uncaught and may produce a traceback.",
"limitations": [
"always runs `go test -cover ./...` with no package selection, test filter, count, race, tags, covermode, coverpkg, timeout, or passthrough flags",
"does not create a coverprofile or parse package percentages into structured coverage metrics or identify uncovered lines",
"always emits status=success after a completed subprocess and does not propagate nonzero Go exits; consumers must inspect passed and exit_code",
"executes project test code and compilation, may populate Go caches or trigger test-defined side effects, combines stdout before stderr, and has a fixed 300-second subprocess timeout"
],
"artifact_input": [
"proj_dir"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "proj_dir",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON run summary with working directory, Go exit code, pass flag, and combined textual `go test -cover ./...` output; no coverprofile is produced.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "go-recursive-test-execution-with-basic-cover-text",
"intent_tags": [
"run recursive Go tests with basic package coverage",
"collect go test -cover output for all packages"
],
"negative_intents": [
"generate or analyze a Go coverprofile",
"run Go tests without coverage or with custom test flags",
"statically inspect Go formatting source or uncovered lines without executing tests"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/go_test_coverage.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://go.dev",
"license": "BSD",
"backed_by": "go test coverage",
"recognized_public_tool": true,
"source_hash": "sha256:5c8ca2be17ee6903fdd864b89fabbf48559ceb9c761702eaa3ac9d06c50645fe",
"local_implementation_uri": "file://Pool/resources/tools/script/go_test_coverage.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": false
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"Go",
"testing",
"software-engineering"
]
},
"input_contract": [
{
"name": "proj_dir",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON run summary with working directory, Go exit code, pass flag, and combined textual `go test -cover ./...` output; no coverprofile is produced.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [
{
"name": "go1.22.5",
"version": "image-locked",
"required": true
}
],
"commands": [
"go"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.go_test_runner.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Run the default recursive `go test ./...` command from one Go project path",
"description": "Uses a supplied directory as the working directory or an existing file's parent, then compiles and executes tests for all recursively matched Go packages. It captures raw stdout/stderr and treats only Go exit code 0 as success.",
"core_primitives": [
"run_recursive_go_tests",
"select_go_project_working_directory",
"capture_go_test_process_output"
],
"problem_space": "Default recursive Go package test execution; not coverage collection, test-result parsing, single-test selection, formatting, static analysis, or arbitrary Go command execution.",
"domain_tags": [
"golang",
"testing",
"automation"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"go"
],
"io_signature": "Input: one required existing Go project directory or file whose parent becomes cwd; output: JSON process envelope with actual Go exit code and full raw stdout/stderr.",
"accepted_inputs": [
"an existing Go module or package directory from which `go test ./...` can run",
"an existing file path whose parent directory should be used as the Go test working directory"
],
"output_shape": "Passing run: {status: \"success\", tool: \"go\", target: string, exit_code: 0, result: null, stdout: string, stderr: string|null}. Failed tests, compilation failures, or other nonzero Go results use the same keys with status=\"tool_error\" and propagate Go's actual exit code. Non-existing input, missing Go executable, or 300-second timeout: {status: \"error\", tool: \"go\", message: string}, exiting 2/3/4. Missing argument prints usage to stderr and exits 1 without JSON.",
"limitations": [
"always runs `go test ./...` with no package selection, test name filter, count, race, tags, timeout, verbosity, JSON, or passthrough flags",
"does not enable coverage or parse tests into structured cases; result is null and output remains raw stdout/stderr",
"a supplied file is not tested individually and only selects its parent as cwd",
"executes project code and compilation, may populate Go caches or trigger test-defined side effects, uses a fixed 300-second timeout, and does not truncate output"
],
"artifact_input": [
"proj_dir"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "proj_dir",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON process envelope for recursive `go test ./...`, containing target, actual exit code, and full raw stdout/stderr without coverage metrics.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "go-default-recursive-test-runner",
"intent_tags": [
"run all recursive Go package tests",
"execute the default go test ./... command"
],
"negative_intents": [
"collect Go test coverage or generate a coverprofile",
"run a selected Go test or pass custom test flags",
"format lint build or statically inspect Go source without running tests"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/go_test_runner.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://go.dev",
"license": "BSD",
"backed_by": "go test",
"recognized_public_tool": true,
"source_hash": "sha256:55b67312ed3f9297e50dab3941409c5079e2aaaf44a4e147cd6ac915849242fa",
"local_implementation_uri": "file://Pool/resources/tools/script/go_test_runner.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": false
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"golang",
"testing",
"automation"
]
},
"input_contract": [
{
"name": "proj_dir",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON process envelope for recursive `go test ./...`, containing target, actual exit code, and full raw stdout/stderr without coverage metrics.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [
{
"name": "go1.22.5",
"version": "image-locked",
"required": true
}
],
"commands": [
"go"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.graphql_schema_validator.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Attempt to build one GraphQL SDL schema and structurally report success or caught GraphQLError syntax/build failures",
"description": "Reads an existing UTF-8 SDL file and attempts `graphql.build_schema`. A successful build returns non-introspection type-map names; a caught GraphQLError returns valid=false and exits 1. Other build failures such as TypeError from SDL semantic validation are not caught and produce a traceback instead of the structured validity result.",
"core_primitives": [
"attempt_graphql_sdl_schema_build",
"report_caught_graphqlerror_build_failure",
"list_non_introspection_type_names"
],
"problem_space": "Best-effort local graphql-core schema build with structured success and GraphQLError reporting; not comprehensive SDL semantic validity checking because TypeError and other exceptions escape, and not query validation, remote endpoint inspection, resolver testing, or schema execution.",
"domain_tags": [
"graphql",
"validation",
"schema"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"graphql-core"
],
"io_signature": "Input: one required existing UTF-8 GraphQL SDL file; output: JSON with valid=true plus type_count/types, or valid=false plus a GraphQLError string.",
"accepted_inputs": [
"an existing UTF-8 text file containing GraphQL Schema Definition Language accepted by graphql-core build_schema"
],
"output_shape": "Valid schema: {status: \"success\", tool: \"graphql-core\", target: string, valid: true, type_count: integer, types: string[]}; types contains every schema.type_map key not beginning `__`. Caught GraphQLError: {status: \"success\", tool: \"graphql-core\", target: string, valid: false, error: string}, followed by exit 1. Non-existing path: {status: \"error\", message: string} and exit 2. Missing argument prints usage to stderr and exits 1 without JSON. File open/UTF-8 decoding errors and non-GraphQLError exceptions are uncaught and may produce a traceback.",
"limitations": [
"only GraphQLError is caught around build_schema; SDL semantic validation failures raised as TypeError or other exception classes produce an unstructured traceback, so this is not a comprehensive SDL validity validator",
"does not validate GraphQL query or mutation documents, variables, resolver implementations, directive runtime behavior, or server responses",
"does not perform remote introspection, federation composition, schema diffing, formatting, code generation, or file modification",
"the returned type list excludes only names beginning `__` and can include built-in scalar or schema-support types, not solely caller-declared business types",
"reads the entire file with UTF-8 and has no explicit timeout, size limit, or output truncation"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON GraphQL SDL build result with valid/type metadata or a caught GraphQLError; the schema file is not modified.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "graphql-sdl-build-attempt-graphqlerror-reporting",
"intent_tags": [
"attempt to build GraphQL SDL and report caught GraphQLError failures",
"inspect non-introspection types after a successful SDL schema build"
],
"negative_intents": [
"perform comprehensive GraphQL SDL semantic validation",
"validate GraphQL queries operations variables or resolver behavior",
"inspect or validate a remote GraphQL endpoint",
"format rewrite generate code from or diff a GraphQL schema"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/graphql_schema_validator.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/graphql-python/graphql-core",
"license": "MIT",
"backed_by": "GraphQL SDL validation via graphql-core",
"recognized_public_tool": true,
"source_hash": "sha256:0236360e8c03b49dbe87f9232b90d04599888a0fb808595819e0470a4aea0419",
"local_implementation_uri": "file://Pool/resources/tools/script/graphql_schema_validator.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"graphql",
"validation",
"schema"
]
},
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON GraphQL SDL build result with valid/type metadata or a caught GraphQLError; the schema file is not modified.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "graphql-core",
"version": "==3.2.5",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.html_to_markdown_converter.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Convert one UTF-8 HTML file to an ATX-heading Markdown string returned inside JSON",
"description": "Reads an existing HTML file, calls python-markdownify with fixed `heading_style=\"ATX\"`, and emits the converted Markdown under the `markdown` key. It does not write a Markdown file or fetch HTML from a URL.",
"core_primitives": [
"read_utf8_html_file",
"convert_html_with_markdownify",
"return_atx_markdown_string"
],
"problem_space": "In-memory Markdown rendering from one local HTML file using markdownify defaults plus ATX headings; not web fetching, HTML sanitization, DOM extraction, layout preservation, or persistent document conversion.",
"domain_tags": [
"text-processing",
"format-conversion",
"programming-tools"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"python-markdownify"
],
"io_signature": "Input: one required existing UTF-8 HTML file path; output: JSON object containing the converted Markdown string under `markdown` or a structured missing-path error.",
"accepted_inputs": [
"an existing UTF-8 text file containing HTML accepted by python-markdownify"
],
"output_shape": "Success: {status: \"success\", tool: \"markdownify\", target: string, markdown: string}. Non-existing path: {status: \"error\", message: string} and exit 2. Missing argument prints usage to stderr and exits 1 without JSON. File open, UTF-8 decoding, parser, or conversion exceptions are uncaught and may produce a traceback rather than JSON.",
"limitations": [
"uses markdownify defaults with only heading_style fixed to ATX; callers cannot configure bullets, wrapping, stripping, conversion options, or custom converters",
"does not fetch URLs, execute browser rendering, process external resources, or preserve visual layout and CSS presentation",
"does not sanitize untrusted HTML or guarantee safe Markdown links/content and should not be treated as a security filter",
"reads and returns the entire document in memory without an explicit timeout, size limit, or output truncation and does not write a .md file"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON object containing the converted ATX-style Markdown string under `markdown`, along with tool and target metadata.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "local-html-file-to-markdown-json",
"intent_tags": [
"convert a local HTML file to Markdown text",
"render HTML as ATX-heading Markdown with markdownify"
],
"negative_intents": [
"fetch a web page or convert a URL",
"sanitize HTML or assess its security",
"write a Markdown file or preserve browser layout and CSS"
],
"dependency_slots": []
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/matthewwithanm/python-markdownify",
"license": "MIT",
"backed_by": "markdownify",
"recognized_public_tool": true,
"source_hash": "sha256:d4108e2f244c3b8f54f720d874e2ed3d7a8355fd9b4c58c58d8cd20ee58f1c09",
"local_implementation_uri": "file://Pool/resources/tools/script/html_to_markdown_converter.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/html_to_markdown_converter.py",
"execution_status": "active"
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"text-processing",
"format-conversion",
"programming-tools"
]
},
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON object containing the converted ATX-style Markdown string under `markdown`, along with tool and target metadata.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "markdownify",
"version": "==0.14.1",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.http_headers_security_auditor.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Fetch one URL and report presence of six fixed HTTP security response headers",
"description": "Prefixes scheme-less input with HTTPS, performs a redirect-following GET, and reports which of six recognized header names are present at the final response. The score is only a presence count and does not validate header values or security effectiveness.",
"core_primitives": [
"fetch_http_response_with_redirects",
"check_fixed_security_header_presence",
"count_present_security_headers"
],
"problem_space": "Coarse single-response inventory of six HTTP security header names; not policy-value validation, vulnerability certification, TLS auditing, CORS analysis, browser behavior simulation, or comprehensive web security testing.",
"domain_tags": [
"network-security",
"web-development",
"security-audit"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"requests",
"network access to the target and redirect destinations"
],
"io_signature": "Input: one required HTTP(S) URL or scheme-less host/path string; output: JSON with final URL, HTTP status, fixed present/missing header sets, and a presence-count score, or a request error.",
"accepted_inputs": [
"an absolute http:// or https:// URL",
"a scheme-less host or host/path string that should be fetched over https://"
],
"output_shape": "Successful HTTP exchange, including 4xx/5xx: {status: \"success\", tool: \"requests\", url: string, status_code: integer, present_security_headers: object, missing_security_headers: string[], score: string}; url is the final response URL, present values are raw strings, and score is `<present count>/6`. Request failure: {status: \"error\", tool: \"requests\", url: string, message: string} and exit 1. Missing argument prints usage to stderr and exits 1 without JSON.",
"limitations": [
"checks presence only for Strict-Transport-Security, Content-Security-Policy, X-Frame-Options, X-Content-Type-Options, Referrer-Policy, and Permissions-Policy; values are not parsed or judged",
"the score is a six-header presence ratio, not a security grade, vulnerability result, compliance decision, or proof of browser protection",
"performs a GET with redirects enabled and Requests' default full-response download behavior; there is no method, request-header, redirect-count, body-size, or target-network restriction",
"uses a 20-second Requests timeout rather than a guaranteed total deadline, treats HTTP error statuses as successful exchanges, and does not inspect CORS or TLS configuration"
],
"artifact_input": [
"url"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "url",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON presence inventory for six fixed security headers at the final GET response URL, with HTTP status and a non-semantic count score.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "http-fixed-security-header-presence-audit",
"intent_tags": [
"check whether common HTTP security headers are present",
"inventory six fixed security headers from a URL response"
],
"negative_intents": [
"prove header policies are valid secure or exploitable",
"inspect CORS headers or send a preflight OPTIONS request",
"audit TLS certificates ciphers application vulnerabilities or full web compliance"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/http_headers_security_auditor.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://requests.readthedocs.io",
"license": "Apache-2.0",
"backed_by": "HTTP security-header audit via requests",
"recognized_public_tool": true,
"source_hash": "sha256:a9f202353f9aa3da7f24d69f32731054835218de453b2d6ffc7ea1de6c1056f7",
"local_implementation_uri": "file://Pool/resources/tools/script/http_headers_security_auditor.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": false
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"network-security",
"web-development",
"security-audit"
]
},
"input_contract": [
{
"name": "url",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON presence inventory for six fixed security headers at the final GET response URL, with HTTP status and a non-semantic count score.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "requests",
"version": "==2.32.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.httpx_request.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Perform a bounded read-only HTTP request with HTTPX 0.28.1",
"description": "Thin SGAR adapter over upstream HTTPX for GET or HEAD requests with explicit timeout, redirect, public-host and response-size controls.",
"domain_tags": [
"web",
"http",
"retrieval"
],
"core_primitives": [
"http_get_or_head",
"capture_http_response",
"bound_response_size"
],
"problem_space": "Low-level retrieval of a caller-specified public HTTP(S) URL; not web search, browser automation, authentication workflows, uploads, or mutation."
},
"constraint": {
"io_signature": "Input method GET|HEAD, public http(s) URL and optional bounds; output JSON status, final URL, status code, headers, decoded body, and redirect chain.",
"accepted_inputs": [
"absolute public HTTP or HTTPS URL",
"GET or HEAD method"
],
"output_shape": "JSON response envelope with bounded body text and redirect chain or explicit error.",
"limitations": [
"denies private, loopback, link-local, and reserved resolved addresses by default",
"allows only GET and HEAD",
"maximum response body is 10 MB",
"does not provide search, HTML extraction, browser execution, credentials, proxy controls, uploads, or arbitrary headers"
],
"operation_kinds": [
"network_read"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "method",
"kind": "string",
"required": true,
"values": [
"GET",
"HEAD"
],
"cli_position": 1
},
{
"name": "url",
"kind": "string",
"required": true,
"cli_position": 2
},
{
"name": "timeout_ms",
"kind": "integer",
"required": false,
"cli_flag": "--timeout-ms",
"default": 15000,
"minimum": 1,
"maximum": 120000,
"description": "Request timeout in milliseconds."
},
{
"name": "max_bytes",
"kind": "integer",
"required": false,
"cli_flag": "--max-bytes",
"default": 1000000,
"minimum": 1,
"maximum": 10000000,
"description": "Maximum response body bytes; increase when response_too_large is observed."
},
{
"name": "follow_redirects",
"kind": "boolean",
"required": false,
"cli_flag": "--follow-redirects",
"cli_value_mode": "flag",
"default": false,
"description": "Follow HTTP redirects when true."
}
],
"output_contract": {
"artifact_type": "json",
"description": "Bounded HTTP response envelope.",
"json_schema": {
"oneOf": [
{
"type": "object",
"properties": {
"status": {
"const": "success"
},
"tool": {
"const": "httpx"
},
"url": {
"type": "string",
"minLength": 1
},
"http_status": {
"type": "integer",
"minimum": 100,
"maximum": 399
},
"headers": {
"type": "object",
"additionalProperties": {
"type": "string"
}
},
"body": {
"type": "string"
},
"redirect_chain": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"status",
"tool",
"url",
"http_status",
"headers",
"body",
"redirect_chain"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"status": {
"const": "error"
},
"tool": {
"const": "httpx"
},
"reason_code": {
"type": "string",
"minLength": 1
},
"url": {
"type": "string"
},
"http_status": {
"type": "integer",
"minimum": 400,
"maximum": 599
},
"headers": {
"type": "object",
"additionalProperties": {
"type": "string"
}
},
"body": {
"type": "string"
},
"redirect_chain": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"status",
"tool",
"reason_code"
],
"additionalProperties": false
}
]
},
"result_status": {
"payload_path": "status",
"success_values": [
"success"
],
"failure_values": [
"error"
]
}
}
},
"routing": {
"family": "bounded-http-client",
"intent_tags": [
"fetch a known public URL",
"inspect HTTP status and headers"
],
"negative_intents": [
"search the web",
"interact with a browser",
"upload or mutate remote state"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/httpx_request.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 250,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/encode/httpx/tree/0.28.1",
"version": "0.28.1",
"license": "BSD-3-Clause",
"license_url": "https://github.com/encode/httpx/blob/0.28.1/LICENSE.md",
"license_sha256": "4ec59d544f12b5f539a3a716fd321ac58ccd8030b465221f2c880200cdf28d8d",
"upstream_artifact": "https://files.pythonhosted.org/packages/source/h/httpx/httpx-0.28.1.tar.gz",
"upstream_artifact_sha256": "75e98c5f16b0f35b567856f597f06ff2270a374470a5c2392242528e3e3e42fc",
"backed_by": "HTTPX",
"recognized_public_tool": true,
"source_hash": "sha256:8bc490c4a7d21b69cf7dc4c98778ca69a04c91525bb8480282b293d95033bc90",
"local_implementation_uri": "file://Pool/resources/tools/script/httpx_request.py"
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": false
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "httpx",
"version": "==0.28.1",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.hypothesis_annotation.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Create a source-linked Hypothesis annotation with quote and position selectors",
"description": "SGAR adapter over upstream Hypothesis annotation API. It preserves source URI and TextQuoteSelector fields; no quote extraction or annotation semantics are implemented by SGAR.",
"domain_tags": [
"research",
"evidence",
"provenance"
],
"core_primitives": [
"bind_annotation_to_source_uri",
"record_text_quote_selector",
"return_annotation_metadata"
],
"problem_space": "Evidence-fragment location and annotation metadata for a source URI; not web search, webpage capture, citation normalization, or cryptographic snapshotting."
},
"constraint": {
"io_signature": "Input source URI, exact quote and optional prefix/suffix; output upstream annotation JSON.",
"accepted_inputs": [
"source URI and evidence quote"
],
"output_shape": "JSON annotation receipt with target selectors and upstream identifiers.",
"limitations": [
"requires a reachable Hypothesis-compatible service",
"hosted Hypothesis writes may require an API token",
"local/self-hosted read-only or anonymous policy is deployment-specific",
"does not itself hash or archive source content"
],
"operation_kinds": [
"network_annotation_write"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "uri",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "quote",
"kind": "string",
"required": false
}
],
"output_contract": {
"artifact_type": "json",
"description": "Source-linked annotation and selector receipt.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "evidence-quote-location",
"intent_tags": [
"locate an evidence quote in a source",
"create source-linked annotation",
"record TextQuoteSelector"
],
"negative_intents": [
"fetch and archive a page",
"search the web",
"normalize citation metadata"
]
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/hypothesis_annotation.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 500,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/hypothesis/h/tree/v0.39.0",
"version": "v0.39.0",
"license": "BSD-3-Clause",
"license_url": "https://github.com/hypothesis/h/blob/v0.39.0/LICENSE",
"license_sha256": "34dacbf7c2ae9fd5e8387ecc39b3c273b89600ec467ad4b90fc3850d18162d0e",
"backed_by": "Hypothesis h",
"recognized_public_tool": true,
"native_network_access": true,
"credential_class": "REQUIRED_LOCAL",
"credential_env_names": [
"HYPOTHESIS_API_TOKEN"
],
"third_party_account_required": false,
"paid_service_required": false,
"source_hash": "sha256:089e1116150f295feadd93004f43d6729d96ea3f6bd443251699a3ebbc099466",
"local_implementation_uri": "file://Pool/resources/tools/script/hypothesis_annotation.py"
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "httpx",
"version": "==0.28.1",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"network_required": true,
"env_vars": [
"HYPOTHESIS_API_TOKEN",
"HYPOTHESIS_API_URL"
],
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.jest_test_runner.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Run the project's default Jest suite with `jest --json` from a supplied project path",
"description": "Uses a directory as the Jest working directory or an existing file's parent, then invokes the PATH-resolved Jest executable with only `--json`. It parses Jest's native JSON result and treats exit codes 0 and 1 as completed test runs.",
"core_primitives": [
"run_default_jest_suite",
"select_jest_project_working_directory",
"parse_jest_native_json_result"
],
"problem_space": "Default JavaScript/TypeScript Jest suite execution with native JSON reporting; not arbitrary npm test execution, Vitest, test-file targeting, coverage collection, snapshot updating, or non-executing result parsing.",
"domain_tags": [
"JavaScript",
"testing",
"automation"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"node.js >= 12",
"jest executable available directly on PATH",
"project dependencies and Jest configuration required by the test suite"
],
"io_signature": "Input: one required existing project directory or file whose parent becomes cwd; output: JSON execution envelope containing parsed Jest native JSON plus exit and stream metadata.",
"accepted_inputs": [
"an existing JavaScript or TypeScript project directory configured for direct `jest --json` execution",
"an existing file path whose parent directory should be used as cwd; the file itself is not passed as a Jest test filter"
],
"output_shape": "Completed test run (Jest exit 0 or 1): {status: \"success\", tool: \"jest\", target: string, exit_code: 0|1, result: object|array|null, stdout: string|null, stderr: string|null}; parsed native JSON from the first valid stdout/stderr stream is stored in result and stdout becomes null. Other Jest exits use the same keys with status=\"tool_error\" and propagate the actual exit code. Non-existing input, missing Jest executable, or 180-second timeout: {status: \"error\", tool: \"jest\", message: string}, exiting 2/3/4. Missing argument prints usage to stderr and exits 1 without JSON.",
"limitations": [
"always runs direct `jest --json` with no test path/pattern, project, config, runInBand, coverage, watch, cache, environment, worker, or passthrough options",
"a supplied file only selects its parent cwd and is not targeted as the test file",
"requires a `jest` executable directly on PATH and does not invoke npm, yarn, pnpm, npx, or a package.json script",
"executes project test code and may use or write Jest caches or trigger test-defined side effects; it uses a fixed 180-second timeout and applies no wrapper truncation"
],
"artifact_input": [
"proj_dir"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "proj_dir",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope containing parsed native `jest --json` results, target, actual exit code, and remaining stream metadata.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "javascript-jest-default-json-test-runner",
"intent_tags": [
"run a project's default Jest test suite",
"execute Jest and obtain native JSON test results"
],
"negative_intents": [
"run Vitest npm test or a generic package script",
"target one Jest test file or pass custom Jest flags",
"collect Jest coverage or update snapshots"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/jest_test_runner.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://jestjs.io",
"license": "MIT",
"backed_by": "Jest",
"recognized_public_tool": true,
"source_hash": "sha256:dc1f5984900ac2ab4dea0d25a0fc25d6392f22b22053253ab90621381870385d",
"local_implementation_uri": "file://Pool/resources/tools/script/jest_test_runner.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": false
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"JavaScript",
"testing",
"automation"
]
},
"input_contract": [
{
"name": "proj_dir",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope containing parsed native `jest --json` results, target, actual exit code, and remaining stream metadata.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [
{
"name": "jest",
"version": "==30.4.2",
"required": true
}
],
"system_packages": [],
"commands": [
"jest"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.json_jq_query_executor.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Run one jq filter against a local JSON file and return parsed or raw output",
"description": "Directly invokes the argv vector `[\"jq\", jq_filter, file_path]` with the filter defaulting to `.`. There is no `--` option terminator, so a value beginning with `-` can be interpreted by jq as a command-line option rather than a filter. The wrapper parses stdout only when the entire stream is one non-null JSON document.",
"core_primitives": [
"execute_jq_filter_on_json_file",
"parse_single_json_stdout_document",
"preserve_multi_value_jq_output_as_text"
],
"problem_space": "Direct jq argv execution for ordinary non-option filter strings over one local JSON file; not safe jq option isolation, filter sandboxing, JSON file mutation, guaranteed structured multi-result collection, schema validation, or generic shell execution.",
"domain_tags": [
"data_analysis",
"json",
"scripting"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"jq executable"
],
"io_signature": "Input: required existing JSON file path and optional jq_filter string defaulting to `.`; output: one non-null JSON value is placed in structured result with stdout=null, while a single JSON null yields result=null with raw stdout retained, and empty or multi-document/multi-value output also retains raw stdout.",
"accepted_inputs": [
"an existing JSON file readable by jq",
"an optional ordinary jq program string that does not begin with `-`; omission uses `.`, while option-looking strings cannot be passed safely because the script provides no `--` separator"
],
"output_shape": "Successful jq exit 0: {status: \"success\", tool: \"jq\", target: string, exit_code: 0, result: any JSON value|null, stdout: string|null, stderr: string|null}. If stdout is exactly one non-null JSON document, result contains that value and stdout=null. If the single JSON document is null, json.loads succeeds but the helper cannot distinguish it from its parsed=None sentinel, so result=null and the original stdout (normally `null\\n`) is retained. Empty, multi-value, or otherwise non-single-document stdout also yields result=null with raw stdout retained. Nonzero jq result uses the same keys with status=\"tool_error\" and propagates jq's exit code. Non-existing file, missing executable, or 120-second timeout: {status: \"error\", tool: \"jq\", message: string}, exiting 2/3/4. Missing file argument prints usage to stderr and exits 1 without JSON.",
"limitations": [
"passes `[jq, jq_filter, file_path]` directly with no `--` option terminator; a jq_filter beginning with `-` may be consumed as an option such as `--version`, so command-line options or option-looking filters cannot be passed safely",
"multiple jq output values are not collected into an array and remain raw stdout with result=null; a single JSON null is also returned as result=null with `null\\n` retained because the helper uses None as both the parsed value and no-parse sentinel",
"jq false or null results still use jq's default exit behavior because `-e` is absent; consumers must inspect result rather than assume truthiness from exit 0",
"jq programs can read changing process state through builtins such as `now`, `env`, and `$ENV`, so output is not deterministic; the wrapper does not sandbox filters, has a fixed 120-second timeout, applies no output-size truncation, and does not modify the source file"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "jq_filter",
"kind": "string",
"required": false,
"default": ".",
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope containing a single parsed jq JSON value when possible, otherwise raw jq stdout, plus exit and stderr metadata.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "json-file-jq-filter-execution",
"intent_tags": [
"query or transform a JSON file with jq",
"run a jq filter and capture its output"
],
"negative_intents": [
"modify overwrite or persist changes to a JSON file",
"guarantee a structured array for multiple jq output values",
"pass jq command-line options safely",
"validate JSON against a schema or execute arbitrary shell commands"
],
"dependency_slots": []
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://jqlang.github.io/jq",
"license": "MIT",
"backed_by": "jq",
"recognized_public_tool": true,
"source_hash": "sha256:ef630fe611fb198ecbf7c3ecfbfe7a9473c2dc66caea2b5ca7e60cc2b7bba22d",
"local_implementation_uri": "file://Pool/resources/tools/script/json_jq_query_executor.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": false
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/json_jq_query_executor.py",
"execution_status": "active"
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"data_analysis",
"json",
"scripting"
]
},
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "jq_filter",
"kind": "string",
"required": false,
"default": ".",
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope containing a single parsed jq JSON value when possible, otherwise raw jq stdout, plus exit and stderr metadata.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [
{
"name": "jq",
"version": "image-locked",
"required": true
}
],
"commands": [
"jq"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.json_to_toml_converter.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Convert one local JSON object to TOML text in a JSON envelope",
"description": "Reads one UTF-8 JSON file, requires its root to be an object, serializes it with tomli-w, and returns the TOML text in the `toml` field without writing a file.",
"core_primitives": [
"parse_local_json_file",
"serialize_json_object_as_toml",
"return_toml_text_in_json_envelope"
],
"problem_space": "In-memory JSON-object-to-TOML text conversion for a single local file; not TOML file creation, arbitrary JSON-root conversion, TOML parsing, or round-trip preservation.",
"domain_tags": [
"configuration_management",
"data_format_conversion"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"tomli-w Python package"
],
"io_signature": "Input: required file_path string naming an existing UTF-8 JSON file whose root is an object. Output: a JSON envelope containing TOML text or a structured handled error; the source is not modified and no TOML file is created.",
"accepted_inputs": [
"an existing UTF-8 JSON file with an object at the document root"
],
"output_shape": "Success: {status: \"success\", tool: \"tomli-w\", target: string, toml: string}, exit 0. Missing path: {status: \"error\", message: string}, exit 2. Non-object root: {status: \"error\", message: \"TOML root must be a JSON object\"}, exit 1. JSON syntax failure: {status: \"error\", tool: \"tomli-w\", message: string}, exit 1. Missing argument prints usage to stderr and exits 1 without JSON; unsupported values or read/serialization failures may traceback.",
"limitations": [
"returns TOML only as a string inside JSON and never creates or modifies a TOML file",
"requires a JSON object root; JSON null, arrays, and scalar roots are rejected, while TOML-incompatible nested values may raise an uncaught serialization error",
"uses UTF-8 input, has no timeout or output truncation, and does not preserve JSON formatting or comments"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "file_path",
"kind": "file_path",
"artifact_types": [
"json"
],
"extensions": [
".json"
],
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing generated TOML text or a handled conversion error; no output file is written.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "json-object-to-toml-text-conversion",
"intent_tags": [
"convert a JSON object file to TOML text",
"serialize local JSON configuration as TOML"
],
"negative_intents": [
"write or modify a TOML file",
"convert JSON arrays or scalar roots to TOML",
"parse TOML or convert TOML to JSON"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/json_to_toml_converter.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/hukkin/tomli-w",
"license": "MIT",
"backed_by": "tomli-w",
"recognized_public_tool": true,
"source_hash": "sha256:c532eeb68fd666be8b6cf181a76d616b14324b7d2c52f1fd36569d23b3a14614",
"local_implementation_uri": "file://Pool/resources/tools/script/json_to_toml_converter.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"configuration_management",
"data_format_conversion"
]
},
"input_contract": [
{
"name": "file_path",
"kind": "file_path",
"artifact_types": [
"json"
],
"extensions": [
".json"
],
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing generated TOML text or a handled conversion error; no output file is written.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "tomli_w",
"version": "image-locked",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.json_to_yaml.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Convert one local JSON document to YAML text in a JSON envelope",
"description": "Reads one UTF-8 JSON file, parses any valid JSON root, serializes it with PyYAML safe_dump using Unicode and insertion-order keys, and returns the YAML text without writing a file.",
"core_primitives": [
"parse_local_json_file",
"serialize_json_value_as_yaml",
"return_yaml_text_in_json_envelope"
],
"problem_space": "One-way conversion of a local JSON document into YAML text for downstream consumption; not YAML file creation, YAML parsing, schema validation, or round-trip formatting preservation.",
"domain_tags": [
"data_format_conversion",
"software_development"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"PyYAML Python package"
],
"io_signature": "Input: required file_path string naming an existing UTF-8 JSON document. Output: JSON envelope with generated YAML text or handled path/JSON syntax error; no file is written.",
"accepted_inputs": [
"an existing UTF-8 file containing one valid JSON object, array, scalar, or null document"
],
"output_shape": "Success: {status: \"success\", tool: \"PyYAML\", target: string, yaml: string}, exit 0. Missing path: {status: \"error\", message: string}, exit 2. Invalid JSON: {status: \"error\", tool: \"PyYAML\", message: string}, exit 1. Missing argument prints usage to stderr and exits 1 without JSON; other file I/O failures may traceback.",
"limitations": [
"returns YAML as a string inside JSON and never creates or modifies a YAML file",
"does not validate against a schema or preserve source JSON whitespace, comments, or exact scalar spelling",
"reads UTF-8 with no timeout or output truncation; non-JSON file I/O errors are not converted into the handled error envelope"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing generated YAML text or a handled conversion error; no output file is written.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "json-to-yaml-text-conversion",
"intent_tags": [
"convert a JSON file to YAML text",
"serialize local JSON data as YAML"
],
"negative_intents": [
"write or modify a YAML file",
"parse YAML or convert YAML to JSON",
"validate JSON or YAML against a schema"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/json_to_yaml.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://pyyaml.org",
"license": "MIT",
"backed_by": "PyYAML",
"recognized_public_tool": true,
"source_hash": "sha256:401abc3a9a5b6b8ef1b55ae7ec3cbfa118574522c7ebf41c6a50f53e02b53367",
"local_implementation_uri": "file://Pool/resources/tools/script/json_to_yaml.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"data_format_conversion",
"software_development"
]
},
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing generated YAML text or a handled conversion error; no output file is written.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "PyYAML",
"version": "==6.0.2",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.junit_xml_parser.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Summarize JUnit XML suites and testcase statuses",
"description": "Parses one local XML report with lxml and returns suite attributes plus testcase name, classname, time, and a status inferred from failure, error, or skipped child elements.",
"core_primitives": [
"parse_junit_xml_report",
"extract_testsuite_attributes",
"classify_testcase_status"
],
"problem_space": "Read-only summarization of non-namespaced JUnit/xUnit-style testsuite/testcase tags; XML namespaces can make bare-tag searches return no suites, and recursively nested suites can cause testcase records to be attributed more than once. Not test execution, strict schema validation, or full report extraction.",
"domain_tags": [
"testing-tools",
"software-engineering",
"automated-testing"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"lxml Python package"
],
"io_signature": "Input: required file_path string naming an existing XML report. Output: JSON envelope with a suites array of suite attributes and testcase summaries, or a handled missing-path/XML-syntax error.",
"accepted_inputs": [
"an existing XML file whose root is testsuite or that contains descendant testsuite elements in JUnit/xUnit style"
],
"output_shape": "Success: {status: \"success\", tool: \"lxml\", target: string, suites: [{name: string|null, tests: string|null, failures: string|null, errors: string|null, skipped: string|null, time: string|null, cases: [{name: string|null, classname: string|null, time: string|null, status: \"passed\"|\"failed\"|\"error\"|\"skipped\"}]}]}, exit 0. Missing path: {status: \"error\", message: string}, exit 2. XML syntax failure: {status: \"error\", tool: \"lxml\", message: string}, exit 1. Missing argument prints usage to stderr and exits 1 without JSON; other parser/I/O errors may traceback.",
"limitations": [
"does not validate against a JUnit XML schema and accepts any XML containing testsuite/testcase element names",
"searches literal bare tags `testsuite` and `testcase`; namespace-qualified JUnit XML elements are not matched and can produce an empty suites array",
"uses recursive `s.iter(\"testcase\")` for every discovered suite, so testcases under nested suites can appear both under an ancestor suite and again under their nested suite",
"does not return failure text, error details, skipped reasons, system-out, system-err, properties, or aggregate computed counts",
"uses lxml default parser settings with no explicit DTD/entity hardening, timeout, size cap, or output truncation; it does not modify the report"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing JUnit suite attributes and per-testcase status summaries, or a handled parse error.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "junit-xml-report-summary",
"intent_tags": [
"summarize a JUnit XML test report",
"extract testcase pass fail error and skipped statuses"
],
"negative_intents": [
"run a test suite or rerun failed tests",
"validate JUnit XML against a schema",
"extract failure messages logs or full testcase output"
],
"dependency_slots": []
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://lxml.de",
"license": "BSD",
"backed_by": "JUnit XML report parser via lxml",
"recognized_public_tool": true,
"source_hash": "sha256:a12e69854b590ff55d45bdaab4ad49b16a8617f5c93841eabbbafec9aec3ec5f",
"local_implementation_uri": "file://Pool/resources/tools/script/junit_xml_parser.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/junit_xml_parser.py",
"execution_status": "active"
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"testing-tools",
"software-engineering",
"automated-testing"
]
},
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing JUnit suite attributes and per-testcase status summaries, or a handled parse error.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "lxml",
"version": "==5.3.0",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.lib.beautifulsoup_scrape.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Extract text from local HTML elements matching a CSS selector",
"description": "Reads one UTF-8 local HTML file with BeautifulSoup's html.parser, applies the supplied CSS selector, and returns stripped text for every matching element; direct wrapper invocation falls back to selector p only when the selector argument is omitted.",
"domain_tags": [
"web",
"nlp"
],
"core_primitives": [
"read_local_html_file",
"parse_html_document",
"select_elements_with_css",
"extract_stripped_element_text"
],
"problem_space": "CSS-selector-driven plain-text extraction from elements in one static, file-backed HTML document."
},
"constraint": {
"io_signature": "Inputs: local HTML file path and CSS selector string; output: standard wrapper envelope containing stripped text for all matching elements.",
"accepted_inputs": [
"an existing UTF-8-readable local HTML file path",
"a CSS selector accepted by BeautifulSoup.select; direct wrapper invocation defaults an omitted selector to p although the manifest retains required=true"
],
"output_shape": "Success is an object with status=\"success\", tool=\"lib.beautifulsoup_scrape\", and matches as an array of stripped text strings in selector-match order. A caught file, decoding, parsing, or selector exception produces an object with status=\"error\", tool=\"lib.beautifulsoup_scrape\", and message as the exception string, then exits with code 1.",
"limitations": [
"does not fetch URLs or crawl websites",
"extracts only stripped element text and does not return attributes, markup, DOM nodes, or match locations",
"uses the built-in html.parser and fixed UTF-8 decoding with no caller-selectable parser or encoding",
"does not execute JavaScript or render dynamically generated page content",
"direct wrapper invocation defaults an omitted selector to p even though the manifest input contract declares selector required"
]
},
"io": {
"input_contract": [
{
"name": "html_path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "selector",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Standard JSON envelope containing stripped text from elements matching the supplied CSS selector in one local HTML file.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "local-html-css-text-extraction",
"intent_tags": [
"extract text using a CSS selector from local HTML",
"collect stripped text from matching HTML elements"
],
"negative_intents": [
"crawl or download a web page",
"return element attributes markup or DOM structure",
"render JavaScript-generated HTML content"
]
},
"execution": {
"runtime": "python_library",
"uri": "file://Pool/resources/tools/lib/lib.beautifulsoup_scrape.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://www.crummy.com/software/BeautifulSoup/",
"license": "MIT",
"recognized_public_tool": true,
"source_hash": "sha256:d50db687fa9ff8634e9719729a32a5b458adcff142d6a35c1c35282e7dedfc68",
"local_implementation_uri": "file://Pool/resources/tools/lib/lib.beautifulsoup_scrape.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/lib/_liblib.py": "sha256:dcd68e7904232764172e5f646ff97b854f68f7f916180ae32f838a0acf9ccc77"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "html_path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "selector",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Standard JSON envelope containing stripped text from elements matching the supplied CSS selector in one local HTML file.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "beautifulsoup4",
"version": "==4.12.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.lib.bleach_sanitize.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Sanitize an HTML string with Bleach's default allowlist",
"description": "Passes one caller-supplied HTML string to bleach.clean and returns sanitized HTML with disallowed markup removed or escaped according to the installed Bleach defaults.",
"domain_tags": [
"security",
"web"
],
"core_primitives": [
"sanitize_html_string",
"remove_disallowed_markup",
"preserve_allowed_html"
],
"problem_space": "In-memory cleanup of untrusted HTML before rendering; not a browser, crawler, or policy authoring tool."
},
"constraint": {
"io_signature": "Input: one HTML string; output: JSON object containing clean with the sanitized HTML string.",
"accepted_inputs": [
"a string containing HTML or plain text",
"untrusted markup that should be filtered by Bleach defaults"
],
"output_shape": "Success is an object with status=\"success\", tool=\"lib.bleach_sanitize\", and clean as the sanitized HTML string returned by bleach.clean. A caught sanitization or input exception produces an object with status=\"error\", tool=\"lib.bleach_sanitize\", and message as the exception string, then exits with code 1.",
"limitations": [
"uses the installed Bleach default policy; tags and attributes are not configurable through this wrapper",
"does not parse or return a structured DOM",
"does not guarantee protection for non-HTML contexts such as JavaScript or CSS"
]
},
"io": {
"input_contract": [
{
"name": "html",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "html",
"description": "Sanitized HTML string produced by Bleach's installed default policy."
}
},
"routing": {
"family": "html-security-sanitization",
"intent_tags": [
"sanitize untrusted HTML before rendering",
"remove unsafe markup from an HTML string"
],
"negative_intents": [
"extract text or fields from HTML",
"validate arbitrary security policies",
"sanitize JavaScript or CSS source code"
]
},
"execution": {
"runtime": "python_library",
"uri": "file://Pool/resources/tools/lib/lib.bleach_sanitize.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/mozilla/bleach",
"license": "Apache-2.0",
"backed_by": "bleach_sanitize",
"recognized_public_tool": true,
"source_hash": "sha256:83bc35698a6b466152c5c628eb3f80044fedca9cec7d9da064fe60df84d745c6",
"local_implementation_uri": "file://Pool/resources/tools/lib/lib.bleach_sanitize.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/lib/_liblib.py": "sha256:dcd68e7904232764172e5f646ff97b854f68f7f916180ae32f838a0acf9ccc77"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "html",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "html",
"description": "Sanitized HTML string produced by Bleach's installed default policy."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "bleach",
"version": "==6.2.0",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.lib.chardet_detect.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Detect the probable character encoding of one local file",
"description": "Reads one local file as raw bytes and passes the complete byte sequence to chardet.detect, returning probable encoding, confidence, and language metadata.",
"domain_tags": [
"nlp",
"data"
],
"core_primitives": [
"read_file_bytes",
"infer_character_encoding",
"report_detection_confidence"
],
"problem_space": "Encoding inference for one existing local file; identifies a likely codec but does not transcode or decode the file."
},
"constraint": {
"io_signature": "Input: one local file path; output: JSON object containing the path and chardet detection metadata under result.",
"accepted_inputs": [
"an existing readable local file path",
"binary or text files whose raw bytes can be sampled by chardet"
],
"output_shape": "Success is an object with status=\"success\", tool=\"lib.chardet_detect\", file as the input path string, and result as chardet's detection object containing encoding, confidence, and language keys. A caught file-read or detection exception produces an object with status=\"error\", tool=\"lib.chardet_detect\", and message as the exception string, then exits with code 1.",
"limitations": [
"does not decode or rewrite file contents",
"reads the entire file into memory before detection",
"encoding detection is probabilistic and may be uncertain for short or mixed-encoding files"
]
},
"io": {
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Probable encoding and confidence metadata for one local file.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "file-encoding-inference",
"intent_tags": [
"detect the encoding of a local file",
"identify a probable charset from file bytes"
],
"negative_intents": [
"convert a file from one encoding to another",
"decode file contents into text",
"detect language from text"
]
},
"execution": {
"runtime": "python_library",
"uri": "file://Pool/resources/tools/lib/lib.chardet_detect.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/chardet/chardet",
"license": "LGPL-2.1",
"backed_by": "chardet_detect",
"recognized_public_tool": true,
"source_hash": "sha256:d997b6dd14dfe52ff5a45da650144e79edc6994e26680dbc01d06cd136d0ffaf",
"local_implementation_uri": "file://Pool/resources/tools/lib/lib.chardet_detect.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/lib/_liblib.py": "sha256:dcd68e7904232764172e5f646ff97b854f68f7f916180ae32f838a0acf9ccc77"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Probable encoding and confidence metadata for one local file.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "chardet",
"version": "==5.2.0",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.lib.cryptography_hash_sign.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Compute a SHA-256 digest for one UTF-8 string",
"description": "Encodes the supplied string as UTF-8, hashes it with cryptography's SHA256 implementation, and returns the lowercase hexadecimal digest.",
"domain_tags": [
"security"
],
"core_primitives": [
"encode_utf8",
"compute_sha256_digest",
"format_digest_as_hex"
],
"problem_space": "Deterministic integrity fingerprinting for one text value; this wrapper does not encrypt, sign, verify, or handle binary input directly."
},
"constraint": {
"io_signature": "Input: data string and an operation string; output: JSON object with algorithm SHA256 and digest hex text. The operation argument is accepted but ignored by the implementation.",
"accepted_inputs": [
"a string whose UTF-8 bytes should be hashed",
"any operation string, although only SHA256 hashing is actually performed"
],
"output_shape": "Success is an object with status=\"success\", tool=\"lib.cryptography_hash_sign\", algorithm fixed to \"SHA256\", and digest as the lowercase hexadecimal SHA-256 digest string. A caught encoding or hashing exception produces an object with status=\"error\", tool=\"lib.cryptography_hash_sign\", and message as the exception string, then exits with code 1.",
"limitations": [
"does not encrypt or decrypt data",
"does not create or verify digital signatures",
"always uses SHA-256 regardless of operation value",
"hashes the UTF-8 encoding of text rather than caller-supplied raw bytes"
]
},
"io": {
"input_contract": [
{
"name": "data",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "operation",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "SHA-256 hexadecimal digest for the supplied UTF-8 string.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "text-integrity-hashing",
"intent_tags": [
"calculate a SHA-256 hash of text",
"produce a hexadecimal digest for a string"
],
"negative_intents": [
"encrypt or decrypt data",
"sign or verify a message",
"hash arbitrary binary bytes with a caller-selected algorithm"
]
},
"execution": {
"runtime": "python_library",
"uri": "file://Pool/resources/tools/lib/lib.cryptography_hash_sign.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://cryptography.io/",
"license": "Apache-2.0/BSD",
"recognized_public_tool": true,
"source_hash": "sha256:c7648384669d4b7c996b8fc52d29737901303cc37f8fc04e16a2258a02ca326f",
"local_implementation_uri": "file://Pool/resources/tools/lib/lib.cryptography_hash_sign.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/lib/_liblib.py": "sha256:dcd68e7904232764172e5f646ff97b854f68f7f916180ae32f838a0acf9ccc77"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "data",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "operation",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "SHA-256 hexadecimal digest for the supplied UTF-8 string.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "cryptography",
"version": "==44.0.0",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.lib.dateparser_parse.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Parse one natural-language date expression into an ISO timestamp",
"description": "Passes one text string to dateparser.parse and returns the parsed datetime as an ISO-8601 string, or null when no date can be recognized.",
"domain_tags": [
"nlp",
"time"
],
"core_primitives": [
"interpret_date_expression",
"resolve_calendar_datetime",
"format_iso_timestamp"
],
"problem_space": "Single-expression date and time interpretation; not recurring-schedule extraction or timezone conversion configuration."
},
"constraint": {
"io_signature": "Input: one natural-language text string; output: JSON object echoing text and containing parsed as an ISO datetime string or null.",
"accepted_inputs": [
"a natural-language date or datetime expression",
"an ISO-like date string or other text understood by the installed dateparser settings"
],
"output_shape": "Success is an object with status=\"success\", tool=\"lib.dateparser_parse\", text as the original input string, and parsed as an ISO-8601 datetime string or null when dateparser recognizes no date. A caught parsing exception produces an object with status=\"error\", tool=\"lib.dateparser_parse\", and message as the exception string, then exits with code 1.",
"limitations": [
"uses dateparser defaults with no explicit locale, timezone, or relative-base settings",
"does not return multiple dates from a longer document",
"ambiguous expressions may resolve according to library defaults",
"returns null for unrecognized text rather than a ranked set of candidates"
]
},
"io": {
"input_contract": [
{
"name": "text",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "ISO-8601 representation of the parsed datetime, or null when unrecognized.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "single-date-expression-parsing",
"intent_tags": [
"parse a natural-language date string",
"convert one date expression to an ISO timestamp"
],
"negative_intents": [
"extract every date from a document",
"calculate date differences or durations",
"configure timezone-aware scheduling rules"
]
},
"execution": {
"runtime": "python_library",
"uri": "file://Pool/resources/tools/lib/lib.dateparser_parse.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/scrapinghub/dateparser",
"license": "BSD-3",
"backed_by": "dateparser_parse",
"recognized_public_tool": true,
"source_hash": "sha256:9d39fb980b324a4be118128120e931bc51124f84c78c1025f386cfee59e460d1",
"local_implementation_uri": "file://Pool/resources/tools/lib/lib.dateparser_parse.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/lib/_liblib.py": "sha256:dcd68e7904232764172e5f646ff97b854f68f7f916180ae32f838a0acf9ccc77"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "text",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "ISO-8601 representation of the parsed datetime, or null when unrecognized.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "dateparser",
"version": "==1.2.0",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.lib.detect_secrets.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Count detect-secrets findings per scanned file",
"description": "Runs the detect-secrets CLI scanner against one supplied path and returns a filename-to-count map derived from the scanner's JSON results; secret values and finding metadata are not exposed.",
"domain_tags": [
"security"
],
"core_primitives": [
"invoke_detect_secrets_scan",
"parse_scanner_json",
"count_findings_by_file"
],
"problem_space": "Coarse secret-scanning triage for a file or directory when per-file finding counts are sufficient."
},
"constraint": {
"io_signature": "Input: one filesystem path string; output: JSON success payload whose results object maps each reported filename to its number of findings.",
"accepted_inputs": [
"a file or directory path accepted by the installed detect-secrets scan command"
],
"output_shape": "Success is an object with status=\"success\", tool=\"lib.detect_secrets\", and results as an object mapping each filename reported by detect-secrets to its integer finding count. A caught subprocess launch, timeout, or JSON-decoding exception produces an object with status=\"error\", tool=\"lib.detect_secrets\", and message as the exception string, then exits with code 1.",
"limitations": [
"returns only per-file counts, not secret values, line numbers, plugin names, or full finding records",
"uses the installed detect-secrets CLI and its default scan configuration with a fixed 60-second timeout",
"does not inspect the subprocess exit code or stderr before attempting to parse stdout as JSON",
"invalid JSON output, launch failures, and timeouts are returned through the wrapper's error envelope"
]
},
"io": {
"input_contract": [
{
"name": "path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Per-file detect-secrets finding counts in the results object; no finding details or secret values are included.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "secret-scan-result-counting",
"intent_tags": [
"count potential secrets by file",
"triage a path with detect-secrets"
],
"negative_intents": [
"retrieve secret values or detailed finding metadata",
"sanitize or remove credentials from source files",
"scan text supplied directly without a filesystem path"
]
},
"execution": {
"runtime": "python_library",
"uri": "file://Pool/resources/tools/lib/lib.detect_secrets.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/Yelp/detect-secrets",
"license": "Apache-2.0",
"backed_by": "detect_secrets",
"recognized_public_tool": true,
"source_hash": "sha256:dd0961f6a91394f29243c48812aebd66d6a2ee5c09e9d61327122eac164a9a9d",
"local_implementation_uri": "file://Pool/resources/tools/lib/lib.detect_secrets.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/lib/_liblib.py": "sha256:dcd68e7904232764172e5f646ff97b854f68f7f916180ae32f838a0acf9ccc77"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Per-file detect-secrets finding counts in the results object; no finding details or secret values are included.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.lib.faker_generate.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Generate fixed-shape fake contact records",
"description": "Uses Faker defaults to create a requested number of synthetic records, each containing name, email, and address fields; the declared schema argument is accepted but ignored.",
"domain_tags": [
"data",
"testing"
],
"core_primitives": [
"generate_fake_name",
"generate_fake_email",
"generate_fake_address"
],
"problem_space": "Small synthetic contact datasets for tests or examples that need a fixed name/email/address record shape."
},
"constraint": {
"io_signature": "Inputs: required schema string (ignored) and optional integer-like count string defaulting to 3; output: JSON records array of fake contacts.",
"accepted_inputs": [
"any schema string, retained only for interface compatibility and not interpreted",
"an optional base-10 integer string for the number of records"
],
"output_shape": "Success is an object with status=\"success\", tool=\"lib.faker_generate\", and records as an array whose entries each contain name, email, and address strings. A caught count-conversion or Faker generation exception produces an object with status=\"error\", tool=\"lib.faker_generate\", and message as the exception string, then exits with code 1.",
"limitations": [
"ignores the schema argument and always emits exactly the name, email, and address fields",
"uses Faker's default locale and no caller-supplied seed, so output is not reproducible or locale-configurable",
"count defaults to 3; a negative count yields an empty array and a non-integer count returns an error",
"does not enforce uniqueness or validate relationships among generated fields"
]
},
"io": {
"input_contract": [
{
"name": "schema",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "count",
"kind": "string",
"required": false,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Array of synthetic records with fixed name, email, and address fields.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "fixed-shape-fake-contact-generation",
"intent_tags": [
"generate fake contact records",
"create sample names emails and addresses"
],
"negative_intents": [
"generate records from a caller-defined schema",
"produce deterministic seeded fake data",
"generate localized or unique datasets with validation rules"
]
},
"execution": {
"runtime": "python_library",
"uri": "file://Pool/resources/tools/lib/lib.faker_generate.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://faker.readthedocs.io/",
"license": "MIT",
"recognized_public_tool": true,
"source_hash": "sha256:d4dcd61a4418ecfd502c5fbd4fb6945f4d41636fdae416d4fb8336ecb6cf1ae2",
"local_implementation_uri": "file://Pool/resources/tools/lib/lib.faker_generate.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/lib/_liblib.py": "sha256:dcd68e7904232764172e5f646ff97b854f68f7f916180ae32f838a0acf9ccc77"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "schema",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "count",
"kind": "string",
"required": false,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Array of synthetic records with fixed name, email, and address fields.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "Faker",
"version": "==33.1.0",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.lib.genson_schema.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Infer a JSON Schema from one JSON file",
"description": "Loads one JSON document from disk, adds that document as a single GenSON sample, and returns the inferred schema produced by SchemaBuilder.",
"domain_tags": [
"data",
"json"
],
"core_primitives": [
"load_json_document",
"infer_schema_from_sample",
"serialize_inferred_schema"
],
"problem_space": "Initial JSON Schema inference from one representative JSON value stored in a file."
},
"constraint": {
"io_signature": "Input: path to one JSON file; output: JSON success payload containing the inferred schema object under schema.",
"accepted_inputs": [
"a readable filesystem path containing one valid JSON object, array, scalar, or null value"
],
"output_shape": "Success is an object with status=\"success\", tool=\"lib.genson_schema\", and schema as the JSON Schema object returned by GenSON's SchemaBuilder. A caught file-read, JSON-decoding, or schema-inference exception produces an object with status=\"error\", tool=\"lib.genson_schema\", and message as the exception string, then exits with code 1.",
"limitations": [
"infers from exactly one loaded JSON document and does not merge multiple sample files or records through repeated add_object calls",
"inference reflects observed values and cannot recover undocumented semantic constraints such as formats, ranges, or business rules",
"does not validate the sample against an existing schema",
"missing files, unreadable content, and invalid JSON are returned through the wrapper's error envelope"
]
},
"io": {
"input_contract": [
{
"name": "json_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "GenSON-inferred JSON Schema object derived from the single JSON document.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "single-sample-json-schema-inference",
"intent_tags": [
"infer JSON Schema from a JSON file",
"create a draft schema from one JSON sample"
],
"negative_intents": [
"validate JSON against an existing schema",
"combine multiple sample files into one inferred schema",
"author semantic validation rules not present in sample data"
]
},
"execution": {
"runtime": "python_library",
"uri": "file://Pool/resources/tools/lib/lib.genson_schema.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/wolverdude/GenSON",
"license": "MIT",
"backed_by": "genson_schema",
"recognized_public_tool": true,
"source_hash": "sha256:3979f2bc22c3d1a9c3712394cfe0408cbbd92aa574ac83988d8b38bea5758e29",
"local_implementation_uri": "file://Pool/resources/tools/lib/lib.genson_schema.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/lib/_liblib.py": "sha256:dcd68e7904232764172e5f646ff97b854f68f7f916180ae32f838a0acf9ccc77"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "json_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "GenSON-inferred JSON Schema object derived from the single JSON document.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "genson",
"version": "==1.3.0",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.lib.jinja2_render.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Render one in-memory Jinja2 template with JSON context",
"description": "Constructs a Jinja2 Template directly from the supplied template string and renders it with a JSON object expanded as keyword context, returning the rendered string.",
"domain_tags": [
"docs",
"templating"
],
"core_primitives": [
"parse_json_context",
"compile_inline_template",
"render_template_variables"
],
"problem_space": "One-shot text interpolation and Jinja2 expression rendering from an inline template and JSON object context."
},
"constraint": {
"io_signature": "Inputs: inline template string and JSON object string; output: success payload containing the rendered text under rendered.",
"accepted_inputs": [
"a Jinja2 template supplied directly as text",
"a JSON-encoded object whose top-level members become template variables"
],
"output_shape": "Success is an object with status=\"success\", tool=\"lib.jinja2_render\", and rendered as the Jinja2-rendered string, despite the declared text artifact type. A caught JSON-context, template-compilation, or rendering exception produces an object with status=\"error\", tool=\"lib.jinja2_render\", and message as the exception string, then exits with code 1.",
"limitations": [
"creates an in-memory Template with no configured template loader, so it is not a file-based template rendering pipeline",
"uses Jinja2 defaults, including no automatic HTML escaping and permissive undefined-variable rendering",
"the context must decode to a JSON object because it is expanded with keyword arguments",
"the wrapper supplies an empty-object default if the second CLI argument is absent even though the manifest declares that input required",
"template syntax errors, invalid JSON, and rendering exceptions are returned through the wrapper's error envelope"
]
},
"io": {
"input_contract": [
{
"name": "template",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "context_json",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "text",
"description": "Rendered template string returned in the rendered field of the wrapper response."
}
},
"routing": {
"family": "inline-template-rendering",
"intent_tags": [
"render an inline Jinja2 template",
"interpolate JSON object values into text"
],
"negative_intents": [
"render a template file using a template directory",
"produce automatically HTML-escaped output",
"validate a template without rendering it"
]
},
"execution": {
"runtime": "python_library",
"uri": "file://Pool/resources/tools/lib/lib.jinja2_render.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://jinja.palletsprojects.com/",
"license": "BSD-3",
"recognized_public_tool": true,
"source_hash": "sha256:ccfb6008b92ec59402a2d403c77477cabeca262627feff81de2e71f992649c3d",
"local_implementation_uri": "file://Pool/resources/tools/lib/lib.jinja2_render.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/lib/_liblib.py": "sha256:dcd68e7904232764172e5f646ff97b854f68f7f916180ae32f838a0acf9ccc77"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "template",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "context_json",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "text",
"description": "Rendered template string returned in the rendered field of the wrapper response."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "jinja2",
"version": "image-locked",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.lib.jsonschema_validate.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Validate one JSON file against one JSON Schema file",
"description": "Loads an instance and schema from separate JSON files, calls jsonschema.validate, and reports either valid=true or valid=false with the first validation error message.",
"domain_tags": [
"data",
"validation"
],
"core_primitives": [
"load_json_instance",
"load_json_schema",
"validate_instance_against_schema"
],
"problem_space": "Binary conformance checking of one file-backed JSON instance against one file-backed JSON Schema."
},
"constraint": {
"io_signature": "Inputs: instance JSON file path and schema JSON file path; output: JSON result with valid boolean and, on instance validation failure, an error message.",
"accepted_inputs": [
"a readable file containing any valid JSON instance",
"a readable file containing a JSON Schema accepted by the installed jsonschema library"
],
"output_shape": "A conforming instance produces an object with status=\"success\", tool=\"lib.jsonschema_validate\", and valid=true. A jsonschema.ValidationError is also a success object with the same tool, valid=false, and error as the validation message. Any other caught file, JSON, schema, or library exception produces an object with status=\"error\", tool=\"lib.jsonschema_validate\", and message as the exception string, then exits with code 1.",
"limitations": [
"reports only the first validation failure selected by jsonschema.validate, not a complete iterable of all errors",
"does not expose validation paths, schema paths, contexts, or structured error metadata",
"schema draft selection and format behavior follow the installed jsonschema library and the schema's declarations",
"invalid schemas, malformed JSON, missing files, and other non-ValidationError failures use the wrapper's error envelope rather than valid=false"
]
},
"io": {
"input_contract": [
{
"name": "instance_path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "schema_path",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Validation verdict with valid boolean and an error message only when the JSON instance fails schema validation.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "json-schema-instance-validation",
"intent_tags": [
"validate a JSON file against JSON Schema",
"check one JSON instance for schema conformance"
],
"negative_intents": [
"infer a schema from sample JSON",
"collect every JSON Schema validation error",
"validate inline JSON strings without files"
]
},
"execution": {
"runtime": "python_library",
"uri": "file://Pool/resources/tools/lib/lib.jsonschema_validate.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://python-jsonschema.readthedocs.io/",
"license": "MIT",
"backed_by": "jsonschema_validate",
"recognized_public_tool": true,
"source_hash": "sha256:5708a52b3ec5e6e2f073427ef3de2fef8eabe5dfc7dfb236600f5c23b0334635",
"local_implementation_uri": "file://Pool/resources/tools/lib/lib.jsonschema_validate.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/lib/_liblib.py": "sha256:dcd68e7904232764172e5f646ff97b854f68f7f916180ae32f838a0acf9ccc77"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "instance_path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "schema_path",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Validation verdict with valid boolean and an error message only when the JSON instance fails schema validation.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "jsonschema",
"version": "==4.23.0",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.lib.langdetect_detect.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Rank probable languages for one text string",
"description": "Runs langdetect.detect_langs on the complete input text, returns its ranked language-probability candidates as strings, and echoes only the first 60 characters of the input.",
"domain_tags": [
"nlp"
],
"core_primitives": [
"detect_language_candidates",
"rank_language_probabilities",
"truncate_text_preview"
],
"problem_space": "Probabilistic language identification for a single piece of plain text."
},
"constraint": {
"io_signature": "Input: one text string; output: JSON with a 60-character text preview and ranked language candidates serialized as strings.",
"accepted_inputs": [
"plain text containing enough linguistic signal for langdetect to classify"
],
"output_shape": "Success is an object with status=\"success\", tool=\"lib.langdetect_detect\", text as the first at most 60 characters of the input, and languages as an ordered array of stringified language-code:probability candidates. A caught language-detection exception produces an object with status=\"error\", tool=\"lib.langdetect_detect\", and message as the exception string, then exits with code 1.",
"limitations": [
"returns stringified candidates rather than structured language and probability fields",
"echoes only the first 60 characters even though detection uses the full input",
"does not set DetectorFactory.seed, so results for short or ambiguous text may vary between runs",
"empty or insufficient text and library detection failures are returned through the wrapper's error envelope",
"identifies languages only; it does not translate, segment, or classify topic or sentiment"
]
},
"io": {
"input_contract": [
{
"name": "text",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Truncated input preview plus ranked langdetect language-probability strings.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "probabilistic-text-language-detection",
"intent_tags": [
"detect the language of text",
"rank likely languages for a text string"
],
"negative_intents": [
"translate text between languages",
"return a deterministic single language code",
"detect programming languages or file types"
]
},
"execution": {
"runtime": "python_library",
"uri": "file://Pool/resources/tools/lib/lib.langdetect_detect.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/Mimino666/langdetect",
"license": "Apache-2.0",
"recognized_public_tool": true,
"source_hash": "sha256:7a095576d5420e21840c8b0748be558714d44a4f06f8229cbbccc4622f498d82",
"local_implementation_uri": "file://Pool/resources/tools/lib/lib.langdetect_detect.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/lib/_liblib.py": "sha256:dcd68e7904232764172e5f646ff97b854f68f7f916180ae32f838a0acf9ccc77"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "text",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Truncated input preview plus ranked langdetect language-probability strings.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "langdetect",
"version": "==1.0.9",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.lib.markdown_it_render.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Render one Markdown string to HTML with markdown-it defaults",
"description": "Instantiates MarkdownIt with its default preset and renders the supplied Markdown string to an HTML fragment returned under the html field.",
"domain_tags": [
"docs"
],
"core_primitives": [
"parse_markdown_tokens",
"render_markdown_html",
"preserve_default_commonmark_behavior"
],
"problem_space": "One-shot Markdown-to-HTML conversion using markdown-it-py's uncustomized parser and renderer."
},
"constraint": {
"io_signature": "Input: one Markdown string; output: wrapper JSON containing the rendered HTML string under html.",
"accepted_inputs": [
"Markdown or plain text accepted by a default MarkdownIt instance"
],
"output_shape": "Success is an object with status=\"success\", tool=\"lib.markdown_it_render\", and html as the complete HTML fragment string rendered by a default MarkdownIt instance. A caught Markdown parsing or rendering exception produces an object with status=\"error\", tool=\"lib.markdown_it_render\", and message as the exception string, then exits with code 1.",
"limitations": [
"uses a fresh default MarkdownIt instance with no plugins, custom rules, presets, or renderer options supplied by the caller",
"does not sanitize the resulting HTML and must not be treated as an XSS-cleaning step",
"returns an HTML fragment in a JSON field rather than writing a standalone HTML document or file",
"does not expose parsed tokens, source maps, or rendering diagnostics"
]
},
"io": {
"input_contract": [
{
"name": "markdown",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "html",
"description": "HTML fragment rendered from the input Markdown and returned in the html field."
}
},
"routing": {
"family": "markdown-to-html-rendering",
"intent_tags": [
"render Markdown as HTML",
"convert a Markdown string to an HTML fragment"
],
"negative_intents": [
"sanitize untrusted HTML or Markdown output",
"render plugin-specific Markdown extensions",
"extract a Markdown syntax tree or token stream"
]
},
"execution": {
"runtime": "python_library",
"uri": "file://Pool/resources/tools/lib/lib.markdown_it_render.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/executablebooks/markdown-it-py",
"license": "MIT",
"recognized_public_tool": true,
"source_hash": "sha256:b35be237b49386b2998b77c284260721c06a224c1a4fffefb466daabdd74b7d3",
"local_implementation_uri": "file://Pool/resources/tools/lib/lib.markdown_it_render.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/lib/_liblib.py": "sha256:dcd68e7904232764172e5f646ff97b854f68f7f916180ae32f838a0acf9ccc77"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "markdown",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "html",
"description": "HTML fragment rendered from the input Markdown and returned in the html field."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "markdown-it-py",
"version": "==3.0.0",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.lib.networkx_analyze.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Compute degree or betweenness centrality on an undirected graph",
"description": "Builds an unweighted undirected NetworkX Graph from a JSON edge list, then returns degree centrality when metric is exactly degree and betweenness centrality for every other metric value.",
"domain_tags": [
"graph",
"data"
],
"core_primitives": [
"construct_undirected_graph",
"compute_degree_centrality",
"compute_betweenness_centrality"
],
"problem_space": "Basic node-centrality scoring and graph size reporting for a JSON-encoded undirected edge list."
},
"constraint": {
"io_signature": "Inputs: JSON edge-list string and metric string; output: JSON with echoed metric, node and edge counts, and a node-to-centrality result map.",
"accepted_inputs": [
"a JSON array of edge tuples accepted by NetworkX Graph.add_edges_from",
"metric value degree for degree centrality, or any other string to select betweenness centrality"
],
"output_shape": "Success is an object with status=\"success\", tool=\"lib.networkx_analyze\", metric as the echoed selector string, nodes and edges as integer graph counts, and result as an object mapping node identifiers to numeric centrality scores. A caught edge-JSON, graph-construction, centrality, or serialization exception produces an object with status=\"error\", tool=\"lib.networkx_analyze\", and message as the exception string, then exits with code 1.",
"limitations": [
"always constructs an undirected simple Graph, collapsing parallel edges and not preserving directed semantics",
"supports only degree centrality and betweenness centrality; it does not calculate paths despite the original broad label",
"any metric other than the exact string degree silently selects betweenness centrality instead of being rejected",
"the wrapper defaults a missing metric argument to degree even though the manifest declares it required",
"does not expose graph mutation, components, path queries, or configurable centrality parameters"
]
},
"io": {
"input_contract": [
{
"name": "edges_json",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "metric",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Graph size and node centrality scores for an undirected graph, using degree or betweenness selection.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "undirected-graph-centrality-analysis",
"intent_tags": [
"compute node degree centrality",
"compute node betweenness centrality from an edge list"
],
"negative_intents": [
"find shortest paths between graph nodes",
"analyze directed or multigraph edge semantics",
"compute arbitrary NetworkX metrics by name"
]
},
"execution": {
"runtime": "python_library",
"uri": "file://Pool/resources/tools/lib/lib.networkx_analyze.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://networkx.org/",
"license": "BSD-3",
"recognized_public_tool": true,
"source_hash": "sha256:284077ce18c2d4fa6497df136f10a70fe2e097690099ec144908f8646441af81",
"local_implementation_uri": "file://Pool/resources/tools/lib/lib.networkx_analyze.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/lib/_liblib.py": "sha256:dcd68e7904232764172e5f646ff97b854f68f7f916180ae32f838a0acf9ccc77"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "edges_json",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "metric",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Graph size and node centrality scores for an undirected graph, using degree or betweenness selection.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "networkx",
"version": "==3.4.2",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.lib.numpy_linalg.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Compute a matrix determinant, inverse, or real eigenvalue parts",
"description": "Parses a JSON matrix into a NumPy array and computes determinant for operation det, inverse for inv, or eigenvalues for every other operation string; eigenvalue output keeps only real components.",
"domain_tags": [
"math",
"data"
],
"core_primitives": [
"parse_numeric_matrix",
"compute_determinant_or_inverse",
"extract_real_eigenvalue_parts"
],
"problem_space": "Three narrowly selected square-matrix calculations serialized through JSON."
},
"constraint": {
"io_signature": "Inputs: JSON-encoded matrix and operation string; output: JSON echoing operation with a nested result containing det, inv, or eigvals.",
"accepted_inputs": [
"a JSON rectangular numeric matrix suitable for the selected NumPy linear algebra routine",
"operation det, operation inv, or another string that selects eigenvalue calculation"
],
"output_shape": "Success is an object with status=\"success\", tool=\"lib.numpy_linalg\", operation as the echoed selector string, and result as an object containing exactly one branch: det as a float, inv as nested numeric lists, or eigvals as a list of real components. A caught JSON, array-construction, dimension, singular-matrix, or linear-algebra exception produces an object with status=\"error\", tool=\"lib.numpy_linalg\", and message as the exception string, then exits with code 1.",
"limitations": [
"supports only determinant, inverse, and eigenvalue calculation; any operation other than exact det or inv silently selects eigenvalues",
"the eigenvalue branch discards all imaginary components by returning only np.linalg.eigvals(...).real",
"determinant, inverse, and eigenvalue operations require dimensions accepted by NumPy, generally a square two-dimensional matrix",
"singular inverses, malformed JSON, ragged or nonnumeric arrays, and NumPy errors use the wrapper's error envelope",
"the wrapper defaults a missing operation to det even though the manifest declares it required"
]
},
"io": {
"input_contract": [
{
"name": "matrix_json",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "operation",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Selected matrix operation plus a determinant scalar, inverse matrix, or real parts of eigenvalues.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "basic-square-matrix-linalg",
"intent_tags": [
"calculate a matrix determinant or inverse",
"calculate real parts of matrix eigenvalues"
],
"negative_intents": [
"solve a linear system with a right-hand side",
"preserve complex eigenvalues",
"run arbitrary NumPy linear algebra operations"
]
},
"execution": {
"runtime": "python_library",
"uri": "file://Pool/resources/tools/lib/lib.numpy_linalg.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://numpy.org/",
"license": "BSD-3",
"recognized_public_tool": true,
"source_hash": "sha256:b5676228d79ac3ce425164897b46439b5d9c51799795a64812fd0ac96067e181",
"local_implementation_uri": "file://Pool/resources/tools/lib/lib.numpy_linalg.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/lib/_liblib.py": "sha256:dcd68e7904232764172e5f646ff97b854f68f7f916180ae32f838a0acf9ccc77"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "matrix_json",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "operation",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Selected matrix operation plus a determinant scalar, inverse matrix, or real parts of eigenvalues.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "numpy",
"version": "==2.1.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.lib.pandas_describe.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Describe every column in one CSV file with pandas defaults",
"description": "Reads a CSV file with pandas.read_csv defaults, runs DataFrame.describe(include='all'), and returns the resulting per-column statistics as a nested dictionary.",
"domain_tags": [
"data",
"statistics"
],
"core_primitives": [
"read_csv_table",
"summarize_all_column_types",
"serialize_column_statistics"
],
"problem_space": "Quick exploratory summaries of numeric and nonnumeric columns in a single CSV table."
},
"constraint": {
"io_signature": "Input: one CSV file path; output: JSON with describe as a column-oriented nested statistics object.",
"accepted_inputs": [
"a readable CSV file parseable by pandas.read_csv with its default delimiter, header, encoding, and type inference"
],
"output_shape": "Success is an object with status=\"success\", tool=\"lib.pandas_describe\", and describe as a column-keyed object whose values map pandas statistic names to values from DataFrame.describe(include='all'). A caught file-read, CSV-parse, dataframe-summary, or serialization exception produces an object with status=\"error\", tool=\"lib.pandas_describe\", and message as the exception string, then exits with code 1.",
"limitations": [
"uses fixed pandas.read_csv defaults and exposes no delimiter, encoding, header, dtype, missing-value, or date-parsing options",
"include='all' mixes type-specific statistics, so inapplicable cells may serialize as NaN rather than strict JSON null",
"does not compute correlations, grouped summaries, custom percentiles, or inferential statistics",
"loads the entire CSV into memory",
"file access and CSV parsing failures are returned through the wrapper's error envelope"
]
},
"io": {
"input_contract": [
{
"name": "csv_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Column-oriented output of pandas describe(include='all') for the loaded CSV.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "csv-column-descriptive-statistics",
"intent_tags": [
"summarize columns in a CSV file",
"get pandas descriptive statistics for all CSV columns"
],
"negative_intents": [
"group or pivot CSV records",
"calculate correlations or statistical tests",
"configure nondefault CSV parsing options"
]
},
"execution": {
"runtime": "python_library",
"uri": "file://Pool/resources/tools/lib/lib.pandas_describe.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://pandas.pydata.org/",
"license": "BSD-3",
"recognized_public_tool": true,
"source_hash": "sha256:99311cef00f1b200d67f62c0bb9047d5dd9a8d5d2286d276aacd543745270829",
"local_implementation_uri": "file://Pool/resources/tools/lib/lib.pandas_describe.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/lib/_liblib.py": "sha256:dcd68e7904232764172e5f646ff97b854f68f7f916180ae32f838a0acf9ccc77"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "csv_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Column-oriented output of pandas describe(include='all') for the loaded CSV.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "pandas",
"version": "==2.2.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.lib.pandas_pivot.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Average one CSV value column by one index column",
"description": "Reads a CSV with pandas defaults, builds a pivot table using one index column, one values column, and a fixed mean aggregation, then returns the reset-index table as CSV text.",
"domain_tags": [
"data"
],
"core_primitives": [
"read_csv_table",
"group_values_by_index",
"calculate_group_means",
"serialize_pivot_csv"
],
"problem_space": "Single-key mean aggregation of one value column from a file-backed CSV table."
},
"constraint": {
"io_signature": "Inputs: CSV path, one index-column name, and one value-column name; output: wrapper JSON containing the mean-aggregated table as CSV text under csv.",
"accepted_inputs": [
"a readable CSV parseable by pandas.read_csv defaults",
"existing column names identifying one grouping index and one mean-aggregated value column"
],
"output_shape": "Success is an object with status=\"success\", tool=\"lib.pandas_pivot\", and csv as a header-bearing CSV string for the reset-index mean pivot table. A caught file-read, CSV-parse, missing-column, mean-aggregation, or serialization exception produces an object with status=\"error\", tool=\"lib.pandas_pivot\", and message as the exception string, then exits with code 1.",
"limitations": [
"uses a fixed mean aggregation and cannot select sum, count, median, multiple aggregations, or custom functions",
"accepts only one index column and one values column and does not expose pandas pivot_table's columns dimension",
"uses fixed pandas.read_csv defaults with no delimiter, encoding, dtype, or missing-value options",
"returns CSV content inside the wrapper response rather than writing a CSV file",
"missing columns, non-aggregatable values, read failures, and pandas errors use the wrapper's error envelope"
]
},
"io": {
"input_contract": [
{
"name": "csv_path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "index",
"kind": "string",
"required": true,
"cli_position": 2
},
{
"name": "values",
"kind": "string",
"required": true,
"cli_position": 3
}
],
"output_contract": {
"artifact_type": "csv",
"description": "CSV text containing one grouping column and the mean of one selected value column."
}
},
"routing": {
"family": "single-key-csv-mean-aggregation",
"intent_tags": [
"average a CSV column by another column",
"create a one-index pandas mean pivot table"
],
"negative_intents": [
"build a two-dimensional pivot with column categories",
"choose an aggregation other than mean",
"summarize every CSV column with descriptive statistics"
]
},
"execution": {
"runtime": "python_library",
"uri": "file://Pool/resources/tools/lib/lib.pandas_pivot.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://pandas.pydata.org/",
"license": "BSD-3",
"recognized_public_tool": true,
"source_hash": "sha256:92396ac03e4823b5e1de7c467fd814b9b9e4eb4acaaea909c7a7e2ecf1317c75",
"local_implementation_uri": "file://Pool/resources/tools/lib/lib.pandas_pivot.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/lib/_liblib.py": "sha256:dcd68e7904232764172e5f646ff97b854f68f7f916180ae32f838a0acf9ccc77"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "csv_path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "index",
"kind": "string",
"required": true,
"cli_position": 2
},
{
"name": "values",
"kind": "string",
"required": true,
"cli_position": 3
}
],
"output_contract": {
"artifact_type": "csv",
"description": "CSV text containing one grouping column and the mean of one selected value column."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "pandas",
"version": "==2.2.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.lib.pdfplumber_extract.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Extract an 800-character text preview from a PDF",
"description": "Opens one PDF with pdfplumber, extracts text from every page, joins page results with newlines, and returns the document page count plus only the first 800 characters of combined text.",
"domain_tags": [
"docs",
"pdf"
],
"core_primitives": [
"open_pdf_document",
"extract_page_text",
"join_and_truncate_text"
],
"problem_space": "Short text previews and page-count inspection for text-bearing PDF files."
},
"constraint": {
"io_signature": "Input: one PDF file path; output: JSON with total pages and at most 800 characters of newline-joined extracted text.",
"accepted_inputs": [
"a readable PDF file that pdfplumber can open and parse"
],
"output_shape": "Success is an object with status=\"success\", tool=\"lib.pdfplumber_extract\", pages as the PDF's integer page count, and text as the first at most 800 characters of newline-joined page text. A caught file-open, PDF-parse, page-access, or text-extraction exception produces an object with status=\"error\", tool=\"lib.pdfplumber_extract\", and message as the exception string, then exits with code 1.",
"limitations": [
"extracts text only and does not extract tables despite the original broad label",
"returns only the first 800 characters of the combined document text and provides no per-page boundaries or coordinates",
"does not perform OCR, so image-only or scanned pages generally yield empty text",
"uses pdfplumber's default text extraction with no layout or cropping options",
"encrypted, missing, malformed, or unsupported PDFs use the wrapper's error envelope"
]
},
"io": {
"input_contract": [
{
"name": "pdf_path",
"kind": "file_path",
"artifact_types": [
"pdf"
],
"extensions": [
".pdf"
],
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "PDF page count and an at-most-800-character preview of newline-joined extracted text.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "pdf-text-preview-extraction",
"intent_tags": [
"preview text from a PDF",
"count PDF pages and extract a short text sample"
],
"negative_intents": [
"extract tables or cell structures from a PDF",
"OCR a scanned image-only PDF",
"return complete PDF text or page coordinates"
]
},
"execution": {
"runtime": "python_library",
"uri": "file://Pool/resources/tools/lib/lib.pdfplumber_extract.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/jsvine/pdfplumber",
"license": "MIT",
"backed_by": "pdfplumber_extract",
"recognized_public_tool": true,
"source_hash": "sha256:f0552226b97edc62ee1135d07b32ecf1e4e83cade21e97011f9c4fb2491e5bc5",
"local_implementation_uri": "file://Pool/resources/tools/lib/lib.pdfplumber_extract.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/lib/_liblib.py": "sha256:dcd68e7904232764172e5f646ff97b854f68f7f916180ae32f838a0acf9ccc77"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "pdf_path",
"kind": "file_path",
"artifact_types": [
"pdf"
],
"extensions": [
".pdf"
],
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "PDF page count and an at-most-800-character preview of newline-joined extracted text.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "pdfplumber",
"version": "==0.11.4",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.lib.phonenumbers_parse.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Parse one phone number and report validity, region, and E.164 form",
"description": "Parses a phone-number string with an optional region defaulting to US, then returns libphonenumber's validity verdict, inferred region code, and E.164 formatting.",
"domain_tags": [
"nlp",
"reference"
],
"core_primitives": [
"parse_regional_phone_number",
"validate_phone_number",
"format_phone_number_e164"
],
"problem_space": "Normalization and basic validity checking for a single phone-number string using libphonenumber metadata."
},
"constraint": {
"io_signature": "Inputs: phone-number string and optional region code defaulting to US; output: JSON with valid boolean, inferred country/region code, and E.164 string.",
"accepted_inputs": [
"an international phone number including a country calling code",
"a national-format phone number paired with a libphonenumber region code, or US when omitted"
],
"output_shape": "Success is an object with status=\"success\", tool=\"lib.phonenumbers_parse\", valid as a boolean, country as the inferred region-code string or null, and e164 as the parsed number's E.164-formatted string. A caught number-parse, region, or formatting exception produces an object with status=\"error\", tool=\"lib.phonenumbers_parse\", and message as the exception string, then exits with code 1.",
"limitations": [
"defaults missing region context to US, which can misinterpret national-format numbers from other regions",
"reports is_valid_number only and does not expose possible-number status, number type, carrier, timezone, or geocoding",
"may return an E.164 representation even when valid is false if parsing itself succeeds",
"does not verify ownership, reachability, or whether a number is currently assigned",
"unparseable numbers and invalid region inputs use the wrapper's error envelope"
]
},
"io": {
"input_contract": [
{
"name": "number",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "region",
"kind": "string",
"required": false,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Phone-number validity, inferred region code, and E.164-formatted representation.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "phone-number-parsing-and-normalization",
"intent_tags": [
"validate and normalize a phone number",
"format one phone number as E.164"
],
"negative_intents": [
"verify that a phone number is active or owned",
"look up carrier timezone or geographic descriptions",
"extract every phone number from free-form text"
]
},
"execution": {
"runtime": "python_library",
"uri": "file://Pool/resources/tools/lib/lib.phonenumbers_parse.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/daviddrysdale/python-phonenumbers",
"license": "Apache-2.0",
"backed_by": "phonenumbers_parse",
"recognized_public_tool": true,
"source_hash": "sha256:8cb8d5281dc85b62bee22a79c895b796bf4a7044269a10c7dc5357ddc843948b",
"local_implementation_uri": "file://Pool/resources/tools/lib/lib.phonenumbers_parse.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/lib/_liblib.py": "sha256:dcd68e7904232764172e5f646ff97b854f68f7f916180ae32f838a0acf9ccc77"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "number",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "region",
"kind": "string",
"required": false,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Phone-number validity, inferred region code, and E.164-formatted representation.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "phonenumbers",
"version": "==8.13.52",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.lib.pillow_transform.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Inspect an image's format, dimensions, and color mode",
"description": "Opens one image with Pillow and returns its detected format, pixel dimensions, and mode; the operation argument is only echoed and no image transformation is performed.",
"domain_tags": [
"image",
"media"
],
"core_primitives": [
"open_image_header",
"inspect_image_format",
"report_dimensions_and_mode"
],
"problem_space": "Lightweight metadata inspection for a single Pillow-readable image file."
},
"constraint": {
"io_signature": "Inputs: image path and operation string; output: JSON echoing operation with image format, two-element size, and mode metadata.",
"accepted_inputs": [
"a readable image file format recognized by the installed Pillow plugins",
"any operation string, which is echoed but does not alter behavior"
],
"output_shape": "Success is an object with status=\"success\", tool=\"lib.pillow_transform\", operation as the echoed string, format as Pillow's detected format string or null, size as the serialized [width, height] pair, and mode as the image mode string. A caught file-open or image-identification exception produces an object with status=\"error\", tool=\"lib.pillow_transform\", and message as the exception string, then exits with code 1.",
"limitations": [
"does not resize, crop, filter, convert, save, or otherwise transform the image despite the wrapper name and original label",
"the operation argument is ignored for processing and only echoed; a missing value defaults to info",
"returns metadata in JSON rather than an image artifact even though the manifest artifact_type remains structurally unchanged",
"does not explicitly call load or verify, so inspection may not detect every corruption located beyond the image header",
"missing, unreadable, and unrecognized image files use the wrapper's error envelope"
]
},
"io": {
"input_contract": [
{
"name": "image_path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "operation",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON-wrapped image metadata: echoed operation, detected format, pixel size, and color mode; no transformed image is produced."
}
},
"routing": {
"family": "image-header-metadata-inspection",
"intent_tags": [
"inspect image dimensions and mode",
"identify an image format with Pillow"
],
"negative_intents": [
"resize crop or filter an image",
"convert or save an image in another format",
"validate every pixel or fully decode image content"
]
},
"execution": {
"runtime": "python_library",
"uri": "file://Pool/resources/tools/lib/lib.pillow_transform.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://python-pillow.org/",
"license": "HPND",
"recognized_public_tool": true,
"source_hash": "sha256:fd4f84719edf3ff37950b82db819a0a000dce082dba898b90efa184327e475e0",
"local_implementation_uri": "file://Pool/resources/tools/lib/lib.pillow_transform.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/lib/_liblib.py": "sha256:dcd68e7904232764172e5f646ff97b854f68f7f916180ae32f838a0acf9ccc77"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "image_path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "operation",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON-wrapped image metadata: echoed operation, detected format, pixel size, and color mode; no transformed image is produced."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "Pillow",
"version": "==11.0.0",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.lib.pint_convert.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Convert one floating-point magnitude between compatible Pint units",
"description": "Creates a default Pint UnitRegistry, multiplies a parsed float by the supplied source unit, converts it to the target unit, and returns the original numeric value, converted magnitude, and normalized target-unit string.",
"domain_tags": [
"science",
"units"
],
"core_primitives": [
"parse_float_magnitude",
"construct_unit_quantity",
"convert_compatible_units"
],
"problem_space": "Scalar physical-unit conversion using Pint's default unit definitions and dimensional compatibility rules."
},
"constraint": {
"io_signature": "Inputs: float-like value string, source-unit expression, and target-unit expression; output: JSON with original float, converted magnitude, and normalized unit text.",
"accepted_inputs": [
"a string accepted by Python float for the scalar magnitude",
"source and target unit expressions recognized by a default Pint UnitRegistry and dimensionally convertible"
],
"output_shape": "Success is an object with status=\"success\", tool=\"lib.pint_convert\", value as the parsed input float, result as the converted scalar magnitude, and unit as Pint's normalized target-unit string. A caught float-parse, unit-definition, dimensionality, offset-unit, or conversion exception produces an object with status=\"error\", tool=\"lib.pint_convert\", and message as the exception string, then exits with code 1.",
"limitations": [
"accepts only a single Python float magnitude, not arrays, measurements with uncertainty, or a combined quantity expression",
"uses a fresh default UnitRegistry with no custom definitions, enabled contexts, or caller configuration",
"constructs quantities by multiplying magnitude and unit, which can reject offset units such as absolute temperatures under default Pint rules",
"does not preserve arbitrary decimal precision because the input is coerced to binary floating point",
"unknown units, incompatible dimensions, invalid floats, and conversion errors use the wrapper's error envelope"
]
},
"io": {
"input_contract": [
{
"name": "value",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "from_unit",
"kind": "string",
"required": true,
"cli_position": 2
},
{
"name": "to_unit",
"kind": "string",
"required": true,
"cli_position": 3
}
],
"output_contract": {
"artifact_type": "json",
"description": "Original float plus the converted scalar magnitude and Pint-normalized target unit.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "scalar-physical-unit-conversion",
"intent_tags": [
"convert a scalar between compatible units",
"normalize a Pint unit conversion result"
],
"negative_intents": [
"convert currencies or exchange rates",
"convert arrays or uncertain measurements",
"use custom Pint unit definitions or contexts"
]
},
"execution": {
"runtime": "python_library",
"uri": "file://Pool/resources/tools/lib/lib.pint_convert.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://pint.readthedocs.io/",
"license": "BSD-3",
"recognized_public_tool": true,
"source_hash": "sha256:6e8544e7b7da1be6b877ab45d656e26269ff35b1a13c6d5ee89f40e2557aa255",
"local_implementation_uri": "file://Pool/resources/tools/lib/lib.pint_convert.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/lib/_liblib.py": "sha256:dcd68e7904232764172e5f646ff97b854f68f7f916180ae32f838a0acf9ccc77"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "value",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "from_unit",
"kind": "string",
"required": true,
"cli_position": 2
},
{
"name": "to_unit",
"kind": "string",
"required": true,
"cli_position": 3
}
],
"output_contract": {
"artifact_type": "json",
"description": "Original float plus the converted scalar magnitude and Pint-normalized target unit.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "pint",
"version": "image-locked",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.lib.pygments_highlight.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Generate an 800-character Pygments HTML highlight preview",
"description": "Looks up a Pygments lexer by language alias, highlights one code string with the default HtmlFormatter, and returns only the first 800 characters of the generated HTML.",
"domain_tags": [
"swe",
"docs"
],
"core_primitives": [
"resolve_lexer_by_alias",
"render_syntax_highlight_html",
"truncate_html_preview"
],
"problem_space": "Short HTML previews of syntax-highlighted source code for a caller-specified Pygments lexer alias."
},
"constraint": {
"io_signature": "Inputs: source-code string and language alias; output: wrapper JSON with at most 800 characters of Pygments HTML under html.",
"accepted_inputs": [
"source code or text as a string",
"a lexer alias recognized by Pygments get_lexer_by_name, defaulting to python when omitted"
],
"output_shape": "Success is an object with status=\"success\", tool=\"lib.pygments_highlight\", and html as the first at most 800 characters of the default HtmlFormatter output. A caught lexer-lookup or highlighting exception produces an object with status=\"error\", tool=\"lib.pygments_highlight\", and message as the exception string, then exits with code 1.",
"limitations": [
"hard-truncates generated HTML at 800 characters, which can cut through tags and produce an invalid or incomplete fragment",
"uses the default HtmlFormatter with no caller-selectable style, line numbers, wrapping, or formatting options",
"does not include a generated CSS stylesheet; default output relies on Pygments CSS class names",
"when supplied, language must be a lexer alias recognized by Pygments; direct wrapper invocation defaults an omitted language to python, although the manifest input contract retains required=true",
"unknown aliases and highlighting failures use the wrapper's error envelope"
]
},
"io": {
"input_contract": [
{
"name": "code",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "language",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "html",
"description": "First 800 characters of default Pygments HtmlFormatter output; truncation may leave incomplete HTML."
}
},
"routing": {
"family": "syntax-highlight-html-preview",
"intent_tags": [
"preview syntax-highlighted code as HTML",
"highlight code using a Pygments language alias"
],
"negative_intents": [
"generate a complete large highlighted document",
"auto-detect the programming language",
"return a standalone styled HTML page or CSS stylesheet"
]
},
"execution": {
"runtime": "python_library",
"uri": "file://Pool/resources/tools/lib/lib.pygments_highlight.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://pygments.org/",
"license": "BSD-2",
"recognized_public_tool": true,
"source_hash": "sha256:e6f1c4a6b082b6e888c4fb47b10493dae10aa72320aea1f9cd5d4bafe20a4c86",
"local_implementation_uri": "file://Pool/resources/tools/lib/lib.pygments_highlight.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/lib/_liblib.py": "sha256:dcd68e7904232764172e5f646ff97b854f68f7f916180ae32f838a0acf9ccc77"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "code",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "language",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "html",
"description": "First 800 characters of default Pygments HtmlFormatter output; truncation may leave incomplete HTML."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "pygments",
"version": "==2.18.0",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.lib.pygount_sloc.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Run pygount JSON source-line analysis on one path",
"description": "Invokes the pygount CLI with a fixed JSON output format for one supplied path and returns the parsed CLI payload, or a short stderr object when stdout is empty.",
"domain_tags": [
"swe",
"metrics"
],
"core_primitives": [
"invoke_pygount_cli",
"parse_sloc_json_report",
"capture_empty-output_stderr"
],
"problem_space": "File-backed source line and language metrics as emitted by pygount's built-in JSON report."
},
"constraint": {
"io_signature": "Input: one path argument passed to pygount; output: JSON result containing parsed pygount JSON or an object with up to 200 stderr characters when stdout is empty.",
"accepted_inputs": [
"a file, directory, or path pattern accepted by the installed pygount CLI"
],
"output_shape": "Success is an object with status=\"success\", tool=\"lib.pygount_sloc\", and result as either pygount's parsed JSON report or, when stdout is empty, an object whose stderr string is truncated to 200 characters. A caught subprocess launch, timeout, or nonempty-stdout JSON-decoding exception produces an object with status=\"error\", tool=\"lib.pygount_sloc\", and message as the exception string, then exits with code 1.",
"limitations": [
"depends on an installed pygount executable and enforces a fixed 60-second subprocess timeout",
"passes only --format=json and exposes no encoding, suffix, duplicate, generated-code, or counting configuration",
"does not inspect the subprocess return code, so an empty-stdout CLI failure is still wrapped as success with at most 200 stderr characters",
"nonempty stdout that is not valid JSON triggers the wrapper's error envelope",
"does not normalize or summarize pygount's version-dependent JSON schema"
]
},
"io": {
"input_contract": [
{
"name": "path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Raw parsed pygount JSON report, or a truncated stderr object when pygount emits no stdout.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "pygount-source-line-reporting",
"intent_tags": [
"count source lines with pygount",
"produce a pygount JSON code metrics report"
],
"negative_intents": [
"compute cyclomatic complexity or maintainability scores",
"configure custom source-counting rules",
"receive a normalized per-language summary independent of pygount output"
]
},
"execution": {
"runtime": "python_library",
"uri": "file://Pool/resources/tools/lib/lib.pygount_sloc.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/roskakori/pygount",
"license": "BSD-3",
"backed_by": "pygount_sloc",
"recognized_public_tool": true,
"source_hash": "sha256:368032a6a5af1e8f0261bec5dd4416b437b71ac248e8c46e2881c3771a1b6f2f",
"local_implementation_uri": "file://Pool/resources/tools/lib/lib.pygount_sloc.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/lib/_liblib.py": "sha256:dcd68e7904232764172e5f646ff97b854f68f7f916180ae32f838a0acf9ccc77"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Raw parsed pygount JSON report, or a truncated stderr object when pygount emits no stdout.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.lib.pypdf_merge.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Inspect one PDF's page count and metadata preview",
"description": "Opens a single PDF path with pypdf PdfReader and returns its page count plus the first 300 characters of the string representation of document metadata; it performs no merge operation.",
"domain_tags": [
"docs",
"pdf"
],
"core_primitives": [
"open_pdf_reader",
"count_pdf_pages",
"truncate_metadata_representation"
],
"problem_space": "Basic structural inspection of one PDF when page count and a short metadata preview are sufficient."
},
"constraint": {
"io_signature": "Input: one PDF path string despite the plural parameter name; output: JSON with pages integer and metadata string truncated to 300 characters.",
"accepted_inputs": [
"one readable PDF file path accepted by pypdf PdfReader"
],
"output_shape": "Success is an object with status=\"success\", tool=\"lib.pypdf_merge\", pages as the PDF's integer page count, and metadata as the first at most 300 characters of str(PdfReader.metadata). A caught file-open, encryption, PDF-parse, page-access, or metadata exception produces an object with status=\"error\", tool=\"lib.pypdf_merge\", and message as the exception string, then exits with code 1.",
"limitations": [
"does not merge, split, rotate, rewrite, or output PDFs despite the wrapper name and original label",
"accepts exactly one path string; it does not parse a list of pdf_paths",
"metadata is flattened with str and truncated to 300 characters rather than returned as structured fields",
"returns JSON metadata rather than a PDF artifact even though the manifest artifact_type remains structurally unchanged",
"encrypted, malformed, missing, and unreadable PDFs use the wrapper's error envelope"
]
},
"io": {
"input_contract": [
{
"name": "pdf_paths",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON-wrapped page count and a 300-character PDF metadata preview; no PDF is created or modified."
}
},
"routing": {
"family": "pdf-page-and-metadata-inspection",
"intent_tags": [
"count pages in one PDF",
"preview one PDF's document metadata"
],
"negative_intents": [
"merge multiple PDF files",
"split rotate or rewrite PDF pages",
"extract complete structured PDF metadata"
]
},
"execution": {
"runtime": "python_library",
"uri": "file://Pool/resources/tools/lib/lib.pypdf_merge.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://pypdf.readthedocs.io/",
"license": "BSD-3",
"recognized_public_tool": true,
"source_hash": "sha256:e10bfa7e6bc969a58a20d52bf515eb6449f5008dfb333f77885db930f77cbf86",
"local_implementation_uri": "file://Pool/resources/tools/lib/lib.pypdf_merge.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/lib/_liblib.py": "sha256:dcd68e7904232764172e5f646ff97b854f68f7f916180ae32f838a0acf9ccc77"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "pdf_paths",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON-wrapped page count and a 300-character PDF metadata preview; no PDF is created or modified."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "pypdf",
"version": "==5.1.0",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.lib.qrcode_generate.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Measure the base64 length of a generated QR image",
"description": "Generates a QR image in memory from one data string using qrcode defaults, saves it to a byte buffer, base64-encodes those bytes, and returns only the encoded byte-count alongside the original data.",
"domain_tags": [
"utility",
"image"
],
"core_primitives": [
"encode_data_as_qr",
"serialize_qr_to_memory",
"measure_base64_encoded_length"
],
"problem_space": "Checking whether default QR generation succeeds and measuring the resulting base64 payload length without returning the image payload."
},
"constraint": {
"io_signature": "Input: one data string; output: JSON echoing data and reporting png_base64_len as the length of the base64-encoded in-memory image bytes.",
"accepted_inputs": [
"a text string whose encoded content fits within a QR code supported by qrcode.make defaults"
],
"output_shape": "Success is an object with status=\"success\", tool=\"lib.qrcode_generate\", data as the original input string, and png_base64_len as the integer length of the base64-encoded in-memory image bytes; no image payload is included. A caught QR-capacity, image-generation, serialization, or base64 exception produces an object with status=\"error\", tool=\"lib.qrcode_generate\", and message as the exception string, then exits with code 1.",
"limitations": [
"does not return, write, or expose the QR image or its base64 data despite the image artifact declaration",
"png_base64_len is only a byte-count of the encoded base64 payload, not the payload itself",
"uses qrcode.make and image-save defaults with no caller control over version, error correction, box size, border, colors, style, or output path",
"echoes the complete input data in the output, which may be unsuitable for sensitive payloads",
"oversized data and image-generation or serialization failures use the wrapper's error envelope"
]
},
"io": {
"input_contract": [
{
"name": "data",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Original data and the base64-encoded image length only; no QR image or base64 payload is included.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "qr-generation-size-measurement",
"intent_tags": [
"measure default QR image base64 size",
"check QR generation and report encoded length"
],
"negative_intents": [
"receive a QR code image or base64 payload",
"save a QR code to a file",
"customize QR error correction colors or dimensions"
]
},
"execution": {
"runtime": "python_library",
"uri": "file://Pool/resources/tools/lib/lib.qrcode_generate.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/lincolnloop/python-qrcode",
"license": "BSD-3",
"recognized_public_tool": true,
"source_hash": "sha256:2de0b98190ffaa1b44eb98241efb6cdd9166b958dfa96a011ddf8528d00b0b05",
"local_implementation_uri": "file://Pool/resources/tools/lib/lib.qrcode_generate.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/lib/_liblib.py": "sha256:dcd68e7904232764172e5f646ff97b854f68f7f916180ae32f838a0acf9ccc77"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "data",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Original data and the base64-encoded image length only; no QR image or base64 payload is included.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "qrcode",
"version": "==8.0",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.lib.radon_complexity.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "List named Python blocks and their cyclomatic complexity",
"description": "Reads one source file as text, runs Radon's cc_visit, and returns each discovered block's name and numeric cyclomatic complexity only.",
"domain_tags": [
"swe",
"metrics"
],
"core_primitives": [
"read_python_source",
"visit_complexity_blocks",
"extract_name_and_complexity"
],
"problem_space": "Minimal cyclomatic-complexity inspection of functions, methods, and classes in one Python source file."
},
"constraint": {
"io_signature": "Input: one Python source file path; output: JSON blocks array whose entries contain only name and complexity.",
"accepted_inputs": [
"a readable Python source file parseable by Radon's complexity visitor"
],
"output_shape": "Success is an object with status=\"success\", tool=\"lib.radon_complexity\", and blocks as an array whose entries each contain name as a string and complexity as Radon's integer cyclomatic-complexity value. A caught file-read, decoding, Python-parse, or complexity-analysis exception produces an object with status=\"error\", tool=\"lib.radon_complexity\", and message as the exception string, then exits with code 1.",
"limitations": [
"computes cyclomatic complexity only and does not calculate maintainability index despite the original label",
"returns no block type, rank, line number, column, closure context, or filename",
"duplicate block names can be ambiguous because only name and complexity are retained",
"reads exactly one file using Python's default text encoding and does not recurse through directories",
"file access, decoding, and Python syntax failures use the wrapper's error envelope"
]
},
"io": {
"input_contract": [
{
"name": "path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Array of Radon-discovered Python block names with cyclomatic complexity values.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "python-block-cyclomatic-complexity",
"intent_tags": [
"measure cyclomatic complexity in one Python file",
"list Python block names and complexity values"
],
"negative_intents": [
"calculate maintainability index or Halstead metrics",
"analyze an entire directory recursively",
"return complexity ranks locations or full block metadata"
]
},
"execution": {
"runtime": "python_library",
"uri": "file://Pool/resources/tools/lib/lib.radon_complexity.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/rubik/radon",
"license": "MIT",
"backed_by": "radon_complexity",
"recognized_public_tool": true,
"source_hash": "sha256:faa2b9204f1e99e8783500f9bd6af08fbadfa0fcd36dd1c62fb003269a47480e",
"local_implementation_uri": "file://Pool/resources/tools/lib/lib.radon_complexity.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/lib/_liblib.py": "sha256:dcd68e7904232764172e5f646ff97b854f68f7f916180ae32f838a0acf9ccc77"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Array of Radon-discovered Python block names with cyclomatic complexity values.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "radon",
"version": "==6.0.1",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.lib.shapely_geometry.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Measure area or distance, test the intersects predicate, or return a WKT centroid",
"description": "Parses a primary WKT geometry; operation area returns its area, intersects tests the intersects predicate against a second WKT, distance measures to a second WKT, and every other operation value returns the centroid. Direct wrapper invocation defaults an omitted third argument to area, and every result is converted to a string.",
"domain_tags": [
"geo"
],
"core_primitives": [
"parse_wkt_geometry",
"measure_area_or_distance",
"test_intersection",
"compute_centroid"
],
"problem_space": "Small planar geometry calculations over one or two WKT-encoded Shapely geometries."
},
"constraint": {
"io_signature": "Inputs: primary WKT, optional secondary WKT, and operation; output: JSON echoing operation with result always serialized as a string.",
"accepted_inputs": [
"a valid WKT geometry for area or centroid calculation",
"two valid WKT geometries for intersects or distance operations",
"operation area, intersects, or distance; an omitted operation defaults to area in direct wrapper invocation, while any other value selects centroid"
],
"output_shape": "Success is an object with status=\"success\", tool=\"lib.shapely_geometry\", operation as the selected or defaulted operation string, and result as a string containing the area number, intersects predicate True/False, distance number, or centroid representation. A caught WKT-parse, missing-secondary-geometry, topology, or geometry-operation exception produces an object with status=\"error\", tool=\"lib.shapely_geometry\", and message as the exception string, then exits with code 1.",
"limitations": [
"supports exact operations area, intersects, and distance; every unknown operation string silently computes the primary geometry centroid",
"direct wrapper invocation defaults an omitted third operation argument to area even though the manifest input contract retains required=true",
"requires wkt_b only for intersects and distance and ignores it for area and centroid",
"stringifies every result, so numeric values and booleans are not returned with native JSON types",
"uses Shapely's planar Cartesian calculations with no CRS metadata, geodesic distance, or coordinate transformation",
"invalid WKT, missing secondary geometry for binary operations, and topology errors use the wrapper's error envelope"
]
},
"io": {
"input_contract": [
{
"name": "wkt_a",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "wkt_b",
"kind": "string",
"required": false,
"cli_position": 2
},
{
"name": "op",
"kind": "string",
"required": true,
"cli_position": 3
}
],
"output_contract": {
"artifact_type": "json",
"description": "Echoed operation and a stringified area, intersection verdict, distance, or centroid result.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "wkt-planar-geometry-calculation",
"intent_tags": [
"calculate WKT area distance or centroid",
"test whether two WKT geometries intersect"
],
"negative_intents": [
"perform geodesic or CRS-aware measurements",
"compute geometry union intersection shapes or buffers",
"return numeric or boolean results with native JSON types"
]
},
"execution": {
"runtime": "python_library",
"uri": "file://Pool/resources/tools/lib/lib.shapely_geometry.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://shapely.readthedocs.io/",
"license": "BSD-3",
"recognized_public_tool": true,
"source_hash": "sha256:94940b903579c7bc5304a7381b88a9460ab246fe2546b48209d372f814838129",
"local_implementation_uri": "file://Pool/resources/tools/lib/lib.shapely_geometry.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/lib/_liblib.py": "sha256:dcd68e7904232764172e5f646ff97b854f68f7f916180ae32f838a0acf9ccc77"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "wkt_a",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "wkt_b",
"kind": "string",
"required": false,
"cli_position": 2
},
{
"name": "op",
"kind": "string",
"required": true,
"cli_position": 3
}
],
"output_contract": {
"artifact_type": "json",
"description": "Echoed operation and a stringified area, intersection verdict, distance, or centroid result.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "shapely",
"version": "==2.0.6",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.lib.sqlglot_transpile.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Transpile SQL text between two SQLGlot dialects",
"description": "Passes one SQL string to sqlglot.transpile with a source dialect defaulting to mysql and target dialect defaulting to postgres, returning the generated statement strings as a list.",
"domain_tags": [
"database"
],
"core_primitives": [
"parse_source_sql_dialect",
"transform_sql_ast",
"generate_target_sql_dialect"
],
"problem_space": "Syntactic SQL dialect translation for one input string using SQLGlot's parser and generator."
},
"constraint": {
"io_signature": "Inputs: SQL string, source dialect name, and target dialect name; output: JSON result array of transpiled SQL statement strings.",
"accepted_inputs": [
"SQL text parseable by the specified SQLGlot read dialect",
"read and write dialect identifiers recognized by the installed SQLGlot version"
],
"output_shape": "Success is an object with status=\"success\", tool=\"lib.sqlglot_transpile\", and result as an array of SQL statement strings generated in the requested write dialect. A caught source-SQL parse, dialect-resolution, transpilation, or target-generation exception produces an object with status=\"error\", tool=\"lib.sqlglot_transpile\", and message as the exception string, then exits with code 1.",
"limitations": [
"performs syntax translation only and does not connect to a database, execute SQL, inspect schemas, or verify runtime equivalence",
"uses SQLGlot defaults with no caller control over pretty printing, identifier quoting, normalization, comments, or unsupported-feature policy",
"dialect translation can be lossy or approximate for constructs without direct target equivalents",
"the wrapper defaults missing read and write arguments to mysql and postgres even though the manifest declares them required",
"parse, dialect, and generation exceptions use the wrapper's error envelope"
]
},
"io": {
"input_contract": [
{
"name": "sql",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "read",
"kind": "string",
"required": true,
"cli_position": 2
},
{
"name": "write",
"kind": "string",
"required": true,
"cli_position": 3
}
],
"output_contract": {
"artifact_type": "json",
"description": "Array of SQL statement strings generated in the requested target dialect.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "sql-dialect-transpilation",
"intent_tags": [
"translate SQL between database dialects",
"rewrite SQL syntax with SQLGlot"
],
"negative_intents": [
"execute SQL or validate it against a live database",
"guarantee semantic equivalence across database engines",
"format SQL without selecting source and target dialect behavior"
]
},
"execution": {
"runtime": "python_library",
"uri": "file://Pool/resources/tools/lib/lib.sqlglot_transpile.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/tobymao/sqlglot",
"license": "MIT",
"backed_by": "sqlglot_transpile",
"recognized_public_tool": true,
"source_hash": "sha256:86e6b08e88981a4158aaca88b0a676978204e290e1aa1fbadac2f197ec17ef7d",
"local_implementation_uri": "file://Pool/resources/tools/lib/lib.sqlglot_transpile.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/lib/_liblib.py": "sha256:dcd68e7904232764172e5f646ff97b854f68f7f916180ae32f838a0acf9ccc77"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "sql",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "read",
"kind": "string",
"required": true,
"cli_position": 2
},
{
"name": "write",
"kind": "string",
"required": true,
"cli_position": 3
}
],
"output_contract": {
"artifact_type": "json",
"description": "Array of SQL statement strings generated in the requested target dialect.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "sqlglot",
"version": "==26.0.1",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.lib.sympy_solve.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Simplify one SymPy expression or solve one lhs = rhs equation",
"description": "Parses a SymPy expression or a single lhs = rhs equation. Equations are normalized to lhs - rhs before simplification and sympy.solve; symbols are inferred by SymPy.",
"domain_tags": [
"math",
"science"
],
"core_primitives": [
"sympify_expression",
"simplify_symbolically",
"solve_expression_for_inferred_symbols"
],
"problem_space": "One-shot symbolic simplification and zero-finding for a SymPy-readable expression or equality."
},
"constraint": {
"io_signature": "Input: one SymPy expression or lhs = rhs equation string; output: JSON echoing input with simplified and solved values serialized as strings.",
"accepted_inputs": [
"an expression string accepted by sympy.sympify, or one lhs = rhs equation whose two sides are accepted by sympy.sympify"
],
"output_shape": "Success is an object with status=\"success\", tool=\"lib.sympy_solve\", input as the original expression string, simplified as str(sympy.simplify(expression)), and solved as str(sympy.solve(expression)). A caught sympify, simplification, or solving exception produces an object with status=\"error\", tool=\"lib.sympy_solve\", and message as the exception string, then exits with code 1.",
"limitations": [
"does not integrate or differentiate despite the original broad label",
"calls solve(expression) with no explicit variable, equation right-hand side, domain, assumptions, or solver options",
"treats the parsed expression as equal to zero and lets SymPy infer which symbols to solve for",
"stringifies both mathematical outputs, losing SymPy object types and structured solution shape",
"sympy.sympify is not intended for unsanitized untrusted input because it evaluates parsed expressions",
"parsing and symbolic-computation failures use the wrapper's error envelope and no timeout is imposed"
]
},
"io": {
"input_contract": [
{
"name": "expression",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Original expression plus stringified SymPy simplification and implicit-zero solve results.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "single-expression-symbolic-solving",
"intent_tags": [
"simplify a SymPy expression",
"solve an expression for its inferred symbols"
],
"negative_intents": [
"integrate or differentiate an expression",
"solve with explicit domains assumptions or variable selection",
"return structured symbolic objects or numeric approximations"
]
},
"execution": {
"runtime": "python_library",
"uri": "file://Pool/resources/tools/lib/lib.sympy_solve.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://www.sympy.org/",
"license": "BSD-3",
"recognized_public_tool": true,
"source_hash": "sha256:7d1f3de8143dcc571654bb6822d18cc5a4f8fec76b1706ae111829619fb14425",
"local_implementation_uri": "file://Pool/resources/tools/lib/lib.sympy_solve.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/lib/_liblib.py": "sha256:dcd68e7904232764172e5f646ff97b854f68f7f916180ae32f838a0acf9ccc77"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "expression",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Original expression plus stringified SymPy simplification and implicit-zero solve results.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "sympy",
"version": "==1.13.3",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.lib.tablib_convert.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Preview the first 800 units of a Tablib export",
"description": "Reads one input file as UTF-8 text, lets Tablib load the dataset with format inference, exports it to a requested format defaulting to JSON, and returns only the first 800 characters or bytes under output.",
"domain_tags": [
"data",
"conversion"
],
"core_primitives": [
"load_utf8_tabular_text",
"infer_tablib_input_format",
"export_and_truncate_dataset"
],
"problem_space": "Short previews of Tablib dataset exports from UTF-8 text-based tabular inputs."
},
"constraint": {
"io_signature": "Inputs: UTF-8 text input path and Tablib export-format name; output: JSON with output containing only the first 800 exported characters or bytes.",
"accepted_inputs": [
"a UTF-8 text file whose format Tablib Dataset.load can infer",
"an export format identifier supported by the installed Tablib format registry"
],
"output_shape": "Success is an object with status=\"success\", tool=\"lib.tablib_convert\", and output as the first at most 800 characters of a text export or, for binary exporters, the shared JSON emitter's string representation of the first at most 800 bytes. A caught UTF-8 read, input-format detection, dataset-load, or export exception produces an object with status=\"error\", tool=\"lib.tablib_convert\", and message as the exception string, then exits with code 1.",
"limitations": [
"does not write a converted file and returns only the first 800 units of the export despite the file artifact declaration",
"always opens input as UTF-8 text, so binary source formats such as XLSX cannot be loaded correctly by this wrapper",
"does not accept an explicit input format and relies on Tablib's automatic detection",
"binary export formats yield sliced bytes that the shared JSON emitter stringifies rather than returning a usable binary artifact",
"the wrapper defaults a missing target format to json even though the manifest declares it required",
"decoding, format detection, import, and export errors use the wrapper's error envelope"
]
},
"io": {
"input_contract": [
{
"name": "input_path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "to",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "At-most-800-unit preview of a Tablib export; no converted file is written or returned.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "tablib-export-preview",
"intent_tags": [
"preview a Tablib dataset export",
"convert UTF-8 tabular text and inspect the beginning"
],
"negative_intents": [
"produce a complete converted dataset file",
"load a binary spreadsheet input",
"return usable binary XLSX or ODS export bytes"
]
},
"execution": {
"runtime": "python_library",
"uri": "file://Pool/resources/tools/lib/lib.tablib_convert.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://tablib.readthedocs.io/",
"license": "MIT",
"backed_by": "tablib_convert",
"recognized_public_tool": true,
"source_hash": "sha256:85c7cbd716e1bb0d77f7f3ac56c0107b5eb95fc61b3824bda1af62cb8d143241",
"local_implementation_uri": "file://Pool/resources/tools/lib/lib.tablib_convert.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/lib/_liblib.py": "sha256:dcd68e7904232764172e5f646ff97b854f68f7f916180ae32f838a0acf9ccc77"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "input_path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "to",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "At-most-800-unit preview of a Tablib export; no converted file is written or returned.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "tablib",
"version": "==3.7.0",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.lib.validators_check.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Run one named python-validators check on one string",
"description": "Dynamically resolves an attribute from the validators module using the supplied kind, calls it with the value string, and returns the boolean conversion of its result while echoing kind and value.",
"domain_tags": [
"data",
"validation"
],
"core_primitives": [
"resolve_validator_by_name",
"apply_single_value_validator",
"coerce_validation_result_to_boolean"
],
"problem_space": "Single-string syntax validation through a named callable exposed by the installed python-validators module."
},
"constraint": {
"io_signature": "Inputs: value string and validators-module attribute name; output: JSON echoing kind and value with valid as bool(callable(value)).",
"accepted_inputs": [
"a string value suitable for the selected python-validators callable",
"the name of an installed validators module attribute that is callable with exactly one supplied positional value, defaulting to url when omitted"
],
"output_shape": "Success is an object with status=\"success\", tool=\"lib.validators_check\", kind as the selected validators-module attribute name, value as the original input string, and valid as bool(selected_callable(value)). A caught missing-attribute, non-callable attribute, argument, or validator exception produces an object with status=\"error\", tool=\"lib.validators_check\", and message as the exception string, then exits with code 1.",
"limitations": [
"uses unrestricted getattr on the validators module rather than a fixed allowlist of email, URL, and IP validators",
"available kind names and their behavior depend on the installed python-validators version",
"attributes that do not exist, are not callable, or require additional arguments use the wrapper's error envelope",
"coerces the validator return object with bool and does not expose validation failure details",
"checks library-defined syntax only and does not verify DNS, network reachability, mailbox ownership, or resource existence",
"echoes the complete input value in the result"
]
},
"io": {
"input_contract": [
{
"name": "value",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "kind",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Echoed validator name and input value with the selected validator's result coerced to a boolean.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "named-single-string-validation",
"intent_tags": [
"validate one string with a named python-validators check",
"check URL email IP or another supported string syntax"
],
"negative_intents": [
"verify network reachability ownership or resource existence",
"validate a structured object or multiple fields together",
"return detailed validation errors or normalized values"
]
},
"execution": {
"runtime": "python_library",
"uri": "file://Pool/resources/tools/lib/lib.validators_check.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/python-validators/validators",
"license": "MIT",
"backed_by": "validators_check",
"recognized_public_tool": true,
"source_hash": "sha256:95db13cdaf1ab3452c1ff342ca3564f86dbd2788525f7073d1ac426ddac2f087",
"local_implementation_uri": "file://Pool/resources/tools/lib/lib.validators_check.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/lib/_liblib.py": "sha256:dcd68e7904232764172e5f646ff97b854f68f7f916180ae32f838a0acf9ccc77"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "value",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "kind",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Echoed validator name and input value with the selected validator's result coerced to a boolean.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "validators",
"version": "==0.34.0",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.markdown_table_extractor.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Extract structured headers and rows from pipe tables in one local Markdown file",
"description": "Parses a UTF-8 Markdown file with markdown-it-py's CommonMark parser and table rule, returning each recognized pipe table as header and body-row arrays in a JSON envelope.",
"core_primitives": [
"parse_markdown_table_structure",
"extract_table_headers",
"extract_table_body_rows"
],
"problem_space": "Deterministic structural extraction of GitHub-style pipe tables from a local Markdown file; not Markdown rendering, spreadsheet analysis, OCR, HTML-table scraping, or natural-language interpretation of cell values.",
"domain_tags": [
"markdown",
"table_extraction",
"document_processing"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.9",
"markdown-it-py"
],
"io_signature": "Input: required file_path string naming an existing UTF-8 Markdown file. Output: JSON envelope {status, tool, target, table_count, tables}, where each table contains headers and rows arrays.",
"accepted_inputs": [
"an existing UTF-8 Markdown file containing zero or more pipe tables recognized by markdown-it-py's table rule"
],
"output_shape": "Success: {status: \"success\", tool: \"markdown-it-py\", target: string, table_count: integer, tables: [{headers: string[][], rows: string[][]}]}. Missing file exits 2 with an error envelope; read, decoding, or parser failures exit 1 with an error envelope.",
"limitations": [
"extracts only Markdown pipe tables recognized by the enabled markdown-it-py table rule",
"does not execute Markdown, interpret cell semantics, infer data types, scrape HTML tables, or write output files",
"loads the complete input file and parsed result into memory"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "file_path",
"kind": "file_path",
"required": true,
"description": "Path to an existing UTF-8 Markdown file.",
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Structured Markdown tables containing header and body-row cell arrays.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "markdown-table-structure-extraction",
"intent_tags": [
"extract tables from a Markdown file",
"parse Markdown pipe-table headers and rows",
"turn Markdown tables into structured JSON"
],
"negative_intents": [
"render Markdown as HTML",
"extract tables from PDF images or web pages",
"analyze spreadsheet formulas or infer table semantics"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/markdown_table_extractor.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/executablebooks/markdown-it-py",
"license": "MIT",
"backed_by": "markdown-it-py",
"recognized_public_tool": true,
"source_hash": "sha256:d323943603a4facdbe6d75c8d28f4667667626bcad0ae879406ff9aa4f452c6f",
"local_implementation_uri": "file://Pool/resources/tools/script/markdown_table_extractor.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"markdown",
"table_extraction",
"document_processing"
]
},
"input_contract": [
{
"name": "file_path",
"kind": "file_path",
"required": true,
"description": "Path to an existing UTF-8 Markdown file.",
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Structured Markdown tables containing header and body-row cell arrays.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "markdown-it-py",
"version": "==3.0.0",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.markdown_to_html_converter.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Convert one local Markdown file to an HTML fragment",
"description": "Reads UTF-8 Markdown and renders an HTML fragment with Python-Markdown tables, fenced_code, and toc extensions, returning the fragment in a JSON envelope without writing a file or sanitizing HTML.",
"core_primitives": [
"read_local_markdown_file",
"render_markdown_extensions_to_html",
"return_html_fragment_in_json_envelope"
],
"problem_space": "Read-only Markdown-to-HTML-fragment rendering for local content; not a full HTML document generator, sanitizer, browser renderer, template engine, or file exporter.",
"domain_tags": [
"web_development",
"content_management"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"Python-Markdown package"
],
"io_signature": "Input: required file_path string naming an existing UTF-8 Markdown file. Output: JSON envelope {status, tool, target, html} whose html field is a rendered fragment; no HTML file is created.",
"accepted_inputs": [
"an existing UTF-8 Markdown text file compatible with Python-Markdown and its tables, fenced_code, and toc extensions"
],
"output_shape": "Success: {status: \"success\", tool: \"python-markdown\", target: string, html: string}, exit 0. Missing path: {status: \"error\", message: string}, exit 2. Missing argument prints usage to stderr and exits 1 without JSON. File decoding, read, or rendering failures are uncaught and may traceback.",
"limitations": [
"returns an HTML fragment inside a JSON envelope and does not create a complete document or write an HTML file",
"does not sanitize raw HTML from Markdown, so output must not be treated as safe for untrusted content without separate sanitization",
"uses only tables, fenced_code, and toc extensions; it has no timeout or size/output truncation and does not execute rendered code blocks"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Rendered HTML fragment carried in the `html` field of a JSON execution envelope; no file is written.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "markdown-to-html-fragment-conversion",
"intent_tags": [
"convert a Markdown file to an HTML fragment",
"render Markdown tables fenced code and headings as HTML"
],
"negative_intents": [
"sanitize untrusted HTML or Markdown",
"write a complete HTML document to disk",
"render HTML in a browser or execute code blocks"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/markdown_to_html_converter.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://python-markdown.github.io",
"license": "BSD",
"backed_by": "Python-Markdown",
"recognized_public_tool": true,
"source_hash": "sha256:f53bcde23c1d91ece47d36f6daf0da710d1cf7ccdb6ffe293f9bc067bb8da4f4",
"local_implementation_uri": "file://Pool/resources/tools/script/markdown_to_html_converter.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"web_development",
"content_management"
]
},
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Rendered HTML fragment carried in the `html` field of a JSON execution envelope; no file is written.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "markdown",
"version": "==3.7",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.mcp.fs_create_directory.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"execution_semantics": {
"side_effects": "declared",
"effect_targets": [
"task_workspace"
],
"determinism": "deterministic"
},
"summary": "Create one local directory at an explicit path and return the filesystem operation result.",
"description": "Use when a workflow must create a named folder in an allowed local workspace before writing files into it. The operation creates a directory only; it does not enumerate existing entries, read files, or write file contents.",
"domain_tags": [
"filesystem",
"directory-creation",
"workspace-setup"
],
"core_primitives": [
"create_directory",
"create_parent_folder",
"prepare_output_location"
],
"problem_space": "Create a required local output directory from a known path. This is filesystem mutation for workspace setup, distinct from listing directory entries, recursively displaying a tree, searching for files, or writing a file's contents."
},
"constraint": {
"io_signature": "Input: one directory path string. Output: JSON mutation invocation receipt.",
"accepted_inputs": [
"an explicit local directory path within the tool's allowed filesystem roots"
],
"output_shape": "JSON invocation receipt with status, operation, and completed; a failed operation includes error_code. Verify the requested workspace state separately.",
"limitations": [
"does not list or inspect existing directory contents",
"does not create, overwrite, or edit a file"
]
},
"io": {
"input_contract": [
{
"name": "path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "MCP-confirmed mutation invocation receipt; the requested final state must be checked separately.",
"schema": {
"oneOf": [
{
"type": "object",
"properties": {
"operation": {
"type": "string"
},
"status": {
"const": "success"
},
"completed": {
"const": true
}
},
"required": [
"status",
"operation",
"completed"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"operation": {
"type": "string"
},
"status": {
"const": "error"
},
"completed": {
"const": false
},
"error_code": {
"enum": [
"mcp_operation_failed",
"mcp_transport_failure"
]
},
"error_type": {
"type": "string"
}
},
"required": [
"status",
"operation",
"completed",
"error_code"
],
"additionalProperties": false
}
]
},
"result_status": {
"payload_path": "status",
"success_values": [
"success"
],
"failure_values": [
"error"
]
}
}
},
"routing": {
"family": "filesystem-mutation",
"intent_tags": [
"create a local directory",
"make a folder at a path",
"prepare an output folder"
],
"negative_intents": [
"list files in a directory",
"read or write file contents",
"search filenames or file contents"
]
},
"execution": {
"runtime": "mcp_server",
"uri": "file://Pool/resources/tools/mcp/mcp.fs_create_directory.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 300.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem",
"license": "MIT",
"backed_by": "MCP create_directory",
"recognized_public_tool": true,
"source_hash": "sha256:3aca84c3a318f37516583a34e9a0cb99942e5cda97becdd47f46aae1bc6aa824",
"local_implementation_uri": "file://Pool/resources/tools/mcp/mcp.fs_create_directory.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/mcp/_mcplib.py": "sha256:8c39f008bd1fc31f0457e6e08cb42da72eeeebba3dd1bcb51c277a33b35287f3",
"file://Pool/resources/tools/mcp/_mcp_mutation.py": "sha256:52c9a7780710e30ad44233af885b4ea4145a04d8b9efa40c25916c7b96a939d5"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "MCP-confirmed mutation invocation receipt; the requested final state must be checked separately.",
"schema": {
"oneOf": [
{
"type": "object",
"properties": {
"operation": {
"type": "string"
},
"status": {
"const": "success"
},
"completed": {
"const": true
}
},
"required": [
"status",
"operation",
"completed"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"operation": {
"type": "string"
},
"status": {
"const": "error"
},
"completed": {
"const": false
},
"error_code": {
"enum": [
"mcp_operation_failed",
"mcp_transport_failure"
]
},
"error_type": {
"type": "string"
}
},
"required": [
"status",
"operation",
"completed",
"error_code"
],
"additionalProperties": false
}
]
},
"result_status": {
"payload_path": "status",
"success_values": [
"success"
],
"failure_values": [
"error"
]
}
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "mcp",
"version": "==1.28.1",
"required": true
}
],
"node_packages": [
{
"name": "@modelcontextprotocol/server-filesystem",
"version": "==2026.7.10",
"required": true
}
],
"system_packages": [],
"commands": [
"mcp-server-filesystem"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"mcp": {
"server_command": "mcp-server-filesystem",
"working_directory": "/app",
"allowed_roots": [
"/app"
]
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.mcp.fs_directory_tree.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Recursively map the nested folders and files below one local directory as a directory tree.",
"description": "Use to inspect hierarchical filesystem structure beneath a known root path, such as understanding a source tree or reporting nested folders. It traverses descendants for structure; it does not search file text, read a file's contents, or mutate the workspace.",
"domain_tags": [
"filesystem",
"directory-tree",
"repository-structure"
],
"core_primitives": [
"recursive_directory_traversal",
"directory_tree_generation",
"nested_path_inspection"
],
"problem_space": "Inspect the recursive hierarchy below a local root directory and return an ordered tree of nested paths. This is for structural discovery, distinct from a one-level directory listing, filename/content pattern search, file-content reading, and filesystem mutation."
},
"constraint": {
"io_signature": "Input: one local root directory path. Output: JSON representation of the recursive directory tree below that root.",
"accepted_inputs": [
"an existing local directory path within the tool's allowed filesystem roots"
],
"output_shape": "JSON hierarchical tree of descendant directories and files.",
"limitations": [
"does not search file names or file contents by a pattern",
"does not read file contents or modify files and directories"
]
},
"io": {
"input_contract": [
{
"name": "path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Recursive directory tree via MCP filesystem server",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "filesystem-discovery",
"intent_tags": [
"show a recursive directory tree",
"inspect nested folder hierarchy",
"map repository structure"
],
"negative_intents": [
"list only immediate directory entries",
"search files by name or content pattern",
"read a known file"
]
},
"execution": {
"runtime": "mcp_server",
"uri": "file://Pool/resources/tools/mcp/mcp.fs_directory_tree.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 300.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem",
"license": "MIT",
"backed_by": "MCP directory_tree",
"recognized_public_tool": true,
"source_hash": "sha256:dd7c9a2ccf5fb82c5a15dc565b835fa19fefd4f8d6057171747459456876d66b",
"local_implementation_uri": "file://Pool/resources/tools/mcp/mcp.fs_directory_tree.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/mcp/_mcplib.py": "sha256:8c39f008bd1fc31f0457e6e08cb42da72eeeebba3dd1bcb51c277a33b35287f3"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Recursive directory tree via MCP filesystem server",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "mcp",
"version": "==1.28.1",
"required": true
}
],
"node_packages": [
{
"name": "@modelcontextprotocol/server-filesystem",
"version": "==2026.7.10",
"required": true
}
],
"system_packages": [],
"commands": [
"mcp-server-filesystem"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"mcp": {
"server_command": "mcp-server-filesystem",
"working_directory": "/app",
"allowed_roots": [
"/app"
]
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.mcp.fs_edit_file.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"execution_semantics": {
"side_effects": "declared",
"effect_targets": [
"task_workspace"
],
"determinism": "deterministic"
},
"summary": "Replace one exact text fragment with new text inside an existing local file.",
"description": "Use when a known text file needs an in-place, targeted replacement: provide its path, the exact old text, and replacement text. The tool edits an existing file by matching text; it is not a general file reader, file creator, rename operation, or pattern search across a workspace.",
"domain_tags": [
"filesystem",
"text-replacement",
"source-editing"
],
"core_primitives": [
"match_existing_text",
"replace_text_fragment",
"edit_existing_file"
],
"problem_space": "Apply a precise text replacement to one known existing local file. This is targeted in-place mutation that requires the old fragment, distinct from writing an entire new file, reading content without changes, moving paths, or searching unknown files."
},
"constraint": {
"io_signature": "Input: existing file path, exact old text, and replacement text. Output: JSON mutation invocation receipt.",
"accepted_inputs": [
"an existing editable local text-file path",
"an exact text fragment currently present in that file",
"replacement text"
],
"output_shape": "JSON invocation receipt with status, operation, and completed; a failed operation includes error_code. Verify the requested workspace state separately.",
"limitations": [
"does not create a missing file or overwrite an entire file without a text match",
"does not locate unknown files or read files without changing them"
]
},
"io": {
"input_contract": [
{
"name": "path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "old_text",
"kind": "string",
"required": true,
"cli_position": 2
},
{
"name": "new_text",
"kind": "string",
"required": true,
"cli_position": 3
}
],
"output_contract": {
"artifact_type": "json",
"description": "MCP-confirmed mutation invocation receipt; the requested final state must be checked separately.",
"schema": {
"oneOf": [
{
"type": "object",
"properties": {
"operation": {
"type": "string"
},
"status": {
"const": "success"
},
"completed": {
"const": true
}
},
"required": [
"status",
"operation",
"completed"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"operation": {
"type": "string"
},
"status": {
"const": "error"
},
"completed": {
"const": false
},
"error_code": {
"enum": [
"mcp_operation_failed",
"mcp_transport_failure"
]
},
"error_type": {
"type": "string"
}
},
"required": [
"status",
"operation",
"completed",
"error_code"
],
"additionalProperties": false
}
]
},
"result_status": {
"payload_path": "status",
"success_values": [
"success"
],
"failure_values": [
"error"
]
}
}
},
"routing": {
"family": "filesystem-mutation",
"intent_tags": [
"replace exact text in a file",
"patch an existing text file",
"edit a known source file in place"
],
"negative_intents": [
"create or overwrite a whole file",
"read a file without modifying it",
"search across files for a pattern"
]
},
"execution": {
"runtime": "mcp_server",
"uri": "file://Pool/resources/tools/mcp/mcp.fs_edit_file.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 300.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem",
"license": "MIT",
"backed_by": "MCP edit_file",
"recognized_public_tool": true,
"source_hash": "sha256:3f1b098b397e0e3803bc588faa936c71ab3665f7757fd8f6fb31586dc47dd112",
"local_implementation_uri": "file://Pool/resources/tools/mcp/mcp.fs_edit_file.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/mcp/_mcplib.py": "sha256:8c39f008bd1fc31f0457e6e08cb42da72eeeebba3dd1bcb51c277a33b35287f3",
"file://Pool/resources/tools/mcp/_mcp_mutation.py": "sha256:52c9a7780710e30ad44233af885b4ea4145a04d8b9efa40c25916c7b96a939d5"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "old_text",
"kind": "string",
"required": true,
"cli_position": 2
},
{
"name": "new_text",
"kind": "string",
"required": true,
"cli_position": 3
}
],
"output_contract": {
"artifact_type": "json",
"description": "MCP-confirmed mutation invocation receipt; the requested final state must be checked separately.",
"schema": {
"oneOf": [
{
"type": "object",
"properties": {
"operation": {
"type": "string"
},
"status": {
"const": "success"
},
"completed": {
"const": true
}
},
"required": [
"status",
"operation",
"completed"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"operation": {
"type": "string"
},
"status": {
"const": "error"
},
"completed": {
"const": false
},
"error_code": {
"enum": [
"mcp_operation_failed",
"mcp_transport_failure"
]
},
"error_type": {
"type": "string"
}
},
"required": [
"status",
"operation",
"completed",
"error_code"
],
"additionalProperties": false
}
]
},
"result_status": {
"payload_path": "status",
"success_values": [
"success"
],
"failure_values": [
"error"
]
}
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "mcp",
"version": "==1.28.1",
"required": true
}
],
"node_packages": [
{
"name": "@modelcontextprotocol/server-filesystem",
"version": "==2026.7.10",
"required": true
}
],
"system_packages": [],
"commands": [
"mcp-server-filesystem"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"mcp": {
"server_command": "mcp-server-filesystem",
"working_directory": "/app",
"allowed_roots": [
"/app"
]
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.mcp.fs_get_file_info.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Inspect metadata for one known local file or directory path without reading or changing its contents.",
"description": "Use to obtain filesystem attributes of a specified path, such as whether it exists, its type, size, and timestamps. It is a metadata inspection operation, not a content reader, directory enumerator, pattern search, or mutation tool.",
"domain_tags": [
"filesystem",
"path-metadata",
"file-inspection"
],
"core_primitives": [
"inspect_path_metadata",
"identify_file_or_directory",
"read_filesystem_attributes"
],
"problem_space": "Inspect metadata for a known filesystem path before choosing a later operation. It answers properties of one file or directory, distinct from listing children, traversing a tree, reading textual content, or modifying the path."
},
"constraint": {
"io_signature": "Input: one local file or directory path. Output: JSON metadata describing that path.",
"accepted_inputs": [
"an explicit local file or directory path within allowed roots"
],
"output_shape": "JSON path metadata such as file type, size, and timestamps.",
"limitations": [
"does not return file contents or child entries",
"does not search or alter the filesystem"
]
},
"io": {
"input_contract": [
{
"name": "path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "File/dir metadata via MCP filesystem server",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "filesystem-metadata",
"intent_tags": [
"inspect file metadata",
"check a path's size or type",
"get filesystem timestamps"
],
"negative_intents": [
"read a file's contents",
"list a directory",
"search files by pattern"
]
},
"execution": {
"runtime": "mcp_server",
"uri": "file://Pool/resources/tools/mcp/mcp.fs_get_file_info.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 300.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem",
"license": "MIT",
"backed_by": "MCP get_file_info",
"recognized_public_tool": true,
"source_hash": "sha256:b65417b6e22974902931e3b5c3d1d3c947dd6205018bfc0030ea649863d6972a",
"local_implementation_uri": "file://Pool/resources/tools/mcp/mcp.fs_get_file_info.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/mcp/_mcplib.py": "sha256:8c39f008bd1fc31f0457e6e08cb42da72eeeebba3dd1bcb51c277a33b35287f3"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "File/dir metadata via MCP filesystem server",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "mcp",
"version": "==1.28.1",
"required": true
}
],
"node_packages": [
{
"name": "@modelcontextprotocol/server-filesystem",
"version": "==2026.7.10",
"required": true
}
],
"system_packages": [],
"commands": [
"mcp-server-filesystem"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"mcp": {
"server_command": "mcp-server-filesystem",
"working_directory": "/app",
"allowed_roots": [
"/app"
]
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.mcp.fs_list_directory.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "List the immediate files and folders directly contained in one local directory.",
"description": "Use to enumerate one directory's direct children when the root path is known. It is a one-level listing for quick inspection; it does not recursively build a tree, search by name or content, read a selected file, or mutate the filesystem.",
"domain_tags": [
"filesystem",
"directory-listing",
"workspace-inspection"
],
"core_primitives": [
"list_immediate_directory_entries",
"enumerate_files_and_folders",
"inspect_directory_children"
],
"problem_space": "Enumerate the immediate entries of a known local directory. This is shallow filesystem discovery, distinct from recursive hierarchy traversal, content or filename search, reading a known file, and all filesystem writes."
},
"constraint": {
"io_signature": "Input: one local directory path. Output: text listing of immediate file and folder entries.",
"accepted_inputs": [
"an existing local directory path within allowed roots"
],
"output_shape": "text list of immediate child names and paths.",
"limitations": [
"does not recurse into descendant directories",
"does not search file names, inspect content, or modify paths"
]
},
"io": {
"input_contract": [
{
"name": "path",
"kind": "directory_path",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "text",
"description": "List a directory via MCP filesystem server"
}
},
"routing": {
"family": "filesystem-discovery",
"intent_tags": [
"list files in a directory",
"enumerate immediate folder contents",
"show direct child entries"
],
"negative_intents": [
"show a recursive directory tree",
"find files by a pattern",
"read a file's text"
]
},
"execution": {
"runtime": "mcp_server",
"uri": "file://Pool/resources/tools/mcp/mcp.fs_list_directory.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 300.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem",
"license": "MIT",
"backed_by": "MCP list_directory",
"recognized_public_tool": true,
"source_hash": "sha256:130dcc4ba315181ba74e65e7a6135d9d1b169d8e4efde3b6b3cf893e7a5d9826",
"local_implementation_uri": "file://Pool/resources/tools/mcp/mcp.fs_list_directory.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/mcp/_mcplib.py": "sha256:8c39f008bd1fc31f0457e6e08cb42da72eeeebba3dd1bcb51c277a33b35287f3"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "path",
"kind": "directory_path",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "text",
"description": "List a directory via MCP filesystem server"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "mcp",
"version": "==1.28.1",
"required": true
}
],
"node_packages": [
{
"name": "@modelcontextprotocol/server-filesystem",
"version": "==2026.7.10",
"required": true
}
],
"system_packages": [],
"commands": [
"mcp-server-filesystem"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"mcp": {
"server_command": "mcp-server-filesystem",
"working_directory": "/app",
"allowed_roots": [
"/app"
]
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.mcp.fs_move_file.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"execution_semantics": {
"side_effects": "declared",
"effect_targets": [
"task_workspace"
],
"determinism": "deterministic"
},
"summary": "Move or rename one local file from an explicit source path to an explicit destination path.",
"description": "Use when an existing file must be relocated or renamed while preserving its contents. It performs a path-level move; it does not copy content, edit text in place, inspect a directory, or create a file from supplied text.",
"domain_tags": [
"filesystem",
"file-relocation",
"path-mutation"
],
"core_primitives": [
"move_file",
"rename_file",
"relocate_path"
],
"problem_space": "Relocate or rename a known existing local file using a source and destination path. This is path mutation, distinct from editing file content, writing a new file, listing directories, and searching for unknown files."
},
"constraint": {
"io_signature": "Input: existing source file path and destination path. Output: JSON mutation invocation receipt.",
"accepted_inputs": [
"an existing source file path",
"a destination path within allowed filesystem roots"
],
"output_shape": "JSON invocation receipt with status, operation, and completed; a failed operation includes error_code. Verify the requested workspace state separately.",
"limitations": [
"does not edit the file's contents",
"does not copy a file or create a file from supplied text"
]
},
"io": {
"input_contract": [
{
"name": "source",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "destination",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "MCP-confirmed mutation invocation receipt; the requested final state must be checked separately.",
"schema": {
"oneOf": [
{
"type": "object",
"properties": {
"operation": {
"type": "string"
},
"status": {
"const": "success"
},
"completed": {
"const": true
}
},
"required": [
"status",
"operation",
"completed"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"operation": {
"type": "string"
},
"status": {
"const": "error"
},
"completed": {
"const": false
},
"error_code": {
"enum": [
"mcp_operation_failed",
"mcp_transport_failure"
]
},
"error_type": {
"type": "string"
}
},
"required": [
"status",
"operation",
"completed",
"error_code"
],
"additionalProperties": false
}
]
},
"result_status": {
"payload_path": "status",
"success_values": [
"success"
],
"failure_values": [
"error"
]
}
}
},
"routing": {
"family": "filesystem-mutation",
"intent_tags": [
"move a local file",
"rename a file",
"relocate a file to another path"
],
"negative_intents": [
"edit text inside a file",
"write a new file",
"list directory entries"
]
},
"execution": {
"runtime": "mcp_server",
"uri": "file://Pool/resources/tools/mcp/mcp.fs_move_file.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 300.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem",
"license": "MIT",
"backed_by": "MCP move_file",
"recognized_public_tool": true,
"source_hash": "sha256:5320f229f08fe73e20097613b475bd7392add519eb60f2de1c9eae236e35bc15",
"local_implementation_uri": "file://Pool/resources/tools/mcp/mcp.fs_move_file.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/mcp/_mcplib.py": "sha256:8c39f008bd1fc31f0457e6e08cb42da72eeeebba3dd1bcb51c277a33b35287f3",
"file://Pool/resources/tools/mcp/_mcp_mutation.py": "sha256:52c9a7780710e30ad44233af885b4ea4145a04d8b9efa40c25916c7b96a939d5"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "source",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "destination",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "MCP-confirmed mutation invocation receipt; the requested final state must be checked separately.",
"schema": {
"oneOf": [
{
"type": "object",
"properties": {
"operation": {
"type": "string"
},
"status": {
"const": "success"
},
"completed": {
"const": true
}
},
"required": [
"status",
"operation",
"completed"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"operation": {
"type": "string"
},
"status": {
"const": "error"
},
"completed": {
"const": false
},
"error_code": {
"enum": [
"mcp_operation_failed",
"mcp_transport_failure"
]
},
"error_type": {
"type": "string"
}
},
"required": [
"status",
"operation",
"completed",
"error_code"
],
"additionalProperties": false
}
]
},
"result_status": {
"payload_path": "status",
"success_values": [
"success"
],
"failure_values": [
"error"
]
}
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "mcp",
"version": "==1.28.1",
"required": true
}
],
"node_packages": [
{
"name": "@modelcontextprotocol/server-filesystem",
"version": "==2026.7.10",
"required": true
}
],
"system_packages": [],
"commands": [
"mcp-server-filesystem"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"mcp": {
"server_command": "mcp-server-filesystem",
"working_directory": "/app",
"allowed_roots": [
"/app"
]
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.mcp.fs_read_file.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Read the complete textual contents of one known local file without modifying it.",
"description": "Use when a workflow already knows the path of one text file and needs its contents for analysis or a later operation. It reads one file only; it does not search for files, enumerate directories, parse binary documents, or write changes.",
"domain_tags": [
"filesystem",
"text-file-reading",
"source-inspection"
],
"core_primitives": [
"read_text_file",
"load_file_contents",
"inspect_known_file"
],
"problem_space": "Load the text contents of one explicit local file. This is single-file content access, distinct from finding files by a pattern, reading multiple files, listing folders, editing content, and extracting specialized document formats.",
"execution_semantics": {
"determinism": "deterministic",
"side_effects": "none",
"effect_targets": [],
"modalities": [
"text"
]
}
},
"constraint": {
"io_signature": "Input: one local text-file path. Output: text contents of that file.",
"accepted_inputs": [
"an existing readable local text-file path within allowed roots"
],
"output_shape": "plain text file content.",
"limitations": [
"does not discover unknown files or search file contents",
"does not modify files or parse binary document formats"
]
},
"io": {
"input_contract": [
{
"name": "path",
"kind": "file_path",
"required": true,
"cli_position": 1,
"content_encoding": "utf-8"
}
],
"output_contract": {
"artifact_type": "text",
"description": "Read a text file's contents via MCP filesystem server"
}
},
"routing": {
"family": "filesystem-content-read",
"intent_tags": [
"read a known text file",
"inspect source file contents",
"load one file's text"
],
"negative_intents": [
"search across files",
"read multiple named files",
"edit or overwrite a file"
]
},
"execution": {
"runtime": "mcp_server",
"uri": "file://Pool/resources/tools/mcp/mcp.fs_read_file.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 300.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem",
"license": "MIT",
"backed_by": "MCP read_text_file",
"recognized_public_tool": true,
"source_hash": "sha256:325286e0fd4e47c5638ffe35de97779e69d73a958bd18955443bbbb490f240cf",
"local_implementation_uri": "file://Pool/resources/tools/mcp/mcp.fs_read_file.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/mcp/_mcplib.py": "sha256:8c39f008bd1fc31f0457e6e08cb42da72eeeebba3dd1bcb51c277a33b35287f3"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "path",
"kind": "file_path",
"required": true,
"cli_position": 1,
"content_encoding": "utf-8"
}
],
"output_contract": {
"artifact_type": "text",
"description": "Read a text file's contents via MCP filesystem server"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "mcp",
"version": "==1.28.1",
"required": true
}
],
"node_packages": [
{
"name": "@modelcontextprotocol/server-filesystem",
"version": "==2026.7.10",
"required": true
}
],
"system_packages": [],
"commands": [
"mcp-server-filesystem"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"mcp": {
"server_command": "mcp-server-filesystem",
"working_directory": "/app",
"allowed_roots": [
"/app"
]
}
}
},
{
"manifest_version": "v2",
"resource_id": "tool.mcp.fs_read_multiple.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Read textual contents from several explicitly named local files in one operation.",
"description": "Use when a workflow already has a bounded set of file paths and needs all their text together. It reads supplied paths only; it does not discover files, traverse directories, search patterns, or modify content.",
"domain_tags": [
"filesystem",
"multi-file-reading",
"source-inspection"
],
"core_primitives": [
"read_multiple_text_files",
"aggregate_known_file_contents",
"batch_content_loading"
],
"problem_space": "Collect text from several known local files in one call. This is bounded multi-file content access, distinct from one-file reading, recursive traversal, filename/content search, and all writes."
},
"constraint": {
"io_signature": "Input: comma-separated local text-file paths. Output: JSON collection of text contents by path.",
"accepted_inputs": [
"one or more existing readable local text-file paths within allowed roots"
],
"output_shape": "JSON mapping or collection of requested paths and their text contents.",
"limitations": [
"does not locate files by a pattern or scan a directory",
"does not edit files or read arbitrary binary documents"
]
},
"io": {
"input_contract": [
{
"name": "paths",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Read multiple files at once via MCP filesystem server",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "filesystem-content-read",
"intent_tags": [
"read several named files",
"load multiple source files",
"collect text from known paths"
],
"negative_intents": [
"search for files",
"read one file only",
"write or edit files"
]
},
"execution": {
"runtime": "mcp_server",
"uri": "file://Pool/resources/tools/mcp/mcp.fs_read_multiple.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 300.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem",
"license": "MIT",
"backed_by": "MCP read_multiple_files",
"recognized_public_tool": true,
"source_hash": "sha256:5895cac71b06b69348b7bf8a7e5f63657e0c2f3ce7be3dac9dede7ba352156a4",
"local_implementation_uri": "file://Pool/resources/tools/mcp/mcp.fs_read_multiple.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/mcp/_mcplib.py": "sha256:8c39f008bd1fc31f0457e6e08cb42da72eeeebba3dd1bcb51c277a33b35287f3"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "paths",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Read multiple files at once via MCP filesystem server",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "mcp",
"version": "==1.28.1",
"required": true
}
],
"node_packages": [
{
"name": "@modelcontextprotocol/server-filesystem",
"version": "==2026.7.10",
"required": true
}
],
"system_packages": [],
"commands": [
"mcp-server-filesystem"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"mcp": {
"server_command": "mcp-server-filesystem",
"working_directory": "/app",
"allowed_roots": [
"/app"
]
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.mcp.fs_search_files.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Find local files or matching text beneath a specified root using a search pattern.",
"description": "Use to discover paths or occurrences by applying a pattern below a known workspace root. It searches across a tree; it is not a shallow listing, recursive structure report, direct read of a known file, or filesystem mutation.",
"domain_tags": [
"filesystem",
"file-search",
"content-search"
],
"core_primitives": [
"search_files_by_pattern",
"find_matching_paths",
"find_matching_content"
],
"problem_space": "Discover files or content occurrences under a known local root using a search pattern. This is pattern-based filesystem search, distinct from enumerating all immediate children, rendering a directory tree, or reading an already known path."
},
"constraint": {
"io_signature": "Input: local root path and search pattern. Output: JSON search matches with matching paths or content locations.",
"accepted_inputs": [
"an existing local root directory within allowed roots",
"a filename or text search pattern"
],
"output_shape": "JSON list of filesystem search matches.",
"limitations": [
"does not return a complete directory inventory without a pattern",
"does not modify matching files or read an arbitrary file in full"
]
},
"io": {
"input_contract": [
{
"name": "path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "pattern",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Recursively search files by pattern via MCP filesystem server",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "filesystem-search",
"intent_tags": [
"find files by name",
"grep a workspace",
"search file contents by pattern"
],
"negative_intents": [
"list immediate directory entries",
"show a recursive tree",
"read a known file directly"
]
},
"execution": {
"runtime": "mcp_server",
"uri": "file://Pool/resources/tools/mcp/mcp.fs_search_files.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 300.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem",
"license": "MIT",
"backed_by": "MCP search_files",
"recognized_public_tool": true,
"source_hash": "sha256:5a3f0c147055431c81547f0a6bce3266e3b64ce2c3319e1d80fba24bdbdaccd9",
"local_implementation_uri": "file://Pool/resources/tools/mcp/mcp.fs_search_files.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/mcp/_mcplib.py": "sha256:8c39f008bd1fc31f0457e6e08cb42da72eeeebba3dd1bcb51c277a33b35287f3"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "pattern",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Recursively search files by pattern via MCP filesystem server",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "mcp",
"version": "==1.28.1",
"required": true
}
],
"node_packages": [
{
"name": "@modelcontextprotocol/server-filesystem",
"version": "==2026.7.10",
"required": true
}
],
"system_packages": [],
"commands": [
"mcp-server-filesystem"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"mcp": {
"server_command": "mcp-server-filesystem",
"working_directory": "/app",
"allowed_roots": [
"/app"
]
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.mcp.fs_write_file.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Create or overwrite one local text file with supplied complete contents.",
"description": "Use when a workflow must materialize a full text artifact at an explicit path. It writes the provided content as a file; it does not perform a matched in-place edit, move a file, list folders, or search the workspace.",
"domain_tags": [
"filesystem",
"file-writing",
"artifact-creation"
],
"core_primitives": [
"write_complete_text_file",
"create_text_artifact",
"overwrite_file_contents"
],
"operation_kinds": [
"write_complete_text_file"
],
"problem_space": "Create or replace a complete local text artifact at a known path. This is whole-file content mutation, distinct from precise replacement inside an existing file, path relocation, and all read-only filesystem inspection.",
"execution_semantics": {
"determinism": "deterministic",
"side_effects": "declared",
"effect_targets": [
"task_workspace"
],
"modalities": [
"text"
]
}
},
"constraint": {
"io_signature": "Input: destination file path and complete text content. Output: JSON filesystem write result.",
"accepted_inputs": [
"a writable local destination path within allowed roots",
"complete text content to persist"
],
"output_shape": "JSON operation result for file creation or overwrite.",
"limitations": [
"does not require or preserve an old-text match for targeted edits",
"does not read, search, move, or list files"
],
"materialized_artifact_types": [
"plaintext",
"markdown",
"code",
"csv",
"json"
]
},
"io": {
"input_contract": [
{
"name": "path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "content",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Create/overwrite a file via MCP filesystem server",
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "success"
},
"tool": {
"type": "string"
},
"mcp_server": {
"type": "string"
},
"mcp_tool": {
"type": "string"
},
"result": {
"type": "object",
"properties": {
"is_error": {
"type": "boolean"
},
"content": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"is_error",
"content"
],
"additionalProperties": false
}
},
"required": [
"status",
"tool",
"mcp_server",
"mcp_tool",
"result"
],
"additionalProperties": false
},
"result_status": {
"payload_path": "status",
"success_values": [
"success"
],
"failure_values": [
"error"
]
}
}
},
"routing": {
"family": "filesystem-mutation",
"intent_tags": [
"write a text file",
"create an output artifact",
"overwrite a file with content"
],
"negative_intents": [
"replace exact text in an existing file",
"move or rename a file",
"read a file"
]
},
"execution": {
"runtime": "mcp_server",
"uri": "file://Pool/resources/tools/mcp/mcp.fs_write_file.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 300.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem",
"license": "MIT",
"backed_by": "MCP write_file",
"recognized_public_tool": true,
"source_hash": "sha256:477c2650b0bda018270bb5effe9fea58428e478f4b7fd57a10d74287ba9d1df3",
"local_implementation_uri": "file://Pool/resources/tools/mcp/mcp.fs_write_file.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/mcp/_mcplib.py": "sha256:8c39f008bd1fc31f0457e6e08cb42da72eeeebba3dd1bcb51c277a33b35287f3"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "content",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Create/overwrite a file via MCP filesystem server",
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "success"
},
"tool": {
"type": "string"
},
"mcp_server": {
"type": "string"
},
"mcp_tool": {
"type": "string"
},
"result": {
"type": "object",
"properties": {
"is_error": {
"type": "boolean"
},
"content": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"is_error",
"content"
],
"additionalProperties": false
}
},
"required": [
"status",
"tool",
"mcp_server",
"mcp_tool",
"result"
],
"additionalProperties": false
},
"result_status": {
"payload_path": "status",
"success_values": [
"success"
],
"failure_values": [
"error"
]
}
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "mcp",
"version": "==1.28.1",
"required": true
}
],
"node_packages": [
{
"name": "@modelcontextprotocol/server-filesystem",
"version": "==2026.7.10",
"required": true
}
],
"system_packages": [],
"commands": [
"mcp-server-filesystem"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"mcp": {
"server_command": "mcp-server-filesystem",
"working_directory": "/app",
"allowed_roots": [
"/app"
]
}
}
},
{
"manifest_version": "v2",
"resource_id": "tool.mcp.git_add.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"execution_semantics": {
"side_effects": "declared",
"effect_targets": [
"task_workspace"
]
},
"summary": "Stage specified working-tree files in a local Git repository for a later commit.",
"description": "Use to add an explicit set of changed paths to the Git index. It prepares selected changes for review or commit; it does not create a commit, inspect repository status, create a branch, or show a diff.",
"domain_tags": [
"git",
"staging",
"version-control"
],
"core_primitives": [
"stage_selected_paths",
"update_git_index",
"prepare_commit"
],
"problem_space": "Add explicit local repository paths to the Git staging area. This is index management, distinct from recording a commit, listing branch names, inspecting diffs, or reporting worktree status."
},
"constraint": {
"io_signature": "Input: repository path and comma-separated file paths. Output: JSON mutation invocation receipt.",
"accepted_inputs": [
"a local Git repository path",
"one or more paths relative to that repository"
],
"output_shape": "JSON invocation receipt with status, operation, and completed; a failed operation includes error_code. Verify the requested workspace state separately.",
"limitations": [
"does not create a commit",
"does not stage unspecified files or inspect a diff"
]
},
"io": {
"input_contract": [
{
"name": "repo_path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "files",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "MCP-confirmed mutation invocation receipt; the requested final state must be checked separately.",
"schema": {
"oneOf": [
{
"type": "object",
"properties": {
"operation": {
"type": "string"
},
"status": {
"const": "success"
},
"completed": {
"const": true
}
},
"required": [
"status",
"operation",
"completed"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"operation": {
"type": "string"
},
"status": {
"const": "error"
},
"completed": {
"const": false
},
"error_code": {
"enum": [
"mcp_operation_failed",
"mcp_transport_failure"
]
},
"error_type": {
"type": "string"
}
},
"required": [
"status",
"operation",
"completed",
"error_code"
],
"additionalProperties": false
}
]
},
"result_status": {
"payload_path": "status",
"success_values": [
"success"
],
"failure_values": [
"error"
]
}
}
},
"routing": {
"family": "git-index-management",
"intent_tags": [
"stage selected changes",
"git add files",
"prepare files for a commit"
],
"negative_intents": [
"create a commit",
"show git status",
"view a diff"
]
},
"execution": {
"runtime": "mcp_server",
"uri": "file://Pool/resources/tools/mcp/mcp.git_add.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 300.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/modelcontextprotocol/servers/tree/main/src/git",
"license": "MIT",
"backed_by": "MCP git_add",
"recognized_public_tool": true,
"source_hash": "sha256:8e44f7a6725b237c42f6a182e0cc6d4f748f64810789ba0486bed430738a30fc",
"local_implementation_uri": "file://Pool/resources/tools/mcp/mcp.git_add.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/mcp/_mcplib.py": "sha256:8c39f008bd1fc31f0457e6e08cb42da72eeeebba3dd1bcb51c277a33b35287f3",
"file://Pool/resources/tools/mcp/_mcp_mutation.py": "sha256:52c9a7780710e30ad44233af885b4ea4145a04d8b9efa40c25916c7b96a939d5"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "repo_path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "files",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "MCP-confirmed mutation invocation receipt; the requested final state must be checked separately.",
"schema": {
"oneOf": [
{
"type": "object",
"properties": {
"operation": {
"type": "string"
},
"status": {
"const": "success"
},
"completed": {
"const": true
}
},
"required": [
"status",
"operation",
"completed"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"operation": {
"type": "string"
},
"status": {
"const": "error"
},
"completed": {
"const": false
},
"error_code": {
"enum": [
"mcp_operation_failed",
"mcp_transport_failure"
]
},
"error_type": {
"type": "string"
}
},
"required": [
"status",
"operation",
"completed",
"error_code"
],
"additionalProperties": false
}
]
},
"result_status": {
"payload_path": "status",
"success_values": [
"success"
],
"failure_values": [
"error"
]
}
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "mcp",
"version": "==1.28.1",
"required": true
},
{
"name": "mcp-server-git",
"version": "==2026.7.10",
"required": true
}
],
"node_packages": [],
"system_packages": [
{
"name": "git",
"version": "image-locked",
"required": true
}
],
"commands": [
"git",
"python"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"mcp": {
"server_command": "git",
"working_directory": "/app",
"allowed_roots": [
"/app"
]
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.mcp.git_branch_list.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "List local branch names in a specified Git repository.",
"description": "Use to inspect which local branches exist before selecting or creating one. It is branch inventory only; it does not switch branches, create branches, show commits, stage files, or mutate repository state.",
"domain_tags": [
"git",
"branch-inspection",
"version-control"
],
"core_primitives": [
"list_local_branches",
"inspect_branch_names",
"identify_branch_context"
],
"problem_space": "Inspect local branch names in a known Git repository. This is branch discovery, distinct from branch creation, commit-history inspection, worktree status, staging, and repository mutation."
},
"constraint": {
"io_signature": "Input: local Git repository path. Output: JSON list of local branch names.",
"accepted_inputs": [
"a local directory containing a Git repository"
],
"output_shape": "JSON collection of local branch records or names.",
"limitations": [
"does not create, delete, switch, or merge branches",
"does not show commit history or working-tree changes"
]
},
"io": {
"input_contract": [
{
"name": "repo_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "List branches via MCP git server",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "git-branch-inspection",
"intent_tags": [
"list local Git branches",
"inspect branch names",
"see available branches"
],
"negative_intents": [
"create a new branch",
"switch branches",
"show commit log"
]
},
"execution": {
"runtime": "mcp_server",
"uri": "file://Pool/resources/tools/mcp/mcp.git_branch_list.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 300.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/modelcontextprotocol/servers/tree/main/src/git",
"license": "MIT",
"backed_by": "MCP git_branch",
"recognized_public_tool": true,
"source_hash": "sha256:3ff5ccc631df3de2e66c397e4c0dd2a1f8fdc2d3dd13816a4ce295f09b5736c7",
"local_implementation_uri": "file://Pool/resources/tools/mcp/mcp.git_branch_list.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/mcp/_mcplib.py": "sha256:8c39f008bd1fc31f0457e6e08cb42da72eeeebba3dd1bcb51c277a33b35287f3"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "repo_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "List branches via MCP git server",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "mcp",
"version": "==1.28.1",
"required": true
},
{
"name": "mcp-server-git",
"version": "==2026.7.10",
"required": true
}
],
"node_packages": [],
"system_packages": [
{
"name": "git",
"version": "image-locked",
"required": true
}
],
"commands": [
"git",
"python"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"mcp": {
"server_command": "git",
"working_directory": "/app",
"allowed_roots": [
"/app"
]
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.mcp.git_commit.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"execution_semantics": {
"side_effects": "declared",
"effect_targets": [
"task_workspace"
]
},
"summary": "Create a Git commit from the repository's already staged changes using a supplied message.",
"description": "Use to record the current Git index as a new repository revision after staging is complete. It creates a history entry; it does not choose files to stage, inspect a diff, create a branch, or alter unstaged changes.",
"domain_tags": [
"git",
"commit-creation",
"version-control"
],
"core_primitives": [
"commit_staged_changes",
"record_repository_revision",
"write_commit_message"
],
"problem_space": "Record already staged repository changes as one Git commit with a supplied message. This is history mutation, distinct from staging paths, inspecting status or diffs, and creating a branch."
},
"constraint": {
"io_signature": "Input: local Git repository path and commit message. Output: JSON mutation invocation receipt.",
"accepted_inputs": [
"a local Git repository with staged changes",
"a non-empty commit message"
],
"output_shape": "JSON invocation receipt with status, operation, and completed; a failed operation includes error_code. Verify the requested workspace state separately.",
"limitations": [
"does not stage files or select unstaged changes",
"does not create branches or display repository history"
]
},
"io": {
"input_contract": [
{
"name": "repo_path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "message",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "MCP-confirmed mutation invocation receipt; the requested final state must be checked separately.",
"schema": {
"oneOf": [
{
"type": "object",
"properties": {
"operation": {
"type": "string"
},
"status": {
"const": "success"
},
"completed": {
"const": true
}
},
"required": [
"status",
"operation",
"completed"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"operation": {
"type": "string"
},
"status": {
"const": "error"
},
"completed": {
"const": false
},
"error_code": {
"enum": [
"mcp_operation_failed",
"mcp_transport_failure"
]
},
"error_type": {
"type": "string"
}
},
"required": [
"status",
"operation",
"completed",
"error_code"
],
"additionalProperties": false
}
]
},
"result_status": {
"payload_path": "status",
"success_values": [
"success"
],
"failure_values": [
"error"
]
}
}
},
"routing": {
"family": "git-history-mutation",
"intent_tags": [
"create a Git commit",
"commit staged changes",
"record a repository revision"
],
"negative_intents": [
"stage files",
"show git status",
"create a branch"
]
},
"execution": {
"runtime": "mcp_server",
"uri": "file://Pool/resources/tools/mcp/mcp.git_commit.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 300.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/modelcontextprotocol/servers/tree/main/src/git",
"license": "MIT",
"backed_by": "MCP git_commit",
"recognized_public_tool": true,
"source_hash": "sha256:c849da16ae29689891a35a0ac49066a32127450dc993ae178a7dd03b7265f017",
"local_implementation_uri": "file://Pool/resources/tools/mcp/mcp.git_commit.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/mcp/_mcplib.py": "sha256:8c39f008bd1fc31f0457e6e08cb42da72eeeebba3dd1bcb51c277a33b35287f3",
"file://Pool/resources/tools/mcp/_mcp_mutation.py": "sha256:52c9a7780710e30ad44233af885b4ea4145a04d8b9efa40c25916c7b96a939d5"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "repo_path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "message",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "MCP-confirmed mutation invocation receipt; the requested final state must be checked separately.",
"schema": {
"oneOf": [
{
"type": "object",
"properties": {
"operation": {
"type": "string"
},
"status": {
"const": "success"
},
"completed": {
"const": true
}
},
"required": [
"status",
"operation",
"completed"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"operation": {
"type": "string"
},
"status": {
"const": "error"
},
"completed": {
"const": false
},
"error_code": {
"enum": [
"mcp_operation_failed",
"mcp_transport_failure"
]
},
"error_type": {
"type": "string"
}
},
"required": [
"status",
"operation",
"completed",
"error_code"
],
"additionalProperties": false
}
]
},
"result_status": {
"payload_path": "status",
"success_values": [
"success"
],
"failure_values": [
"error"
]
}
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "mcp",
"version": "==1.28.1",
"required": true
},
{
"name": "mcp-server-git",
"version": "==2026.7.10",
"required": true
}
],
"node_packages": [],
"system_packages": [
{
"name": "git",
"version": "image-locked",
"required": true
}
],
"commands": [
"git",
"python"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"mcp": {
"server_command": "git",
"working_directory": "/app",
"allowed_roots": [
"/app"
]
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.mcp.git_create_branch.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"execution_semantics": {
"side_effects": "declared",
"effect_targets": [
"task_workspace"
]
},
"summary": "Create a named Git branch in a specified local repository.",
"description": "Use when a repository needs a new named branch for an isolated line of work. It creates branch metadata only; it does not list branches, commit changes, stage files, or inspect history.",
"domain_tags": [
"git",
"branch-creation",
"version-control"
],
"core_primitives": [
"create_named_branch",
"initialize_feature_branch",
"branch_repository_history"
],
"problem_space": "Create a named branch in a known local Git repository. This is branch mutation, distinct from inspecting existing branches, staging changes, creating commits, or viewing history."
},
"constraint": {
"io_signature": "Input: local Git repository path and new branch name. Output: JSON mutation invocation receipt.",
"accepted_inputs": [
"a local directory containing a Git repository",
"a valid new branch name"
],
"output_shape": "JSON invocation receipt with status, operation, and completed; a failed operation includes error_code. Verify the requested workspace state separately.",
"limitations": [
"does not list or switch existing branches",
"does not stage files or create a commit"
]
},
"io": {
"input_contract": [
{
"name": "repo_path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "branch_name",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "MCP-confirmed mutation invocation receipt; the requested final state must be checked separately.",
"schema": {
"oneOf": [
{
"type": "object",
"properties": {
"operation": {
"type": "string"
},
"status": {
"const": "success"
},
"completed": {
"const": true
}
},
"required": [
"status",
"operation",
"completed"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"operation": {
"type": "string"
},
"status": {
"const": "error"
},
"completed": {
"const": false
},
"error_code": {
"enum": [
"mcp_operation_failed",
"mcp_transport_failure"
]
},
"error_type": {
"type": "string"
}
},
"required": [
"status",
"operation",
"completed",
"error_code"
],
"additionalProperties": false
}
]
},
"result_status": {
"payload_path": "status",
"success_values": [
"success"
],
"failure_values": [
"error"
]
}
}
},
"routing": {
"family": "git-branch-mutation",
"intent_tags": [
"create a Git branch",
"start a feature branch",
"make a named branch"
],
"negative_intents": [
"list existing branches",
"commit changes",
"show git history"
]
},
"execution": {
"runtime": "mcp_server",
"uri": "file://Pool/resources/tools/mcp/mcp.git_create_branch.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 300.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/modelcontextprotocol/servers/tree/main/src/git",
"license": "MIT",
"backed_by": "MCP git_create_branch",
"recognized_public_tool": true,
"source_hash": "sha256:1260444d2658fc7f3870346a0e7d72459e960278fbf979a7709c84fe49ae1090",
"local_implementation_uri": "file://Pool/resources/tools/mcp/mcp.git_create_branch.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/mcp/_mcplib.py": "sha256:8c39f008bd1fc31f0457e6e08cb42da72eeeebba3dd1bcb51c277a33b35287f3",
"file://Pool/resources/tools/mcp/_mcp_mutation.py": "sha256:52c9a7780710e30ad44233af885b4ea4145a04d8b9efa40c25916c7b96a939d5"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "repo_path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "branch_name",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "MCP-confirmed mutation invocation receipt; the requested final state must be checked separately.",
"schema": {
"oneOf": [
{
"type": "object",
"properties": {
"operation": {
"type": "string"
},
"status": {
"const": "success"
},
"completed": {
"const": true
}
},
"required": [
"status",
"operation",
"completed"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"operation": {
"type": "string"
},
"status": {
"const": "error"
},
"completed": {
"const": false
},
"error_code": {
"enum": [
"mcp_operation_failed",
"mcp_transport_failure"
]
},
"error_type": {
"type": "string"
}
},
"required": [
"status",
"operation",
"completed",
"error_code"
],
"additionalProperties": false
}
]
},
"result_status": {
"payload_path": "status",
"success_values": [
"success"
],
"failure_values": [
"error"
]
}
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "mcp",
"version": "==1.28.1",
"required": true
},
{
"name": "mcp-server-git",
"version": "==2026.7.10",
"required": true
}
],
"node_packages": [],
"system_packages": [
{
"name": "git",
"version": "image-locked",
"required": true
}
],
"commands": [
"git",
"python"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"mcp": {
"server_command": "git",
"working_directory": "/app",
"allowed_roots": [
"/app"
]
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.mcp.git_diff_staged.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Show the patch between the Git index and the last committed revision.",
"description": "Use to review changes that have already been staged for a possible commit. It reports the index diff; it does not show unstaged worktree edits, stage files, create commits, or change repository state.",
"domain_tags": [
"git",
"staged-diff",
"change-review"
],
"core_primitives": [
"inspect_index_diff",
"review_staged_patch",
"compare_staged_changes"
],
"problem_space": "Review the patch formed by staged Git index changes. This is staged-change inspection, distinct from unstaged worktree diff, status summary, commit creation, and staging mutation."
},
"constraint": {
"io_signature": "Input: local Git repository path. Output: JSON or text patch for staged changes.",
"accepted_inputs": [
"a local directory containing a Git repository"
],
"output_shape": "patch representation of index changes relative to HEAD.",
"limitations": [
"does not include unstaged working-tree edits",
"does not stage, commit, or modify repository files"
]
},
"io": {
"input_contract": [
{
"name": "repo_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "text",
"description": "Staged diff via MCP git server"
}
},
"routing": {
"family": "git-change-inspection",
"intent_tags": [
"show staged diff",
"review indexed changes",
"see what will be committed"
],
"negative_intents": [
"show unstaged diff",
"stage files",
"create a commit"
]
},
"execution": {
"runtime": "mcp_server",
"uri": "file://Pool/resources/tools/mcp/mcp.git_diff_staged.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 300.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/modelcontextprotocol/servers/tree/main/src/git",
"license": "MIT",
"backed_by": "MCP git_diff_staged",
"recognized_public_tool": true,
"source_hash": "sha256:2392311d601ef19d29c44e50e69da32588c65ed05dfdfff190d60fe4193b8e91",
"local_implementation_uri": "file://Pool/resources/tools/mcp/mcp.git_diff_staged.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/mcp/_mcplib.py": "sha256:8c39f008bd1fc31f0457e6e08cb42da72eeeebba3dd1bcb51c277a33b35287f3"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "repo_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "text",
"description": "Staged diff via MCP git server"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "mcp",
"version": "==1.28.1",
"required": true
},
{
"name": "mcp-server-git",
"version": "==2026.7.10",
"required": true
}
],
"node_packages": [],
"system_packages": [
{
"name": "git",
"version": "image-locked",
"required": true
}
],
"commands": [
"git",
"python"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"mcp": {
"server_command": "git",
"working_directory": "/app",
"allowed_roots": [
"/app"
]
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.mcp.git_diff_unstaged.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Show uncommitted working-tree changes that have not been staged in Git.",
"description": "Use to review edits still outside the Git index before deciding whether to stage them. It compares the working tree to the index; it does not show only staged changes, stage files, commit changes, or mutate the repository.",
"domain_tags": [
"git",
"unstaged-diff",
"change-review"
],
"core_primitives": [
"inspect_worktree_diff",
"review_unstaged_patch",
"compare_unstaged_changes"
],
"problem_space": "Review modifications in the Git working tree that have not entered the staging index. This is unstaged-change inspection, distinct from reviewing an index diff, status summary, staging, and committing."
},
"constraint": {
"io_signature": "Input: local Git repository path. Output: JSON or text patch for unstaged working-tree changes.",
"accepted_inputs": [
"a local directory containing a Git repository"
],
"output_shape": "patch representation of working-tree changes relative to the index.",
"limitations": [
"does not show only staged index changes",
"does not stage, commit, or modify repository files"
]
},
"io": {
"input_contract": [
{
"name": "repo_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "text",
"description": "Unstaged diff via MCP git server"
}
},
"routing": {
"family": "git-change-inspection",
"intent_tags": [
"show unstaged diff",
"review uncommitted edits",
"see working tree changes"
],
"negative_intents": [
"show staged diff",
"stage files",
"create a commit"
]
},
"execution": {
"runtime": "mcp_server",
"uri": "file://Pool/resources/tools/mcp/mcp.git_diff_unstaged.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 300.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/modelcontextprotocol/servers/tree/main/src/git",
"license": "MIT",
"backed_by": "MCP git_diff_unstaged",
"recognized_public_tool": true,
"source_hash": "sha256:227ad0b33e64e90012f7de7d22417e63a74990040c824ec1f0f6f1b4a3992d56",
"local_implementation_uri": "file://Pool/resources/tools/mcp/mcp.git_diff_unstaged.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/mcp/_mcplib.py": "sha256:8c39f008bd1fc31f0457e6e08cb42da72eeeebba3dd1bcb51c277a33b35287f3"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "repo_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "text",
"description": "Unstaged diff via MCP git server"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "mcp",
"version": "==1.28.1",
"required": true
},
{
"name": "mcp-server-git",
"version": "==2026.7.10",
"required": true
}
],
"node_packages": [],
"system_packages": [
{
"name": "git",
"version": "image-locked",
"required": true
}
],
"commands": [
"git",
"python"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"mcp": {
"server_command": "git",
"working_directory": "/app",
"allowed_roots": [
"/app"
]
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.mcp.git_log.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "List recent commits from a local Git repository, optionally limited by count.",
"description": "Use to inspect repository revision history as a sequence of commits. It lists history summaries; it does not show a specific commit patch, compare working changes, create commits, or mutate branches.",
"domain_tags": [
"git",
"commit-history",
"history-inspection"
],
"core_primitives": [
"list_recent_commits",
"inspect_revision_history",
"limit_commit_history"
],
"problem_space": "Inspect a chronological list of commits in a known local Git repository. This is history listing, distinct from showing one revision's full patch, reviewing diffs, and all Git mutations."
},
"constraint": {
"io_signature": "Input: local Git repository path and optional maximum commit count. Output: JSON commit-history list.",
"accepted_inputs": [
"a local directory containing a Git repository",
"an optional positive commit-count limit"
],
"output_shape": "JSON collection of commit summary records.",
"limitations": [
"does not show a selected commit's complete patch",
"does not alter branches, files, index, or history"
]
},
"io": {
"input_contract": [
{
"name": "repo_path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "max_count",
"kind": "string",
"required": false,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Commit log via MCP git server",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "git-history-inspection",
"intent_tags": [
"list recent commits",
"show Git log",
"inspect commit history"
],
"negative_intents": [
"show one commit patch",
"show working-tree diff",
"create a commit"
]
},
"execution": {
"runtime": "mcp_server",
"uri": "file://Pool/resources/tools/mcp/mcp.git_log.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 300.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/modelcontextprotocol/servers/tree/main/src/git",
"license": "MIT",
"backed_by": "MCP git_log",
"recognized_public_tool": true,
"source_hash": "sha256:ad4ee03c4a892fabdf17c0329fc9a145dfcec032c0d5ce1f430e66af3068ee78",
"local_implementation_uri": "file://Pool/resources/tools/mcp/mcp.git_log.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/mcp/_mcplib.py": "sha256:8c39f008bd1fc31f0457e6e08cb42da72eeeebba3dd1bcb51c277a33b35287f3"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "repo_path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "max_count",
"kind": "string",
"required": false,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Commit log via MCP git server",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "mcp",
"version": "==1.28.1",
"required": true
},
{
"name": "mcp-server-git",
"version": "==2026.7.10",
"required": true
}
],
"node_packages": [],
"system_packages": [
{
"name": "git",
"version": "image-locked",
"required": true
}
],
"commands": [
"git",
"python"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"mcp": {
"server_command": "git",
"working_directory": "/app",
"allowed_roots": [
"/app"
]
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.mcp.git_show.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Show the metadata and patch for one specified Git revision.",
"description": "Use when a workflow needs the details of a known commit or revision, including its message and changed content. It inspects one selected revision; it does not list history, compare uncommitted work, or mutate the repository.",
"domain_tags": [
"git",
"revision-inspection",
"commit-patch"
],
"core_primitives": [
"show_selected_revision",
"inspect_commit_patch",
"read_commit_metadata"
],
"problem_space": "Inspect a named Git revision and its patch in a known local repository. This is single-revision inspection, distinct from listing commit history, staged or unstaged diff review, and repository mutation."
},
"constraint": {
"io_signature": "Input: local Git repository path and revision identifier. Output: text or JSON commit metadata and patch.",
"accepted_inputs": [
"a local directory containing a Git repository",
"a commit hash, tag, or revision expression"
],
"output_shape": "commit details with patch content for the selected revision.",
"limitations": [
"does not list a sequence of commits",
"does not show uncommitted working-tree changes or mutate history"
]
},
"io": {
"input_contract": [
{
"name": "repo_path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "revision",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "text",
"description": "Show a commit via MCP git server"
}
},
"routing": {
"family": "git-history-inspection",
"intent_tags": [
"show a Git commit",
"inspect a commit patch",
"view a specific revision"
],
"negative_intents": [
"list commit history",
"show unstaged changes",
"create a commit"
]
},
"execution": {
"runtime": "mcp_server",
"uri": "file://Pool/resources/tools/mcp/mcp.git_show.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 300.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/modelcontextprotocol/servers/tree/main/src/git",
"license": "MIT",
"backed_by": "MCP git_show",
"recognized_public_tool": true,
"source_hash": "sha256:147ea9fc4f35230b4379819a7337242304440f51c64f47c2b1082b2f40b90cf9",
"local_implementation_uri": "file://Pool/resources/tools/mcp/mcp.git_show.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/mcp/_mcplib.py": "sha256:8c39f008bd1fc31f0457e6e08cb42da72eeeebba3dd1bcb51c277a33b35287f3"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "repo_path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "revision",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "text",
"description": "Show a commit via MCP git server"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "mcp",
"version": "==1.28.1",
"required": true
},
{
"name": "mcp-server-git",
"version": "==2026.7.10",
"required": true
}
],
"node_packages": [],
"system_packages": [
{
"name": "git",
"version": "image-locked",
"required": true
}
],
"commands": [
"git",
"python"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"mcp": {
"server_command": "git",
"working_directory": "/app",
"allowed_roots": [
"/app"
]
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.mcp.git_status.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Report staged, unstaged, and untracked state for a local Git working tree.",
"description": "Use to obtain a concise repository status summary before deciding what to stage, review, or commit. It reports the current worktree and index state; it does not display patch content, stage paths, create commits, or change branches.",
"domain_tags": [
"git",
"worktree-status",
"repository-inspection"
],
"core_primitives": [
"inspect_worktree_status",
"identify_staged_unstaged_untracked",
"summarize_repository_state"
],
"problem_space": "Summarize the current state of a local Git repository, including staged, unstaged, and untracked paths. This is state inspection, distinct from patch-level diff review, staging, committing, or branch mutation."
},
"constraint": {
"io_signature": "Input: local Git repository path. Output: text or JSON summary of worktree and index status.",
"accepted_inputs": [
"a local directory containing a Git repository"
],
"output_shape": "repository status entries grouped by staging state.",
"limitations": [
"does not display full file patches",
"does not stage, commit, switch branches, or alter files"
]
},
"io": {
"input_contract": [
{
"name": "repo_path",
"kind": "directory_path",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "text",
"description": "Working-tree status via MCP git server"
}
},
"routing": {
"family": "git-worktree-inspection",
"intent_tags": [
"show git status",
"inspect staged unstaged and untracked files",
"summarize repository state"
],
"negative_intents": [
"show a diff patch",
"stage files",
"create a commit"
]
},
"execution": {
"runtime": "mcp_server",
"uri": "file://Pool/resources/tools/mcp/mcp.git_status.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 300.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/modelcontextprotocol/servers/tree/main/src/git",
"license": "MIT",
"backed_by": "MCP git_status",
"recognized_public_tool": true,
"source_hash": "sha256:9cc23e685662933e070d6608f40411ab1aa810f6d2db22bc59bdc03a27a5b77a",
"local_implementation_uri": "file://Pool/resources/tools/mcp/mcp.git_status.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/mcp/_mcplib.py": "sha256:8c39f008bd1fc31f0457e6e08cb42da72eeeebba3dd1bcb51c277a33b35287f3"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "repo_path",
"kind": "directory_path",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "text",
"description": "Working-tree status via MCP git server"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "mcp",
"version": "==1.28.1",
"required": true
},
{
"name": "mcp-server-git",
"version": "==2026.7.10",
"required": true
}
],
"node_packages": [],
"system_packages": [
{
"name": "git",
"version": "image-locked",
"required": true
}
],
"commands": [
"git",
"python"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"mcp": {
"server_command": "git",
"working_directory": "/app",
"allowed_roots": [
"/app"
]
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.mcp.sequential_thinking.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Record a bounded, explicit sequence of reasoning steps for one supplied problem statement.",
"description": "Use when a workflow needs a structured thought trace to decompose, revise, or check a reasoning process. It organizes supplied reasoning through sequential steps; it does not execute code, inspect local files, retrieve external data, or guarantee factual grounding.",
"domain_tags": [
"reasoning",
"problem-decomposition",
"thought-tracing"
],
"core_primitives": [
"decompose_problem",
"record_reasoning_step",
"revise_thought_sequence"
],
"problem_space": "Structure a bounded sequence of explicit reasoning steps for an already supplied problem. This is deliberation support, distinct from deterministic computation, code execution, filesystem access, web research, or external-data retrieval."
},
"constraint": {
"io_signature": "Input: one problem or thought string. Output: JSON sequential-thinking record.",
"accepted_inputs": [
"a textual problem statement or intermediate reasoning step"
],
"output_shape": "JSON thought record with step position and continuation state.",
"limitations": [
"does not execute tools, code, or mathematical solvers",
"does not retrieve files, web content, APIs, or independent evidence"
]
},
"io": {
"input_contract": [
{
"name": "problem",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Structured step-by-step reasoning (MCP)",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "reasoning-structure",
"intent_tags": [
"break a problem into reasoning steps",
"maintain a sequential thought trace",
"revise an analysis step"
],
"negative_intents": [
"run code or a solver",
"search external information",
"read local files"
]
},
"execution": {
"runtime": "mcp_server",
"uri": "file://Pool/resources/tools/mcp/mcp.sequential_thinking.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/modelcontextprotocol/servers/tree/main/src/sequentialthinking",
"license": "MIT",
"recognized_public_tool": true,
"source_hash": "sha256:5d44e859b5a63b8e19ae7c5d25869a1a92bc41e4527effeeab4aed1b07481fa7",
"local_implementation_uri": "file://Pool/resources/tools/mcp/mcp.sequential_thinking.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/mcp/_mcplib.py": "sha256:8c39f008bd1fc31f0457e6e08cb42da72eeeebba3dd1bcb51c277a33b35287f3"
}
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "problem",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Structured step-by-step reasoning (MCP)",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "mcp",
"version": "==1.28.1",
"required": true
}
],
"node_packages": [
{
"name": "@modelcontextprotocol/server-sequential-thinking",
"version": "==2026.7.4",
"required": true
}
],
"system_packages": [],
"commands": [
"mcp-server-sequential-thinking"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"mcp": {
"server_command": "mcp-server-sequential-thinking",
"working_directory": "/app",
"allowed_roots": [
"/app"
]
},
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.memory_profiler_exporter.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Run one Python script and report sampled peak RSS, or report this wrapper's RSS",
"description": "With an existing script path, launches that file using the current Python interpreter with no forwarded arguments and busy-polls psutil RSS until exit. With no argument or a non-existing path, it reports the wrapper process's current RSS. It exports only a JSON metric envelope, not a profile file.",
"core_primitives": [
"execute_python_script_subprocess",
"sample_child_process_rss",
"report_process_memory_metric"
],
"problem_space": "Coarse process-RSS observation for one executable Python script or the wrapper itself; not line-by-line profiling, leak detection, child-tree accounting, safe code analysis, or profile-file export.",
"domain_tags": [
"Python",
"performance-optimization",
"memory-management"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"psutil Python package"
],
"io_signature": "Input: optional script_path string at CLI position 1. Existing paths are executed as `[sys.executable, script_path]`; omission or a non-existing path selects current-wrapper RSS mode. Output: JSON envelope with child exit_code and peak_rss_bytes, or current_process_rss_bytes.",
"accepted_inputs": [
"no argument to measure the wrapper interpreter's current RSS",
"an existing Python script path whose code is intentionally authorized to execute without extra arguments"
],
"output_shape": "Existing script path after child exit: {status: \"success\", tool: \"psutil\", target: string, exit_code: integer, peak_rss_bytes: integer}, wrapper exits 0 regardless of child exit. No argument or non-existing path: {status: \"success\", tool: \"psutil\", target: null, current_process_rss_bytes: integer}, exit 0. Launch, permission, psutil, or wait failures are uncaught and may traceback; there is no structured timeout error.",
"limitations": [
"executes arbitrary Python code from an existing path with the wrapper's permissions and inherited working directory/environment; the child may modify files, access the network, or have other side effects",
"a non-existing supplied path is not reported as an error and silently falls back to measuring the wrapper process",
"samples only the direct process RSS in a busy loop, excludes child processes, provides no timeline or line attribution, and is nondeterministic",
"captures but never drains child stdout/stderr, so a verbose child can block on full pipes; there is no timeout, termination policy, output forwarding, or profile-file export"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
],
"execution_risk": "high"
},
"io": {
"input_contract": [
{
"name": "script_path",
"kind": "string",
"required": false,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing either sampled direct-child peak RSS and exit code or the wrapper process's current RSS; no profile file is exported.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "python-process-rss-measurement",
"intent_tags": [
"run a Python script and sample its peak RSS",
"report the current wrapper process RSS"
],
"negative_intents": [
"perform line by line Python memory profiling",
"detect memory leaks or profile child process trees",
"safely inspect Python code without executing it",
"export a memory profile file or capture child output"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/memory_profiler_exporter.py",
"execution_status": "active",
"execution_risk": "high"
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/giampaolo/psutil",
"license": "BSD",
"backed_by": "per-process memory profile via psutil",
"recognized_public_tool": true,
"source_hash": "sha256:d03fea4a1f1c57fbf27aa254ee3bbfe4f2448c8fff32bdac1cbc410e7fc4879b",
"local_implementation_uri": "file://Pool/resources/tools/script/memory_profiler_exporter.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": false
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"Python",
"performance-optimization",
"memory-management"
]
},
"input_contract": [
{
"name": "script_path",
"kind": "string",
"required": false,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing either sampled direct-child peak RSS and exit code or the wrapper process's current RSS; no profile file is exported.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "psutil",
"version": "==6.1.1",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.npm_audit_json_exporter.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Run npm audit --json for one local project and return its report envelope",
"description": "Invokes `npm audit --json --prefix <project_dir>` where a directory input is used directly and a file input contributes its parent directory. npm exit codes 0 and 1 are treated as completed audits, and parsed npm JSON is returned in `result`; no report file is exported.",
"core_primitives": [
"resolve_npm_project_directory",
"run_npm_audit_json",
"capture_parsed_npm_audit_report"
],
"problem_space": "Read-only invocation of npm's dependency advisory audit for a local lockfile-backed project; not vulnerability remediation, package installation, static source scanning, offline CVE lookup, or JSON report-file export.",
"domain_tags": [
"security-audit",
"software-engineering",
"dependency-management"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"npm executable on PATH",
"a usable npm registry/network configuration and a supported lockfile in the resolved project directory"
],
"io_signature": "Input: required file_path string naming an existing project directory or file such as package.json; files resolve to their absolute parent directory. Executes `npm audit --json --prefix <dir>`. Output: uniform JSON execution envelope with parsed report in result when npm emits one.",
"accepted_inputs": [
"an existing npm project directory",
"an existing file path whose parent directory is the intended npm project, typically package.json"
],
"output_shape": "npm exit 0 or 1: {status: \"success\", tool: \"npm\", target: string, exit_code: 0|1, result: object|array|scalar|null, stdout: string|null, stderr: string|null}. The helper tries to parse stdout first and stderr second; whenever either stream parses as one non-null JSON value, result receives it and stdout is set to null. Thus non-JSON stdout is discarded from the envelope when stderr supplies parseable JSON, while stderr still retains its original text. Other npm exits use status=\"tool_error\" and propagate the exit code. Missing input, executable, or 180-second timeout yields {status: \"error\", tool: \"npm\", message: string}, exiting 2/3/4. Missing argument prints usage to stderr and exits 1 without JSON.",
"limitations": [
"does not run `npm audit fix`, install packages, modify manifests intentionally, or export a report file; it only invokes npm audit and returns its output",
"audit findings and report schema depend on npm version, registry advisory state, lockfile contents, network availability, authentication, and configuration, so results are nondeterministic",
"file inputs are not verified to be package.json and simply select their parent directory; npm decides project validity",
"uses a fixed 180-second timeout with no output truncation; if stdout is non-JSON but stderr is JSON, stderr is parsed into result and the helper still forces stdout=null, losing the original non-JSON stdout"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope containing npm's parsed audit report when available, raw streams otherwise, and npm exit metadata; no report file is written.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "npm-dependency-advisory-audit",
"intent_tags": [
"run npm audit and capture its JSON report",
"inspect npm lockfile dependencies for registry advisories"
],
"negative_intents": [
"automatically fix npm vulnerabilities",
"install update or remove npm packages",
"export an npm audit report file",
"scan JavaScript source code for security bugs"
],
"dependency_slots": []
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://docs.npmjs.com/cli/commands/npm-audit",
"license": "Artistic-2.0",
"backed_by": "npm audit",
"recognized_public_tool": true,
"source_hash": "sha256:47c6c5e5128248cc17057d91ef575d22efb7e7d635b0ac229b01a5c4864a8edf",
"local_implementation_uri": "file://Pool/resources/tools/script/npm_audit_json_exporter.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": false
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/npm_audit_json_exporter.py",
"execution_status": "active"
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"security-audit",
"software-engineering",
"dependency-management"
]
},
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope containing npm's parsed audit report when available, raw streams otherwise, and npm exit metadata; no report file is written.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [],
"commands": [
"npm"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.npm_package_auditor.v1",
"resource_type": "Tool",
"status": "inactive",
"capability": {
"summary": "Inspect metadata for an inactive legacy alias of npm_audit_json_exporter",
"description": "Inactive legacy manifest retained for compatibility metadata only. Its bundled script is behaviorally identical to npm_audit_json_exporter and must not be selected as a normal npm audit capability.",
"core_primitives": [
"identify_legacy_duplicate_npm_wrapper",
"inspect_inactive_alias_metadata"
],
"problem_space": "Compatibility inspection of an inactive, exactly duplicated npm-audit wrapper manifest; ordinary npm advisory audits route to active npm_audit_json_exporter instead.",
"domain_tags": [
"npm",
"security-audit",
"dependency-management"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"npm executable on PATH",
"a usable npm registry/network configuration and a supported lockfile in the resolved project directory"
],
"io_signature": "Input: required file_path string naming an existing project directory or file; files resolve to their absolute parent directory. Executes `npm audit --json --prefix <dir>`. Output: JSON execution envelope with parsed npm report when available.",
"accepted_inputs": [
"an existing npm project directory",
"an existing file path whose parent directory is the intended npm project, typically package.json"
],
"output_shape": "Retained legacy execution contract: npm exit 0 or 1 yields {status: \"success\", tool: \"npm\", target: string, exit_code: 0|1, result: JSON value|null, stdout: string|null, stderr: string|null}. The helper tries stdout then stderr; if stdout is non-JSON but stderr is one JSON document, result contains parsed stderr and stdout is still set to null. Other npm exits use status=\"tool_error\" and propagate the exit code. Missing input, executable, or 180-second timeout yields {status: \"error\", tool: \"npm\", message: string}, exiting 2/3/4. This inactive alias is excluded from normal indexing.",
"limitations": [
"inactive legacy duplicate retained only for metadata compatibility; use active npm_audit_json_exporter for ordinary audits",
"provides no distinct audit, package, license, policy, compliance, remediation, or source-analysis behavior",
"the retained helper parses stdout first and stderr second, and suppresses stdout whenever either stream parses as JSON; therefore non-JSON stdout can be lost when stderr contains JSON",
"legacy execution results depend on npm, registry, lockfile, network, authentication, and configuration and remain nondeterministic"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope containing npm's parsed audit report when available, raw streams otherwise, and npm exit metadata."
}
},
"routing": {
"family": "legacy-duplicate-npm-audit-alias-metadata",
"intent_tags": [
"identify legacy duplicate npm audit wrapper",
"inspect deprecated npm package auditor alias metadata"
],
"negative_intents": [
"run a normal npm dependency audit",
"automatically fix npm vulnerabilities",
"perform package license policy or compliance auditing",
"scan JavaScript source code for security bugs"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/npm_package_auditor.py",
"execution_status": "inactive"
},
"utility": {
"latency_ms": 200,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://docs.npmjs.com/cli/commands/npm-audit",
"license": "Artistic-2.0",
"backed_by": "npm audit",
"recognized_public_tool": true,
"source_hash": "sha256:55985317f79f114b8ff226bfb2906e0c87cef6ae22df0a0f59f91e503d17ba23",
"local_implementation_uri": "file://Pool/resources/tools/script/npm_package_auditor.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": false
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"npm",
"security-audit",
"dependency-management"
]
},
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope containing npm's parsed audit report when available, raw streams otherwise, and npm exit metadata."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [],
"commands": [
"npm"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.npm_test_runner.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Run npm test in a local project and capture its process output",
"description": "Runs exactly `[npm, test]` with cwd set from the explicitly supplied project_dir directory string. The script reads CLI position 1, while the contract intentionally avoids a *_path name so orchestrator file-artifact binding does not misclassify the directory input.",
"core_primitives": [
"resolve_npm_test_working_directory",
"execute_npm_test_script",
"capture_test_process_streams_and_exit"
],
"problem_space": "Execution of a project's package.json test lifecycle script through npm; not Jest-specific structured reporting, test discovery, dependency installation, advisory auditing, or safe static inspection.",
"domain_tags": [
"JavaScript",
"testing",
"automation"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"npm executable on PATH",
"a local npm project whose package.json defines a usable test script and whose dependencies are available"
],
"io_signature": "Input: required project_dir string at CLI position 1, explicitly supplied as an existing npm project directory. Because project_dir is kind=string and does not end in *_path, automatic file-artifact binding does not infer this directory. Executes `npm test`. Output: JSON envelope with exit_code and raw streams; no clean field is emitted.",
"accepted_inputs": [
"an explicitly bound string naming an existing npm project directory whose package.json defines the test lifecycle"
],
"output_shape": "npm exit 0 or 1: {status: \"success\", tool: \"npm\", target: string, exit_code: 0|1, result: null, stdout: string, stderr: string|null}, wrapper exit 0. Exit 1 may mean test failures or some npm lifecycle/operation errors but still has outer status=success; no clean key exists, so consumers must inspect exit_code and streams. Other npm exits use status=\"tool_error\" and propagate the exit code. Missing target, executable, or 300-second timeout: {status: \"error\", tool: \"npm\", message: string}, exiting 2/3/4. Missing argument prints usage to stderr and exits 1 without JSON.",
"limitations": [
"executes arbitrary commands configured by the project's npm test lifecycle with inherited permissions and environment; tests may modify files, spawn processes, or access networks",
"does not install dependencies, select a test framework, add npm flags, or parse framework-specific test cases",
"wraps exit 1 with outer status=success even though it can represent test failures or npm operation errors; because no clean field is emitted, inspect exit_code and stdout/stderr",
"project_dir is deliberately a plain string contract and does not trigger the orchestrator's *_path file-only heuristic; callers must bind the directory explicitly and automatic artifact binding does not guarantee directory inference",
"uses a fixed 300-second timeout, captures untruncated stdout/stderr in memory, and is nondeterministic"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
],
"execution_risk": "high"
},
"io": {
"input_contract": [
{
"name": "project_dir",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON npm-test envelope with exit code and raw streams; exit 1 still has outer status=success and no clean field, and project scripts may have side effects.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "npm-project-test-execution",
"intent_tags": [
"run the package json npm test script",
"execute npm tests and capture console output"
],
"negative_intents": [
"run Jest with structured Jest JSON results",
"audit npm dependencies for vulnerabilities",
"install npm dependencies or safely inspect tests without execution"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/npm_test_runner.py",
"execution_status": "active",
"execution_risk": "high"
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://docs.npmjs.com",
"license": "Artistic-2.0",
"backed_by": "npm test",
"recognized_public_tool": true,
"source_hash": "sha256:bae57ccc3e7efba1a9c385ed5b123f4646be045ed51e0d4d54cf18540777d171",
"local_implementation_uri": "file://Pool/resources/tools/script/npm_test_runner.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": false
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"JavaScript",
"testing",
"automation"
]
},
"input_contract": [
{
"name": "project_dir",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON npm-test envelope with exit code and raw streams; exit 1 still has outer status=success and no clean field, and project scripts may have side effects.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [],
"commands": [
"npm"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.pdf_text_extract.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Extract complete text for an explicit page range from a text-bearing PDF.",
"description": "Uses pdfplumber to return ordered per-page text for the full document or a caller-selected inclusive page range without silently truncating the selected range.",
"domain_tags": [
"document-processing",
"pdf",
"text-extraction"
],
"core_primitives": [
"extract_complete_pdf_text_range"
],
"operation_kinds": [
"extract_complete_pdf_text_range"
],
"problem_space": "Deterministic text extraction from all or selected PDF pages for downstream search, reasoning, and exact-answer generation.",
"execution_semantics": {
"determinism": "deterministic",
"side_effects": "none",
"effect_targets": [],
"modalities": [
"document",
"text"
]
}
},
"constraint": {
"io_signature": "Input: PDF path plus optional 1-based inclusive start_page and end_page. Output: typed JSON containing every selected page's complete extracted text.",
"accepted_inputs": [
"a readable text-bearing PDF supported by pdfplumber",
"an optional valid page range"
],
"artifact_input": [
"pdf",
"file"
],
"artifact_output": [
"json",
"text"
],
"output_shape": "Success contains page_count, selected range, range_complete=true, and ordered pages [{page,text}]. Invalid ranges or unreadable PDFs return a typed error envelope and non-zero exit.",
"limitations": [
"does not perform OCR, so image-only pages usually return empty text",
"does not preserve layout, coordinates, images, or table structure",
"large selected ranges can produce large JSON results; callers should select a narrower range when task evidence permits"
]
},
"io": {
"input_contract": [
{
"name": "pdf_path",
"kind": "file_path",
"artifact_types": [
"pdf"
],
"extensions": [
".pdf"
],
"required": true,
"cli_position": 1
},
{
"name": "start_page",
"kind": "integer",
"required": false,
"cli_position": 2
},
{
"name": "end_page",
"kind": "integer",
"required": false,
"cli_position": 3
}
],
"output_contract": {
"artifact_type": "json",
"description": "Complete per-page text for the requested inclusive PDF page range.",
"json_schema": {
"oneOf": [
{
"type": "object",
"properties": {
"status": {
"const": "success"
},
"tool": {
"const": "pdfplumber"
},
"page_count": {
"type": "integer",
"minimum": 0
},
"range_start": {
"type": "integer",
"minimum": 1
},
"range_end": {
"type": "integer",
"minimum": 1
},
"range_complete": {
"const": true
},
"pages": {
"type": "array",
"items": {
"type": "object",
"properties": {
"page": {
"type": "integer",
"minimum": 1
},
"text": {
"type": "string"
}
},
"required": [
"page",
"text"
],
"additionalProperties": false
}
}
},
"required": [
"status",
"tool",
"page_count",
"range_start",
"range_end",
"range_complete",
"pages"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"status": {
"const": "error"
},
"tool": {
"const": "pdfplumber"
},
"message": {
"type": "string",
"minLength": 1
}
},
"required": [
"status",
"tool",
"message"
],
"additionalProperties": false
}
]
},
"result_status": {
"payload_path": "status",
"success_values": [
"success"
],
"failure_values": [
"error"
]
}
}
},
"routing": {
"family": "pdf-complete-page-range-text-extraction",
"intent_tags": [
"extract complete text from a PDF",
"read a selected PDF page range",
"inspect a text-bearing PDF attachment"
],
"negative_intents": [
"OCR scanned PDF pages",
"extract PDF tables with cell structure",
"render PDF pages as images"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/pdf_text_extract.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 250,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/jsvine/pdfplumber",
"license": "MIT",
"backed_by": "pdfplumber",
"recognized_public_tool": true,
"source_hash": "sha256:aa47ef0ccebb55d3768a6cd62c417b12eac254f5a00c6d61cd425b3c1d97499f",
"local_implementation_uri": "file://Pool/resources/tools/script/pdf_text_extract.py"
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"document-processing",
"pdf",
"text-extraction"
]
},
"input_contract": [
{
"name": "pdf_path",
"kind": "file_path",
"artifact_types": [
"pdf"
],
"extensions": [
".pdf"
],
"required": true,
"cli_position": 1
},
{
"name": "start_page",
"kind": "integer",
"required": false,
"cli_position": 2
},
{
"name": "end_page",
"kind": "integer",
"required": false,
"cli_position": 3
}
],
"output_contract": {
"artifact_type": "json",
"description": "Complete per-page text for the requested inclusive PDF page range.",
"json_schema": {
"oneOf": [
{
"type": "object",
"properties": {
"status": {
"const": "success"
},
"tool": {
"const": "pdfplumber"
},
"page_count": {
"type": "integer",
"minimum": 0
},
"range_start": {
"type": "integer",
"minimum": 1
},
"range_end": {
"type": "integer",
"minimum": 1
},
"range_complete": {
"const": true
},
"pages": {
"type": "array",
"items": {
"type": "object",
"properties": {
"page": {
"type": "integer",
"minimum": 1
},
"text": {
"type": "string"
}
},
"required": [
"page",
"text"
],
"additionalProperties": false
}
}
},
"required": [
"status",
"tool",
"page_count",
"range_start",
"range_end",
"range_complete",
"pages"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"status": {
"const": "error"
},
"tool": {
"const": "pdfplumber"
},
"message": {
"type": "string",
"minLength": 1
}
},
"required": [
"status",
"tool",
"message"
],
"additionalProperties": false
}
]
},
"result_status": {
"payload_path": "status",
"success_values": [
"success"
],
"failure_values": [
"error"
]
}
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "pdfplumber",
"version": "==0.11.4",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.pdflatex_compile_runner.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Compile one LaTeX source file with pdflatex inside the task container",
"description": "Runs the task-container pdflatex compiler on one .tex source and reports the deterministic PDF and log artifacts.",
"core_primitives": [
"compile_latex_document",
"verify_latex_build_artifact"
],
"operation_kinds": [
"compile_latex_document"
],
"problem_space": "Deterministic LaTeX source compilation and log production; not document editing, synonym selection, or layout repair.",
"domain_tags": [
"latex",
"deterministic_compilation",
"document_build"
]
},
"constraint": {
"io_signature": "Input: one task-container .tex source path and optional sibling output directory. Output: JSON status envelope with compiler streams, exit code, latency, and produced PDF/log files.",
"accepted_inputs": [
"one existing .tex file inside the task container",
"optional source-directory output path"
],
"output_shape": "{status: ok|failed|timeout, source_path: string, output_path: string, produced_files: [string], exit_code: integer, stdout: string, stderr: string, latency_ms: integer}",
"limitations": [
"requires pdflatex in the task image",
"does not edit or synthesize LaTeX source",
"does not access host paths",
"maximum compiler invocation is 300 seconds"
],
"artifact_input": [
"latex_source"
],
"artifact_output": [
"file"
]
},
"io": {
"input_contract": [
{
"name": "source_path",
"kind": "file_path",
"required": true,
"extensions": [
".tex"
],
"cli_position": 1
},
{
"name": "output_dir",
"kind": "directory_path",
"required": false,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "file",
"description": "Deterministically compiled LaTeX PDF and compiler log.",
"schema_hint": {
"type": "object",
"properties": {
"status": {
"type": "string"
},
"produced_files": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"status",
"produced_files"
],
"additionalProperties": true
}
}
},
"routing": {
"family": "deterministic-latex-compilation",
"intent_tags": [
"compile LaTeX document",
"run pdflatex",
"build PDF from tex source",
"check LaTeX compilation"
],
"negative_intents": [
"edit LaTeX source",
"repair overfull hboxes",
"synthesize synonym replacements"
],
"dependency_slots": []
},
"execution": {
"runtime": "shell_script",
"runtime_scope": "task_container",
"uri": "file://Pool/resources/tools/script/pdflatex_compile_runner.sh",
"execution_status": "active",
"execution_risk": "low"
},
"utility": {
"latency_ms": 3000,
"token_cost_factor": 0.0,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "LaTeX reference compiler",
"license": "LPPL-compatible",
"backed_by": "pdflatex",
"recognized_public_tool": true,
"auth_required": false,
"local_implementation_uri": "file://Pool/resources/tools/script/pdflatex_compile_runner.sh",
"source_hash": "sha256:05db2bed02233899127c0e57f9fee1242a844b17aa418dd489cc48d1b4a036ba"
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"runtime_requirements": {
"runtime_profile": "task-container",
"runtime_kind": "shell_script",
"python_packages": [],
"node_packages": [],
"system_packages": [],
"commands": [
"sh",
"pdflatex"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"docker_image": "task-image-provided"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.portable_write_text.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Create or overwrite one local text file with supplied complete contents.",
"description": "Write supplied complete UTF-8 text to an explicit workspace file using only the task Python standard library.",
"domain_tags": [
"filesystem",
"file-writing",
"artifact-creation"
],
"core_primitives": [
"write_complete_text_file",
"create_text_artifact",
"overwrite_file_contents"
],
"operation_kinds": [
"write_complete_text_file"
],
"problem_space": "Create or replace a complete local text artifact at a known path. This is whole-file content mutation, distinct from precise replacement inside an existing file, path relocation, and all read-only filesystem inspection.",
"execution_semantics": {
"determinism": "deterministic",
"side_effects": "declared",
"effect_targets": [
"task_workspace"
],
"modalities": [
"text"
]
}
},
"constraint": {
"io_signature": "Input: destination workspace file path and complete UTF-8 text content. Output: JSON success receipt.",
"accepted_inputs": [
"a writable local destination path within allowed roots",
"complete text content to persist"
],
"output_shape": "JSON status and write acknowledgment without the file content or path.",
"limitations": [
"does not require or preserve an old-text match for targeted edits",
"does not read, search, move, or list files"
],
"materialized_artifact_types": [
"plaintext",
"markdown",
"code",
"csv",
"json"
]
},
"io": {
"input_contract": [
{
"name": "path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "content",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Safe local text-file write receipt",
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "success"
},
"written": {
"type": "boolean",
"const": true
}
},
"required": [
"status",
"written"
],
"additionalProperties": false
},
"result_status": {
"payload_path": "status",
"success_values": [
"success"
],
"failure_values": [
"error"
]
}
}
},
"routing": {
"family": "filesystem-mutation",
"intent_tags": [
"write a text file",
"create an output artifact",
"overwrite a file with content"
],
"negative_intents": [
"replace exact text in an existing file",
"move or rename a file",
"read a file"
]
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/portable_write_text.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 300.0,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "S-GAR portable tool implementation",
"license": "internal",
"backed_by": "Python standard library",
"recognized_public_tool": false,
"source_hash": "sha256:dd991bd14fe9738103519fd1c9875a3a3f62512d12ad4cc46918c63fc624bcb3",
"local_implementation_uri": "file://Pool/resources/tools/script/portable_write_text.py"
},
"type_specific": {},
"type": {
"resource_type": "Tool"
},
"input_contract": [
{
"name": "path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "content",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Safe local text-file write receipt",
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "success"
},
"written": {
"type": "boolean",
"const": true
}
},
"required": [
"status",
"written"
],
"additionalProperties": false
},
"result_status": {
"payload_path": "status",
"success_values": [
"success"
],
"failure_values": [
"error"
]
}
},
"runtime_requirements": {
"runtime_profile": "host-python-stdlib",
"python": "",
"python_packages": [],
"node_packages": [],
"system_packages": [],
"commands": [
"python3"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0
}
},
{
"manifest_version": "v2",
"resource_id": "tool.posix_shell.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Execute an authorized POSIX shell program in the selected task runtime without Python.",
"description": "Run a supplied POSIX shell program using the task working directory, environment and installed commands. Supports deterministic inspection and mutations when those commands are available; an adaptive Controller may use repeated observations. The resource itself does not decide task correctness or repair commands.",
"domain_tags": [
"terminal",
"filesystem",
"system_administration",
"software_engineering"
],
"core_primitives": [
"execute_shell_commands"
],
"operation_kinds": [
"execute_shell_commands"
],
"execution_semantics": {
"determinism": "unknown",
"side_effects": "declared",
"effect_targets": [
"task_workspace"
],
"modalities": [
"text"
]
}
},
"constraint": {
"io_signature": "Input: one complete POSIX shell program string. Output: JSON status, exit_code, stdout and stderr for a completed program, including nonzero exits.",
"accepted_inputs": [
"A POSIX shell program supported by the selected runtime and authorized task."
],
"output_shape": "Typed JSON process report. No semantic success is inferred and captured stream content is not rewritten.",
"limitations": [
"Requires sh in the selected runtime; other commands and dependencies must be inspected or otherwise established.",
"Executes with the permissions and network policy of the selected task runtime; it is not a sandbox, rollback facility, or semantic verifier.",
"Program literals are not path-mapped. Use the current working directory and authorized runtime input bindings, not host paths or assumed physical workspace roots.",
"Does not parse JSON arguments or require Python. The caller must request sufficient observations to check task state and output requirements."
],
"artifact_input": [
"plaintext"
],
"artifact_output": [
"json"
],
"execution_risk": "high"
},
"io": {
"input_contract": [
{
"name": "script",
"kind": "string",
"required": true,
"cli_position": 1,
"description": "Complete POSIX shell program, passed as one argument. Use the current task working directory and bound task evidence; do not assume Python, Bash extensions, or other commands are installed."
}
],
"output_contract": {
"artifact_type": "json",
"description": "Completed program report with exact UTF-8 stdout/stderr and exit code. Declared error results remain observations; successful execution alone does not prove task correctness.",
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"success",
"error"
]
},
"exit_code": {
"type": "integer"
},
"stdout": {
"type": "string"
},
"stderr": {
"type": "string"
}
},
"required": [
"status",
"exit_code",
"stdout",
"stderr"
],
"additionalProperties": false
},
"result_status": {
"payload_path": "status",
"success_values": [
"success"
],
"failure_values": [
"error"
]
}
}
},
"input_contract": [
{
"name": "script",
"kind": "string",
"required": true,
"cli_position": 1,
"description": "Complete POSIX shell program, passed as one argument. Use the current task working directory and bound task evidence; do not assume Python, Bash extensions, or other commands are installed."
}
],
"output_contract": {
"artifact_type": "json",
"description": "Completed program report with exact UTF-8 stdout/stderr and exit code. Declared error results remain observations; successful execution alone does not prove task correctness.",
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"success",
"error"
]
},
"exit_code": {
"type": "integer"
},
"stdout": {
"type": "string"
},
"stderr": {
"type": "string"
}
},
"required": [
"status",
"exit_code",
"stdout",
"stderr"
],
"additionalProperties": false
},
"result_status": {
"payload_path": "status",
"success_values": [
"success"
],
"failure_values": [
"error"
]
}
},
"routing": {
"family": "task-terminal-execution",
"intent_tags": [
"inspect task runtime",
"execute shell commands",
"configure task environment"
],
"negative_intents": [
"execute on the control host",
"guarantee commands are installed",
"infer success without task verification"
]
},
"execution": {
"runtime": "shell_script",
"uri": "file://Pool/resources/tools/native_shell/execute.sh",
"execution_status": "active"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "",
"python_packages": [],
"node_packages": [],
"system_packages": [],
"commands": [
"sh",
"mktemp",
"od",
"awk",
"rm"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1"
},
"utility": {
"latency_ms": 0.0,
"token_cost_factor": 0.0,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "SGAR native POSIX shell adapter",
"license": "internal",
"backed_by": "Task runtime POSIX shell",
"recognized_public_tool": false,
"source_hash": "sha256:abad191b190ce387ebe2f91aa01a6877cebea4724fecb560a040f22d06af02f7",
"local_implementation_uri": "file://Pool/resources/tools/native_shell/execute.sh"
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "shell",
"deterministic": false
}
},
"type": {
"resource_type": "Tool"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.pptx2text.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Extract non-empty text-frame content from each slide in a PPTX file",
"description": "Opens one local presentation with python-pptx, walks slides and shapes in library order, joins non-empty shape text with newlines per slide, and returns slide records in a JSON envelope.",
"core_primitives": [
"open_local_pptx_presentation",
"extract_slide_shape_text_frames",
"group_text_by_slide"
],
"problem_space": "Read-only plain-text extraction from text-frame-bearing shapes in PPTX slides; not presentation rendering, OCR, speaker-note extraction, layout preservation, table/media analysis, or PPT/PDF conversion.",
"domain_tags": [
"file-processing",
"text-extraction",
"automation"
],
"execution_semantics": {
"determinism": "deterministic",
"side_effects": "none",
"effect_targets": []
}
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"python-pptx Python package"
],
"io_signature": "Input: required file_path string naming an existing PPTX-compatible presentation. Output: JSON envelope with slide_count and ordered slides [{slide, text}], or a handled open/extraction error.",
"accepted_inputs": [
"an existing PowerPoint Open XML presentation readable by python-pptx"
],
"output_shape": "Success: {status: \"success\", tool: \"python-pptx\", target: string, slide_count: integer, slides: [{slide: integer, text: string}]}, exit 0. Slides without non-empty text-frame shapes have text=\"\". Missing path: {status: \"error\", message: string}, exit 2. Any caught open or extraction exception: {status: \"error\", tool: \"python-pptx\", message: string}, exit 1. Missing argument prints usage to stderr and exits 1 without JSON.",
"limitations": [
"extracts only shapes for which python-pptx reports has_text_frame and does not guarantee table-cell text, chart labels, SmartArt, embedded objects, images/OCR, or speaker notes",
"flattens each slide to newline-joined plain text and does not preserve coordinates, styles, runs, reading order semantics, animations, or hyperlinks",
"has no timeout, slide/text cap, or output truncation and does not modify the presentation"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1,
"artifact_types": [
"pptx"
],
"extensions": [
".pptx"
]
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing slide count and per-slide newline-joined text-frame content, or a handled extraction error.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "pptx-slide-text-frame-extraction",
"intent_tags": [
"extract text from PPTX slide shapes",
"summarize slide text by slide number"
],
"negative_intents": [
"extract speaker notes tables charts or image OCR comprehensively",
"preserve PowerPoint layout formatting or reading order",
"edit render or convert a presentation"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/pptx2text.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 200,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://python-pptx.readthedocs.io",
"license": "MIT",
"backed_by": "PPTX text extraction via python-pptx",
"recognized_public_tool": true,
"source_hash": "sha256:240aff7af95dfe8120562461a09e5b9e3e51c6c357fe3cfc4a7ec90e6db1618f",
"local_implementation_uri": "file://Pool/resources/tools/script/pptx2text.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"file-processing",
"text-extraction",
"automation"
]
},
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1,
"artifact_types": [
"pptx"
],
"extensions": [
".pptx"
]
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing slide count and per-slide newline-joined text-frame content, or a handled extraction error.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "python-pptx",
"version": "==1.0.2",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.pytest_runner.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Run pytest verbosely on one local target and return raw output plus a heuristic summary",
"description": "Executes `[sys.executable, -m, pytest, target_path, -tb, short, -v]` in the inherited working directory. It returns raw streams and heuristically parsed counts. A normal timed `no tests ran` summary usually matches the regex first and, with pytest exit 5, is labeled failed rather than no_tests.",
"core_primitives": [
"execute_pytest_target",
"capture_pytest_console_streams",
"heuristically_parse_pytest_summary_counts"
],
"problem_space": "Direct pytest execution for a single path with verbose console capture and lightweight summary extraction; not safe test inspection, pytest-json-report output, coverage measurement, test generation, or arbitrary pytest option forwarding.",
"domain_tags": [
"testing-tools",
"Python",
"automation"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"pytest importable by the current Python interpreter",
"the target's test dependencies and plugins available in the inherited environment"
],
"io_signature": "Input: required target_path string naming an existing file or directory. Executes current Python `-m pytest <target> -tb short -v` with inherited cwd. Output: JSON object with status, pytest exit_code, heuristic summary, raw stdout/stderr, or status=error with message.",
"accepted_inputs": [
"an existing Python test file, test directory, or other pytest-collectable local path intentionally authorized for execution"
],
"output_shape": "Completed subprocess: {status: \"passed\"|\"failed\"|\"no_tests\", exit_code: integer, summary: {text: string, passed: integer, failed: integer, errors: integer, skipped: integer}, stdout: string, stderr: string}, wrapper exit 0 regardless of pytest exit. `no_tests` occurs only when the timing-summary regex finds no match and lowercase stdout still contains `no tests ran`; ordinary timed no-test output usually matches first and becomes status=\"failed\" because pytest exits nonzero. Non-existing target or caught launch/parsing exception: {status: \"error\", message: string}, wrapper exit 0. Missing argument prints usage to stderr and exits 1 without JSON.",
"limitations": [
"pytest collection and tests execute arbitrary Python code, plugins, and conftest hooks with inherited permissions/environment and may modify files, spawn processes, or access networks",
"does not set cwd to the target, forward user pytest options, impose a timeout, truncate output, or terminate hanging tests",
"summary parsing requires a specific `=== ... in <decimal>s ===` stdout form and uses substring checks, so counts can be missing or inaccurate across pytest versions and outcomes",
"the no_tests branch is reached only when that regex completely misses and stdout contains `no tests ran`; conventional timed no-test summaries generally match the regex and are reported as failed, not no_tests",
"the wrapper itself exits 0 for missing targets, test failures, collection errors, and caught exceptions; consumers must inspect JSON status and exit_code"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
],
"execution_risk": "high"
},
"io": {
"input_contract": [
{
"name": "target_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON pytest result with raw streams and heuristic counts; conventional timed no-test runs are generally labeled failed rather than no_tests.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "pytest-target-test-execution",
"intent_tags": [
"run pytest on a local test target",
"capture verbose pytest output and basic result counts"
],
"negative_intents": [
"inspect Python tests safely without executing them",
"produce pytest native JSON or coverage reports",
"forward arbitrary pytest options or run npm Jest Go or Rust tests"
],
"dependency_slots": []
},
"utility": {
"latency_ms": 200,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://docs.pytest.org/",
"license": "MIT",
"backed_by": "wraps pytest",
"recognized_public_tool": true,
"source_hash": "sha256:88e3d27395bd30f0c6d90d5e3c662eaccdba3ec7174b05eace9831ae841f895c",
"local_implementation_uri": "file://Pool/resources/tools/script/pytest_runner.py"
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": false
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/pytest_runner.py",
"execution_status": "active",
"execution_risk": "high"
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"testing-tools",
"Python",
"automation"
]
},
"input_contract": [
{
"name": "target_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON pytest result with raw streams and heuristic counts; conventional timed no-test runs are generally labeled failed rather than no_tests.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.python_dead_code_scanner.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Run Vulture on one Python file or directory and return candidate dead-code lines",
"description": "Executes exactly `[vulture, target]`, splits non-empty stdout lines into findings, and reports their count and Vulture exit code. It statically identifies candidates using Vulture defaults and does not execute or modify target code.",
"core_primitives": [
"invoke_vulture_static_scan",
"collect_vulture_stdout_findings",
"count_dead_code_candidates"
],
"problem_space": "Read-only Vulture candidate discovery for unused Python definitions and unreachable code; not proof that code is safe to delete, general linting, type checking, security analysis, execution, or automated cleanup.",
"domain_tags": [
"Python",
"code-analysis",
"software-engineering"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"vulture executable on PATH"
],
"io_signature": "Input: required file_path string naming an existing Python file or directory. Executes `vulture <target>` with inherited cwd and Vulture defaults. Output: JSON envelope containing exit_code, dead_code_count, findings lines, and stderr.",
"accepted_inputs": [
"an existing Python source file",
"an existing directory tree intended for Vulture static analysis"
],
"output_shape": "After Vulture returns: {status: \"success\", tool: \"vulture\", target: string, exit_code: integer, dead_code_count: integer, findings: [string], stderr: string|null}; the wrapper exits 0 regardless of Vulture exit code. Missing target: {status: \"error\", message: string}, exit 2. Missing argument prints usage to stderr and exits 1 without JSON. Missing executable, 120-second timeout, or subprocess launch failure is uncaught and may traceback without JSON.",
"limitations": [
"Vulture reports heuristic candidates and can produce false positives for dynamic imports, reflection, framework callbacks, decorators, plugins, and externally referenced APIs",
"uses only Vulture defaults with no confidence, exclude, ignore-name, or sort options and returns raw finding lines rather than parsed symbols",
"does not execute or modify code, remove findings, run a linter/type checker, or prove that removal is behaviorally safe",
"uses a fixed 120-second subprocess timeout that is not caught into JSON and applies no finding or output truncation"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing Vulture's candidate finding lines, count, exit code, and stderr; no code is changed.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "python-vulture-dead-code-candidate-scan",
"intent_tags": [
"find candidate unused Python code with Vulture",
"scan a Python file or directory for dead code candidates"
],
"negative_intents": [
"delete or automatically clean dead Python code",
"prove code is unreachable or safe to remove",
"run Ruff Flake8 Bandit or execute Python code"
],
"dependency_slots": []
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/jendrikseipp/vulture",
"license": "MIT",
"backed_by": "Vulture dead-code finder",
"recognized_public_tool": true,
"source_hash": "sha256:d785fdbd668baea0faf277b7979ac5ce20170f302bf9dd0338fc4b43ce736224",
"local_implementation_uri": "file://Pool/resources/tools/script/python_dead_code_scanner.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/python_dead_code_scanner.py",
"execution_status": "active"
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"Python",
"code-analysis",
"software-engineering"
]
},
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing Vulture's candidate finding lines, count, exit code, and stderr; no code is changed.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [],
"commands": [
"vulture"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.python_script_runner.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Execute one workspace-local Python script and report output plus detected changed files",
"execution_semantics": {
"side_effects": "declared",
"effect_targets": [
"task_workspace"
]
},
"description": "Validates that the `.py` script and optional run cwd are inside the configured workspace, snapshots the run tree, executes the script with the current interpreter and supplied arguments, then reports stdout, stderr, exit code, latency, and newly seen or mtime-increased files.",
"core_primitives": [
"python_execution",
"generated_code_execution",
"artifact_file_production",
"stdout_stderr_capture",
"json_output"
],
"problem_space": "Authorized execution of arbitrary workspace-local Python code with coarse post-run changed-file detection; not sandboxed evaluation, static analysis, deterministic computation, rollback, comprehensive filesystem auditing, or process isolation.",
"domain_tags": [
"software_engineering",
"code_execution",
"python",
"benchmark_artifact"
]
},
"constraint": {
"env_requirements": [
"python3",
"workspace_only",
"case_workspace_only",
"SGAR_WORKSPACE_ROOT optionally defines the workspace boundary; otherwise the wrapper current directory is used",
"SGAR_HOST_WORKSPACE_ROOT optionally maps host absolute paths into the workspace"
],
"io_signature": "Input: required workspace-contained `.py` script_path, optional args list defaulting to [], and optional cwd string defaulting to `.`. The orchestrator's runner-specific serializer emits `--cwd` and encodes args through `--arg-json`. Output: JSON status envelope with streams/exit and changed-file paths; executed code may modify files.",
"accepted_inputs": [
"a `.py` file resolving inside SGAR_WORKSPACE_ROOT or the wrapper cwd when that variable is unset",
"an optional list of script arguments, including authorized workspace file paths, encoded as repeated CLI tokens, one JSON-array token, or `--arg-json` plus additional tokens",
"an optional workspace-contained directory bound as cwd; omission uses the workspace root represented by `.`"
],
"output_shape": "Normal child completion: {status: \"ok\"|\"failed\", exit_code: integer, script_path: absolute string, cwd: absolute string, stdout: string, stderr: string, produced_files: [absolute string], latency_ms: integer}; wrapper propagates child exit and copies non-empty child stderr to wrapper stderr on failure. Missing/invalid/outside-workspace script or invalid cwd: {status: \"invalid\"|\"blocked\"|\"missing\", error: string}, exit 2.",
"limitations": [
"executes arbitrary Python code with inherited permissions and environment; workspace validation restricts only the selected script path and cwd, not the code's filesystem, subprocess, network, or other side effects",
"changed-file detection scans only run_cwd, skips __pycache__, .git, .venv, and node_modules, reports only new or mtime-increased files, and misses deletions, restored timestamps, and changes outside that tree",
"argument parsing accepts unknown wrapper options as child arguments and environment/path mapping is platform dependent; execution and produced_files are nondeterministic",
"the generic manifest contract has no supported flag field and cannot expose `--arg-json` as an independent option; project orchestration special-cases this resource, serializing declared cwd as `--cwd` and declared args as `--arg-json`"
],
"artifact_input": [
"python_script",
"file"
],
"artifact_output": [
"json"
],
"execution_risk": "high"
},
"io": {
"input_contract": [
{
"name": "script_path",
"kind": "file_path",
"required": true,
"extensions": [
".py"
],
"cli_position": 1
},
{
"name": "args",
"kind": "list",
"accepts_artifact_handle_item": true,
"required": false,
"default": [],
"cli_position": 2
},
{
"name": "cwd",
"kind": "string",
"required": false,
"default": ".",
"cli_position": 3
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution report with streams, exit code, latency, and heuristically detected changed-file paths; produced files are side effects, not the outer artifact.",
"schema_hint": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"oneOf": [
{
"type": "object",
"required": [
"status",
"error"
],
"properties": {
"status": {
"enum": [
"invalid",
"blocked",
"missing",
"timeout"
]
},
"error": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"exit_code",
"script_path",
"cwd",
"stdout",
"stderr",
"produced_files",
"latency_ms"
],
"properties": {
"status": {
"enum": [
"ok",
"failed"
]
},
"exit_code": {
"type": "integer"
},
"script_path": {
"type": "string"
},
"cwd": {
"type": "string"
},
"stdout": {
"type": "string"
},
"stderr": {
"type": "string"
},
"produced_files": {
"type": "array",
"items": {
"type": "string"
}
},
"latency_ms": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
}
]
}
}
},
"routing": {
"family": "workspace-python-script-execution",
"intent_tags": [
"execute an authorized workspace Python script",
"run Python code and report stdout stderr exit and changed files",
"process an authorized workspace file with a generated Python script"
],
"negative_intents": [
"statically analyze Python without executing it",
"run untrusted Python in a secure sandbox",
"guarantee rollback or comprehensive file change tracking",
"lint test format or scan Python source code"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/python_script_runner.py",
"execution_status": "active",
"execution_risk": "high"
},
"utility": {
"latency_ms": 500,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://example.invalid/anonymous-framework",
"license": "internal",
"backed_by": "S-GAR code-execution primitive",
"recognized_public_tool": true,
"source_hash": "sha256:5390bcdd5de3019b0a153affe9634c11f60b9316ab4d2017078d1dcd1f04aabe",
"local_implementation_uri": "file://Pool/resources/tools/script/python_script_runner.py"
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": false
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"software_engineering",
"code_execution",
"python",
"benchmark_artifact"
]
},
"input_contract": [
{
"name": "script_path",
"kind": "file_path",
"required": true,
"extensions": [
".py"
],
"cli_position": 1
},
{
"name": "args",
"kind": "list",
"accepts_artifact_handle_item": true,
"required": false,
"default": [],
"cli_position": 2
},
{
"name": "cwd",
"kind": "string",
"required": false,
"default": ".",
"cli_position": 3
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution report with streams, exit code, latency, and heuristically detected changed-file paths; produced files are side effects, not the outer artifact.",
"schema_hint": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"oneOf": [
{
"type": "object",
"required": [
"status",
"error"
],
"properties": {
"status": {
"enum": [
"invalid",
"blocked",
"missing",
"timeout"
]
},
"error": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"exit_code",
"script_path",
"cwd",
"stdout",
"stderr",
"produced_files",
"latency_ms"
],
"properties": {
"status": {
"enum": [
"ok",
"failed"
]
},
"exit_code": {
"type": "integer"
},
"script_path": {
"type": "string"
},
"cwd": {
"type": "string"
},
"stdout": {
"type": "string"
},
"stderr": {
"type": "string"
},
"produced_files": {
"type": "array",
"items": {
"type": "string"
}
},
"latency_ms": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
}
]
}
},
"runtime_requirements": {
"runtime_profile": "host-python-stdlib",
"python": "",
"python_packages": [],
"node_packages": [],
"system_packages": [],
"commands": [
"python3"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.python_static_analyzer.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Run Pyflakes on one local Python path and return diagnostic lines",
"description": "Executes `[sys.executable, -m, pyflakes, target]`, concatenates stdout then stderr, splits non-empty lines into issues, and reports their count and Pyflakes exit code without executing or modifying analyzed source.",
"core_primitives": [
"invoke_pyflakes_analysis",
"collect_pyflakes_diagnostic_lines",
"count_pyflakes_issues"
],
"problem_space": "Narrow Pyflakes diagnostics for Python syntax/name/unused-import style issues; not comprehensive static analysis, formatting, type checking, security scanning, dead-code proof, runtime testing, or code repair.",
"domain_tags": [
"python",
"static_analysis",
"software_engineering"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"pyflakes importable by the current Python interpreter"
],
"io_signature": "Input: required file_path string naming an existing Python file or path accepted by Pyflakes. Executes current Python `-m pyflakes <target>`. Output: JSON envelope with exit_code, issue_count, and combined stdout/stderr diagnostic lines.",
"accepted_inputs": [
"an existing Python source file intended for Pyflakes analysis",
"an existing path that the installed Pyflakes version accepts as a target"
],
"output_shape": "After Pyflakes returns: {status: \"success\", tool: \"pyflakes\", target: string, exit_code: integer, issue_count: integer, issues: [string]}, wrapper exit 0 regardless of Pyflakes exit. Missing target: {status: \"error\", message: string}, exit 2. Missing argument prints usage to stderr and exits 1 without JSON. A 120-second timeout or subprocess launch failure is uncaught and may traceback.",
"limitations": [
"Pyflakes provides a focused diagnostic set and does not enforce formatting/style rules broadly, infer types, identify security vulnerabilities, or perform Vulture-style dead-code analysis",
"combines stdout and stderr into one unstructured list and counts lines rather than parsed diagnostics; tool/module failures can appear as issues",
"does not execute or modify analyzed code, apply fixes, accept custom flags, or truncate output",
"uses a fixed 120-second timeout that is not converted into a JSON error envelope"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing Pyflakes exit code and combined diagnostic lines with a line count; analyzed code is unchanged.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "python-pyflakes-diagnostic-scan",
"intent_tags": [
"run Pyflakes on a Python source path",
"find undefined names and unused imports with Pyflakes"
],
"negative_intents": [
"perform comprehensive Python static analysis or type checking",
"scan Python code for security vulnerabilities or dead code",
"format fix or execute Python source"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/python_static_analyzer.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/PyCQA/pyflakes",
"license": "MIT",
"backed_by": "Pyflakes static analyzer",
"recognized_public_tool": true,
"source_hash": "sha256:8fa2246657e9b9f111b9eb9971b5b2ab382b2a5a75942bdaf9d233c4609fef76",
"local_implementation_uri": "file://Pool/resources/tools/script/python_static_analyzer.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"python",
"static_analysis",
"software_engineering"
]
},
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing Pyflakes exit code and combined diagnostic lines with a line count; analyzed code is unchanged.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [],
"commands": [
"pylint"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.ripgrep_search.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Search file contents with ripgrep 15.2.0 under explicit bounds",
"description": "Thin SGAR adapter that invokes upstream ripgrep JSON output for read-only regex search rooted at one existing file or directory.",
"domain_tags": [
"repository",
"search",
"file_io"
],
"core_primitives": [
"regex_content_search",
"filter_search_paths",
"return_line_matches"
],
"problem_space": "Fast bounded content search in local trees; not file mutation, shell execution, semantic search, or filesystem discovery outside the supplied root."
},
"constraint": {
"io_signature": "Input pattern, existing root and optional glob/type/context/match bounds; output structured matches with path, line and text.",
"accepted_inputs": [
"ripgrep-compatible regular expression",
"existing local file or directory"
],
"output_shape": "JSON match array, truncation flag and upstream exit code.",
"limitations": [
"honors ripgrep default ignore and binary policies",
"maximum 10000 returned matches",
"60-second timeout",
"read-only but may expose sensitive text within the authorized root"
],
"operation_kinds": [
"local_read",
"content_search"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "pattern",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "root",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "Bounded structured ripgrep matches.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "repository-content-search",
"intent_tags": [
"search source files for text or regex",
"locate matching lines in a repository"
],
"negative_intents": [
"modify files",
"semantic vector search",
"execute matching code"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/ripgrep_search.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 50,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/BurntSushi/ripgrep/tree/15.2.0",
"version": "15.2.0",
"license": "Unlicense",
"license_url": "https://github.com/BurntSushi/ripgrep/blob/15.2.0/UNLICENSE",
"license_sha256": "7e12e5df4bae12cb21581ba157ced20e1986a0508dd10d0e8a4ab9a4cf94e85c",
"upstream_release": "https://github.com/BurntSushi/ripgrep/releases/tag/15.2.0",
"backed_by": "ripgrep",
"recognized_public_tool": true,
"source_hash": "sha256:88d9961b19d5361727e9e4313731a68e737a5eb1b3b13a8a1b4fd30ace45a471",
"local_implementation_uri": "file://Pool/resources/tools/script/ripgrep_search.py"
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [
{
"name": "ripgrep-15.2.0",
"version": "image-locked",
"required": true
}
],
"commands": [
"rg"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.ruff_lint_runner.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Run Ruff check in JSON mode using discovered project configuration",
"description": "Executes exactly `ruff check --output-format json <target>` and returns parsed diagnostics. The wrapper passes neither `--fix` nor `--no-fix`, so discovered configuration such as `fix=true` can modify source; it also passes no `--no-cache`, allowing Ruff's normal cache writes.",
"core_primitives": [
"invoke_configured_ruff_check",
"capture_native_ruff_json_diagnostics",
"report_ruff_exit_status"
],
"problem_space": "Ruff lint checking for one Python file or directory using discovered configuration, with possible configuration-driven fixes and cache writes; not a guaranteed read-only audit, explicit Ruff format workflow, Bandit security scan, type check, or test run.",
"domain_tags": [
"python",
"linting",
"static_analysis"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"ruff executable on PATH",
"any intended Ruff configuration must be discoverable by Ruff from the target and inherited working directory"
],
"io_signature": "Input: required target_path string naming an existing file or directory. Executes `ruff check --output-format json <target>` with inherited cwd/config discovery and without `--no-fix` or `--no-cache`; configuration may enable source fixes and Ruff may write cache state. Output: JSON envelope with parsed diagnostics when valid JSON is emitted.",
"accepted_inputs": [
"an existing Python source file intended for Ruff checking and authorized for possible configuration-driven modification",
"an existing directory tree intended for Ruff checking where normal Ruff cache writes are acceptable"
],
"output_shape": "Ruff exit 0 or 1: {status: \"success\", tool: \"ruff\", target: string, exit_code: 0|1, result: array|object|scalar|null, stdout: string|null, stderr: string|null}; native JSON diagnostics normally appear as an array in result with stdout=null. Diagnostics and exit code may reflect configuration-driven fixes already applied to source, and cache writes are not reported. Other Ruff exits use status=\"tool_error\" and propagate the exit code. Missing target, executable, or 120-second timeout: {status: \"error\", tool: \"ruff\", message: string}, exiting 2/3/4. Missing argument prints usage to stderr and exits 1 without JSON.",
"limitations": [
"does not pass `--no-fix`; project configuration can set `fix=true`, so the wrapper cannot guarantee source files remain unchanged",
"does not pass `--no-cache`; Ruff may create or update its default `.ruff_cache` or configured cache directory",
"uses discovered Ruff rules/configuration without exposing select, ignore, config, target-version, preview, exclude, fix, or cache controls",
"Ruff rule coverage differs from Flake8, Pyflakes, Bandit, type checkers, and dead-code tools; diagnostics are not security or correctness proof",
"uses a fixed 120-second timeout, captures output without truncation, and may preserve raw stdout if Ruff output is not one valid JSON document"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "target_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope containing parsed Ruff check diagnostics, exit code, and raw streams; discovered configuration may enable source fixes and Ruff cache writes."
}
},
"routing": {
"family": "python-ruff-configured-check",
"intent_tags": [
"lint Python code with configured Ruff check",
"get native JSON Ruff diagnostics using project configuration"
],
"negative_intents": [
"guarantee strictly read-only Ruff analysis",
"provide an explicit Ruff format workflow",
"select or disable fixes and cache behavior through manifest inputs",
"run Flake8 Pyflakes Bandit or a type checker",
"execute Python tests or prove code is secure"
],
"dependency_slots": []
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://docs.astral.sh/ruff",
"license": "MIT",
"backed_by": "Ruff linter",
"recognized_public_tool": true,
"source_hash": "sha256:302cc97be966d04254aa1545b7f7d163e022a66e69f3eb13da6528a3e59cc5fb",
"local_implementation_uri": "file://Pool/resources/tools/script/ruff_lint_runner.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": false
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/ruff_lint_runner.py",
"execution_status": "active"
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"python",
"linting",
"static_analysis"
]
},
"input_contract": [
{
"name": "target_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope containing parsed Ruff check diagnostics, exit code, and raw streams; discovered configuration may enable source fixes and Ruff cache writes."
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [],
"commands": [
"ruff"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.rustfmt_checker.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Check rustfmt edition 2021 formatting from one Rust entry file without rewriting files",
"description": "Executes exactly `rustfmt --check --edition 2021 <entry-file>`. The CLI entry is one file, but rustfmt can discover and recursively check out-of-line modules unless configuration changes child handling; `--check` keeps all checked files unmodified.",
"core_primitives": [
"invoke_rustfmt_check_mode",
"capture_rustfmt_check_output",
"report_rustfmt_exit_status"
],
"problem_space": "Read-only rustfmt conformance checking rooted at one Rust entry file under fixed edition 2021, potentially including discoverable out-of-line modules; not isolated-single-file assurance, source rewriting, Clippy, compilation, tests, or multi-edition selection.",
"domain_tags": [
"Rust",
"code-formatting",
"static-analysis"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"rustfmt executable on PATH",
"any intended rustfmt configuration must be discoverable by rustfmt"
],
"io_signature": "Input: required file_path string naming an existing Rust source file. Executes `rustfmt --check --edition 2021 <file>` with inherited cwd. Output: JSON execution envelope with rustfmt exit_code and captured stdout/stderr; source is not intentionally rewritten.",
"accepted_inputs": [
"an existing Rust entry source file intended for edition 2021 rustfmt checking, with any recursively discovered out-of-line module files also authorized for read-only checking"
],
"output_shape": "rustfmt exit 0 or 1: {status: \"success\", tool: \"rustfmt\", target: string, exit_code: 0|1, result: null, stdout: string, stderr: string|null}, wrapper exit 0. Other rustfmt exits: same keys with status=\"tool_error\" and the rustfmt exit code is propagated. Missing file, executable, or 120-second timeout: {status: \"error\", tool: \"rustfmt\", message: string}, exiting 2/3/4. Missing argument prints usage to stderr and exits 1 without JSON.",
"limitations": [
"check-only invocation: `--check` is fixed and the wrapper does not rewrite the source file or return formatted source as a structured field",
"although only one entry file is passed, rustfmt may recursively discover and check out-of-line modules; the wrapper does not pass `--skip-children` and cannot guarantee isolated single-file scope",
"forces `--edition 2021` and exposes no edition, config-path, style-edition, skip-children, or other rustfmt options",
"does not compile Rust, run Clippy, lint semantics, or run tests; rustfmt parse/config errors must be distinguished from formatting differences by exit code and streams",
"uses a fixed 120-second timeout, inherited cwd/config discovery, and no output truncation"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope containing rustfmt check exit code and raw stdout/stderr; the Rust source is not rewritten.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "rust-rustfmt-entry-tree-check-only",
"intent_tags": [
"check Rust formatting from one entry file with rustfmt",
"verify an edition 2021 Rust module tree without rewriting files"
],
"negative_intents": [
"format or rewrite Rust source files",
"guarantee checking only the entry file without following modules",
"run Clippy compile Rust or execute Cargo tests",
"check Rust editions other than fixed edition 2021"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/rustfmt_checker.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/rust-lang/rustfmt",
"license": "MIT/Apache-2.0",
"backed_by": "rustfmt",
"recognized_public_tool": true,
"source_hash": "sha256:98f0b74a9e5f278481920ccaa3279c0b30f835f39bd0bac6940c94d8be91c550",
"local_implementation_uri": "file://Pool/resources/tools/script/rustfmt_checker.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"Rust",
"code-formatting",
"static-analysis"
]
},
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope containing rustfmt check exit code and raw stdout/stderr; the Rust source is not rewritten.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [
{
"name": "rust-1.79.0",
"version": "image-locked",
"required": true
}
],
"commands": [
"rustfmt"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.searxng_search.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Query a self-hosted SearXNG instance and return ranked source records",
"description": "SGAR adapter over upstream SearXNG HTTP JSON API. It performs no search ranking itself and requires a configured self-hosted SearXNG endpoint.",
"domain_tags": [
"web",
"search",
"research"
],
"core_primitives": [
"submit_web_query",
"return_ranked_source_records",
"preserve_engine_metadata"
],
"problem_space": "Internet metasearch through a self-hosted SearXNG instance; not browser automation, source capture, citation extraction, or an API-key search provider."
},
"constraint": {
"io_signature": "Input query and optional category/limit; output ordered records containing title, URL, snippet, engine and optional date/score.",
"accepted_inputs": [
"non-empty web query"
],
"output_shape": "JSON ranked source-record envelope.",
"limitations": [
"requires reachable SearXNG service",
"engine availability and ranking depend on configured upstream engines",
"does not bypass CAPTCHA or rate limits",
"does not store evidence snapshots"
],
"operation_kinds": [
"network_search"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "query",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Ranked SearXNG source records.",
"json_schema": {
"type": "object",
"properties": {
"status": {
"const": "success"
},
"tool": {
"const": "searxng"
},
"query": {
"type": "string",
"minLength": 1
},
"endpoint": {
"type": "string",
"minLength": 1
},
"records": {
"type": "array",
"items": {
"type": "object",
"properties": {
"rank": {
"type": "integer",
"minimum": 1
},
"title": {
"type": [
"string",
"null"
]
},
"url": {
"type": "string",
"minLength": 1
},
"content": {
"type": [
"string",
"null"
]
},
"engine": {
"type": [
"string",
"null"
]
},
"category": {
"type": [
"string",
"null"
]
},
"publishedDate": {
"type": [
"string",
"null"
]
},
"score": {
"type": [
"number",
"null"
]
}
},
"required": [
"rank",
"title",
"url",
"content",
"engine",
"category",
"publishedDate",
"score"
],
"additionalProperties": false
}
},
"result_count": {
"type": "integer",
"minimum": 0
},
"raw_engine_count": {
"type": "integer",
"minimum": 0
}
},
"required": [
"status",
"tool",
"query",
"endpoint",
"records",
"result_count",
"raw_engine_count"
],
"additionalProperties": false
}
}
},
"routing": {
"family": "self-hosted-web-search",
"intent_tags": [
"search the public web",
"find ranked web sources",
"query SearXNG"
],
"negative_intents": [
"fetch a known URL only",
"capture a source snapshot",
"use a key-backed commercial search API"
]
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/searxng_search.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 1000,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/searxng/searxng/tree/e75fd22d09c7fb8b340e9bbef726ea35f46b85e",
"version": "e75fd22d09c7fb8b340e9bbef726ea35f46b85e",
"license": "AGPL-3.0",
"license_url": "https://github.com/searxng/searxng/blob/master/LICENSE",
"license_sha256": "57c8ff33c9c0cfc3ef00e650a1cc910d7ee479a8bc509f6c9209a7c2a11399d6",
"backed_by": "SearXNG",
"recognized_public_tool": true,
"native_network_access": true,
"credential_class": "NONE",
"credential_env_names": [],
"third_party_account_required": false,
"paid_service_required": false,
"source_hash": "sha256:cb3d84665c497c8ef1fe97d3300f31ade2b01137863efc6de06d5ccc3df3d6d9",
"local_implementation_uri": "file://Pool/resources/tools/script/searxng_search.py"
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "httpx",
"version": "==0.28.1",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [
"SEARXNG_BASE_URL"
],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.shellcheck_runner.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Run ShellCheck JSON diagnostics on one local shell script",
"description": "Executes exactly `shellcheck -f json <file>` and returns ShellCheck's parsed diagnostic array in a JSON execution envelope. Exit codes 0 and 1 are treated as completed scans; the script is not modified.",
"core_primitives": [
"invoke_shellcheck_json_scan",
"capture_shellcheck_diagnostics",
"report_shellcheck_exit_status"
],
"problem_space": "Read-only ShellCheck diagnostics for one shell script using fixed JSON output; not shell execution, formatting, automatic fixes, security proof, arbitrary ShellCheck option forwarding, or multi-file project orchestration.",
"domain_tags": [
"shell",
"linting",
"dev_tools"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"shellcheck executable on PATH"
],
"io_signature": "Input: required file_path string naming an existing shell script. Executes `shellcheck -f json <file>` with inherited cwd. Output: JSON envelope with parsed ShellCheck diagnostics, exit code, and raw stream metadata.",
"accepted_inputs": [
"an existing shell script file supported by the installed ShellCheck version"
],
"output_shape": "ShellCheck exit 0 or 1: {status: \"success\", tool: \"shellcheck\", target: string, exit_code: 0|1, result: array|JSON value|null, stdout: string|null, stderr: string|null}; normal native JSON is placed in result with stdout=null. Other exits use status=\"tool_error\" and propagate the exit code. Missing file, executable, or 120-second timeout: {status: \"error\", tool: \"shellcheck\", message: string}, exiting 2/3/4. Missing argument prints usage to stderr and exits 1 without JSON.",
"limitations": [
"does not execute the shell script, apply fixes, rewrite files, or guarantee runtime correctness or security",
"accepts one existing shell-script file; a directory or a multi-file project target is outside this wrapper's input boundary",
"passes only fixed `-f json`; no shell dialect, severity, enable/disable code, external-source, source-path, or exclusion options are exposed",
"uses a fixed 120-second timeout and no output truncation; when stderr rather than stdout parses as JSON, the helper still suppresses stdout"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope containing parsed ShellCheck diagnostics, exit code, and captured streams; the source file is unchanged.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "shell-shellcheck-json-lint",
"intent_tags": [
"lint a shell script with ShellCheck",
"get JSON ShellCheck diagnostics for one file"
],
"negative_intents": [
"execute or format a shell script",
"automatically fix ShellCheck findings",
"lint Python JavaScript CSS or compile code"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/shellcheck_runner.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://www.shellcheck.net",
"license": "GPLv3",
"backed_by": "ShellCheck",
"recognized_public_tool": true,
"source_hash": "sha256:17f515ba3c69885492490337db32ad4cd2d7c4b93db6b280bb11fedf352d480f",
"local_implementation_uri": "file://Pool/resources/tools/script/shellcheck_runner.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"shell",
"linting",
"dev_tools"
]
},
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope containing parsed ShellCheck diagnostics, exit code, and captured streams; the source file is unchanged.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [],
"system_packages": [
{
"name": "shellcheck",
"version": "image-locked",
"required": true
}
],
"commands": [
"shellcheck"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.sql_ddl_to_json_schema.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Extract CREATE TABLE names, columns, types, and constraint-class names from SQL DDL",
"description": "Parses one UTF-8 SQL file with sqlglot's default dialect, keeps CREATE TABLE statements, and returns a custom tables/columns JSON summary. Despite its name, it does not emit a standards-compliant JSON Schema document.",
"core_primitives": [
"parse_sql_ddl_with_sqlglot",
"extract_create_table_columns",
"summarize_sql_types_and_constraint_classes"
],
"problem_space": "Coarse structural extraction from CREATE TABLE DDL into a custom JSON table summary; not JSON Schema generation, SQL execution, database introspection, dialect-specific validation, constraint semantics, or round-trip DDL conversion.",
"domain_tags": [
"database",
"data-modeling",
"frontend-development"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"sqlglot Python package"
],
"io_signature": "Input: required file_path string naming an existing UTF-8 SQL DDL file. Output: JSON envelope with tables [{table, columns:[{name,type,constraints}]}] or a handled sqlglot ParseError; no database is contacted.",
"accepted_inputs": [
"an existing UTF-8 SQL text file containing statements parseable by sqlglot's default dialect"
],
"output_shape": "Success: {status: \"success\", tool: \"sqlglot\", target: string, tables: [{table: string|null, columns: [{name: string, type: string|null, constraints: [string]}]}]}, exit 0; valid SQL with no recognized CREATE TABLE yields tables=[]. Missing path: {status: \"error\", message: string}, exit 2. Caught ParseError: {status: \"error\", tool: \"sqlglot\", message: string}, exit 1. Missing argument prints usage to stderr and exits 1 without JSON; file I/O and non-ParseError failures may traceback.",
"limitations": [
"output is a custom table summary and is not JSON Schema: it has no `$schema`, object properties, required arrays, validation keywords, references, or SQL-to-JSON type mapping",
"accepts one existing UTF-8 SQL file; a directory or a multi-file DDL project target is outside this wrapper's input boundary",
"uses sqlglot's default dialect with no caller-selectable dialect and ignores non-CREATE-TABLE statements",
"constraint output contains sqlglot constraint class names rather than complete SQL expressions or semantics, and table-name extraction may not cover every CREATE form",
"reads the complete SQL input with no timeout or input-size limit; the generated custom tables/columns summary has no output truncation, so large inputs or large results can amplify memory use",
"does not execute SQL, contact a database, or modify the input"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "file_path",
"kind": "file_path",
"artifact_types": [
"sql"
],
"extensions": [
".sql"
],
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing a custom CREATE TABLE/column summary; it is not a standards-compliant JSON Schema.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "sql-ddl-create-table-structural-summary",
"intent_tags": [
"extract table and column metadata from SQL DDL",
"summarize CREATE TABLE statements as custom JSON"
],
"negative_intents": [
"generate standards compliant JSON Schema",
"execute SQL or inspect a live database",
"validate SQL for a selected database dialect"
],
"dependency_slots": []
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/tobymao/sqlglot",
"license": "MIT",
"backed_by": "sqlglot",
"recognized_public_tool": true,
"source_hash": "sha256:a5fd3f3e3f1c8a43539ca6338e13557a770f0519319b20816d624e9d298862d2",
"local_implementation_uri": "file://Pool/resources/tools/script/sql_ddl_to_json_schema.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/sql_ddl_to_json_schema.py",
"execution_status": "active"
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"database",
"data-modeling",
"frontend-development"
]
},
"input_contract": [
{
"name": "file_path",
"kind": "file_path",
"artifact_types": [
"sql"
],
"extensions": [
".sql"
],
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing a custom CREATE TABLE/column summary; it is not a standards-compliant JSON Schema.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "sqlglot",
"version": "==26.0.1",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.stylelint_css_checker.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Check one CSS file with Stylelint JSON output and an explicit configuration",
"description": "Runs `stylelint -f json --config <cfg> --config-basedir <base> <file>`, using SGAR_STYLELINT_CONFIG or `/opt/stylelint.config.json` and NODE_PATH or `/usr/lib/node_modules`. It captures diagnostics and passes no `--fix` flag.",
"core_primitives": [
"invoke_stylelint_json_check",
"load_explicit_stylelint_configuration",
"capture_css_lint_diagnostics"
],
"problem_space": "Configured Stylelint diagnostics for one existing CSS file; not CSS formatting or fixing, browser rendering validation, CSS parsing as data, accessibility testing, or JavaScript/HTML linting.",
"domain_tags": [
"CSS",
"frontend-development",
"code-quality"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"stylelint executable on PATH",
"SGAR_STYLELINT_CONFIG or /opt/stylelint.config.json must identify a usable Stylelint configuration",
"NODE_PATH or /usr/lib/node_modules must resolve configuration dependencies for --config-basedir"
],
"io_signature": "Input: required file_path string naming an existing CSS file. Executes Stylelint with fixed JSON format, explicit config, and config-basedir flags. Output: JSON envelope with parsed Stylelint result, exit code, and streams; no fix flag is passed.",
"accepted_inputs": [
"an existing CSS file supported by the configured Stylelint rules and syntax"
],
"output_shape": "Stylelint exit 0, 1, or 2: {status: \"success\", tool: \"stylelint\", target: string, exit_code: 0|1|2, result: JSON value|null, stdout: string|null, stderr: string|null}; native JSON normally appears in result. Other exits use status=\"tool_error\" and propagate the exit code. Missing file, executable, or 120-second timeout: {status: \"error\", tool: \"stylelint\", message: string}, exiting 2/3/4. Missing argument prints usage to stderr and exits 1 without JSON.",
"limitations": [
"passes no `--fix` flag and does not intentionally rewrite CSS; it reports configured Stylelint findings rather than formatting output",
"SGAR_STYLELINT_CONFIG can load configuration and plugin code; configuration dependencies and plugin behavior are execution-time inputs, so results are not deterministic",
"outer status=success covers exit codes 0, 1, and 2, so consumers must inspect exit_code and parsed diagnostics rather than outer status alone",
"uses a fixed 120-second timeout and no output truncation; missing or invalid configuration is surfaced through Stylelint's process result"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
],
"execution_risk": "high"
},
"io": {
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope containing parsed Stylelint diagnostics, exit code, and streams; no CSS fix flag is used.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "css-stylelint-configured-check",
"intent_tags": [
"lint a CSS file with Stylelint",
"get configured Stylelint JSON diagnostics"
],
"negative_intents": [
"automatically fix or format CSS",
"validate CSS rendering in a browser",
"lint JavaScript HTML or shell code"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/stylelint_css_checker.py",
"execution_status": "active",
"execution_risk": "high"
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://stylelint.io",
"license": "MIT",
"backed_by": "Stylelint + stylelint-config-standard",
"recognized_public_tool": true,
"source_hash": "sha256:a2f3b48a9b37135d9f6399e6287fc3a9422c946fa4f2351a77f63c05c50bbd2d",
"local_implementation_uri": "file://Pool/resources/tools/script/stylelint_css_checker.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": false
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"CSS",
"frontend-development",
"code-quality"
]
},
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope containing parsed Stylelint diagnostics, exit code, and streams; no CSS fix flag is used.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [
{
"name": "stylelint",
"version": "==17.14.1",
"required": true
}
],
"system_packages": [],
"commands": [
"stylelint"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.system_ram_free_checker.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Return one instantaneous virtual-memory and swap snapshot",
"description": "Calls psutil.virtual_memory() and psutil.swap_memory() once and emits current host/container memory counters in a JSON envelope. It accepts no arguments and does not monitor over time.",
"core_primitives": [
"read_virtual_memory_snapshot",
"read_swap_memory_snapshot",
"report_memory_counters"
],
"problem_space": "Point-in-time operating-system memory telemetry for the runtime environment; not continuous monitoring, process profiling, leak detection, capacity forecasting, alerting, cleanup, or memory reservation.",
"domain_tags": [
"system_monitoring",
"resource_management",
"performance_optimization"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"psutil Python package with access to runtime memory statistics"
],
"io_signature": "Input: none; command-line arguments are ignored. Output: one JSON envelope containing virtual_memory and swap byte counters plus percent-used values at the instant sampled.",
"accepted_inputs": [
"no input arguments"
],
"output_shape": "Success: {status: \"success\", tool: \"psutil\", virtual_memory: {total_bytes: integer, available_bytes: integer, used_bytes: integer, free_bytes: integer, percent_used: number}, swap: {total_bytes: integer, used_bytes: integer, percent_used: number}}, exit 0. psutil or platform-access failures are uncaught and may traceback without JSON.",
"limitations": [
"values are nondeterministic point-in-time host or container measurements and can change immediately after sampling",
"takes no path or directory input; filesystem file/directory boundaries are not applicable to this snapshot tool",
"does not sample repeatedly, set thresholds, emit alerts, identify processes, free RAM, modify swap, or predict capacity",
"platform accounting semantics for available, used, free, and swap vary; no timeout or fallback is implemented"
],
"artifact_input": [],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing one instantaneous virtual-memory and swap snapshot from psutil.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "system-memory-point-in-time-snapshot",
"intent_tags": [
"check currently available system memory",
"get a virtual memory and swap snapshot"
],
"negative_intents": [
"continuously monitor memory or emit alerts",
"profile a process or detect memory leaks",
"free allocate or reserve system memory"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/system_ram_free_checker.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 50,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/giampaolo/psutil",
"license": "BSD",
"backed_by": "system memory snapshot via psutil",
"recognized_public_tool": true,
"source_hash": "sha256:0c1f29bf9988d470bf9ef9ec444702760f25879881bcef24918e2508de39e2b7",
"local_implementation_uri": "file://Pool/resources/tools/script/system_ram_free_checker.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": false
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"system_monitoring",
"resource_management",
"performance_optimization"
]
},
"input_contract": [],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing one instantaneous virtual-memory and swap snapshot from psutil.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "psutil",
"version": "==6.1.1",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.trafilatura_extract.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Extract main text from local HTML or XML with Trafilatura 2.2.0",
"description": "Thin SGAR adapter over upstream Trafilatura that reads one local document and returns txt, Markdown, or Trafilatura JSON extraction.",
"domain_tags": [
"web",
"text_extraction",
"document_processing"
],
"core_primitives": [
"extract_main_text",
"remove_web_boilerplate",
"serialize_extracted_document"
],
"problem_space": "Main-content extraction from already acquired HTML/XML; not URL fetching, web search, browser rendering, evidence capture, or citation verification."
},
"constraint": {
"io_signature": "Input local document path, output format and size bound; output JSON envelope containing extracted text.",
"accepted_inputs": [
"readable local HTML or XML document no larger than the configured bound"
],
"output_shape": "JSON with target, output_format and extracted text.",
"limitations": [
"never fetches URLs",
"does not execute JavaScript",
"does not create provenance or citation evidence",
"default maximum input is 5 MB"
],
"operation_kinds": [
"local_read",
"text_extraction"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "input_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Extracted main content from one local document.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "html-main-content-extraction",
"intent_tags": [
"extract article text from local HTML",
"remove web page boilerplate"
],
"negative_intents": [
"download a URL",
"search sources",
"produce auditable research evidence"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/trafilatura_extract.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/adbar/trafilatura/tree/v2.2.0",
"version": "2.2.0",
"license": "Apache-2.0",
"license_url": "https://github.com/adbar/trafilatura/blob/v2.2.0/LICENSE",
"license_sha256": "a6cba85bc92e0cff7a450b1d873c0eaa2e9fc96bf472df0247a26bec77bf3ff9",
"upstream_artifact": "https://files.pythonhosted.org/packages/source/t/trafilatura/trafilatura-2.2.0.tar.gz",
"upstream_artifact_sha256": "8c2cabb84066465228d03183fb698ce0b1245b81c58140b8ae0de57fddf3aae7",
"backed_by": "Trafilatura",
"recognized_public_tool": true,
"source_hash": "sha256:7a00b5d702a1452e71771a8c99adecb635f44c0b21891c1f07c1faca711b553a",
"local_implementation_uri": "file://Pool/resources/tools/script/trafilatura_extract.py"
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "trafilatura",
"version": "==2.2.0",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.tsc_compile_runner.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Run TypeScript tsc --noEmit in one local project directory",
"description": "Runs exactly `tsc --noEmit` with cwd set to the supplied directory or an existing file's absolute parent. It performs configured TypeScript compilation/type checking without JavaScript/declaration emit, and returns raw compiler streams in a JSON envelope.",
"core_primitives": [
"resolve_typescript_project_cwd",
"invoke_tsc_no_emit",
"capture_typescript_compiler_diagnostics"
],
"problem_space": "Project-level TypeScript compiler/type-check validation under discovered tsconfig settings with fixed --noEmit; not JavaScript bundling, artifact emission, test execution, ESLint, formatting, package installation, or caller-configurable tsc commands.",
"domain_tags": [
"typescript",
"compiler",
"developer-tools"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"Node.js >= 12",
"tsc executable on PATH",
"a usable tsconfig.json and referenced TypeScript dependencies/types discoverable from the resolved cwd"
],
"io_signature": "Input: required project_dir string at CLI position 1; a directory becomes cwd and an existing file selects its absolute parent. Executes `tsc --noEmit`. Output: JSON envelope with compiler exit_code and raw stdout/stderr.",
"accepted_inputs": [
"an existing TypeScript project directory containing or inheriting a tsconfig.json",
"an existing file whose parent directory is intentionally used as the TypeScript project cwd"
],
"output_shape": "tsc exit 0: {status: \"success\", tool: \"tsc\", target: string, exit_code: 0, result: null, stdout: string, stderr: string|null}, wrapper exit 0. Any nonzero tsc exit: same keys with status=\"tool_error\" and the compiler exit code is propagated. Missing target, executable, or 120-second timeout: {status: \"error\", tool: \"tsc\", message: string}, exiting 2/3/4. Missing argument prints usage to stderr and exits 1 without JSON.",
"limitations": [
"fixed `--noEmit` prevents normal JavaScript/declaration output, but project incremental/composite configuration and TypeScript version may still affect cache or build-info behavior; it is not an absolute filesystem-write sandbox",
"the plain string project_dir contract accepts either an existing directory or an existing file; automatic file-artifact binding does not infer a directory, and a file is converted to its absolute parent cwd",
"uses cwd/tsconfig discovery and exposes no project path flag, target, module, strictness, pretty, incremental, build-mode, or file-selection controls",
"does not bundle code, run tests, lint with ESLint, install dependencies, or return parsed diagnostics",
"uses a fixed 120-second timeout and captures untruncated compiler output in memory"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "project_dir",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope containing `tsc --noEmit` exit code and raw compiler stdout/stderr; no compiled JavaScript artifact is returned.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "typescript-tsc-no-emit-project-check",
"intent_tags": [
"type check a TypeScript project with tsc",
"run tsc noEmit and capture compiler errors"
],
"negative_intents": [
"emit bundle or transpile JavaScript artifacts",
"run TypeScript tests or ESLint",
"pass arbitrary tsc compiler flags"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/tsc_compile_runner.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://www.typescriptlang.org",
"license": "Apache-2.0",
"backed_by": "TypeScript compiler CLI (`tsc`)",
"recognized_public_tool": true,
"source_hash": "sha256:370b429774156316f664ea922f66715cae86cd7815ec818d6a52a83c2d516346",
"local_implementation_uri": "file://Pool/resources/tools/script/tsc_compile_runner.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"typescript",
"compiler",
"developer-tools"
]
},
"input_contract": [
{
"name": "project_dir",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope containing `tsc --noEmit` exit code and raw compiler stdout/stderr; no compiled JavaScript artifact is returned.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [
{
"name": "typescript",
"version": "==7.0.2",
"required": true
}
],
"system_packages": [],
"commands": [
"tsc"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.vitest_runner.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Run a local Vitest suite once with its JSON reporter",
"description": "Runs exactly `vitest run --reporter=json` from the supplied directory, or from the absolute parent of a supplied file, with a 180-second timeout. Vitest executes project configuration, setup files, and tests; the wrapper reports the process result in a JSON envelope and treats exit codes 0 and 1 as completed runs.",
"core_primitives": [
"resolve_vitest_project_cwd",
"execute_vitest_run_mode",
"capture_vitest_json_report"
],
"problem_space": "One-shot execution of an existing Vitest test suite with the built-in JSON reporter. It is not Jest or npm-script execution, watch mode, test authoring, coverage generation, dependency installation, linting, or a sandbox for untrusted tests.",
"domain_tags": [
"testing-tools",
"developer-tools",
"automation-testing"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"vitest executable on PATH",
"project Vitest configuration and runtime dependencies discoverable from the resolved cwd"
],
"io_signature": "Input: required proj_dir string at CLI position 1; an existing directory is cwd, while an existing file selects its absolute parent. Executes `vitest run --reporter=json`. Output: one JSON execution envelope containing the parsed reporter payload when either captured stream is valid JSON, otherwise raw streams.",
"accepted_inputs": [
"an existing directory for a configured local Vitest project",
"an existing file whose parent directory should be used as the Vitest project cwd"
],
"output_shape": "Vitest exit 0 or 1: {status: \"success\", tool: \"vitest\", target: string, exit_code: 0|1, result: any JSON value|null, stdout: string|null, stderr: string|null}, wrapper exit 0. The helper attempts JSON parsing of nonempty stdout first and then stderr; when parsing succeeds result holds that value and stdout is null. Other Vitest exits use the same keys with status=\"tool_error\" and propagate that exit code. Missing target/executable or timeout emits {status: \"error\", tool: \"vitest\", message: string} and exits 2/3/4. Missing argument writes usage to stderr and exits 1 without JSON.",
"limitations": [
"executes arbitrary project configuration, setup files, transforms, and test code with the wrapper process permissions; tests may write files, spawn processes, or access the network",
"the plain string proj_dir contract accepts either an existing directory or an existing file; automatic file-artifact binding does not infer a directory, and a file is converted to its absolute parent cwd",
"fixed run mode and JSON reporter expose no test-name, file-pattern, coverage, pool, watch, update-snapshot, or passthrough CLI controls",
"exit code 1, normally test failures, is wrapped as status=success; callers must inspect exit_code and the reporter result",
"uses a fixed 180-second timeout and captures untruncated stdout/stderr in memory; JSON parsing accepts either stdout or stderr"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
],
"execution_risk": "high"
},
"io": {
"input_contract": [
{
"name": "proj_dir",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope for `vitest run --reporter=json`, containing exit code, parsed reporter payload when available, and otherwise raw stdout/stderr.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "vitest-one-shot-test-runner",
"intent_tags": [
"run a Vitest test suite once",
"capture Vitest JSON test results"
],
"negative_intents": [
"run Jest or an npm test script",
"watch tests or generate coverage",
"safely execute untrusted test code"
],
"dependency_slots": []
},
"utility": {
"latency_ms": 200,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://vitest.dev",
"license": "MIT",
"backed_by": "Vitest",
"recognized_public_tool": true,
"source_hash": "sha256:59a9a1637405fa5c1d32283764510e50fbbd6559b36b239570b7a1fba0eb88ca",
"local_implementation_uri": "file://Pool/resources/tools/script/vitest_runner.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": false
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/vitest_runner.py",
"execution_status": "active",
"execution_risk": "high"
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"testing-tools",
"developer-tools",
"automation-testing"
]
},
"input_contract": [
{
"name": "proj_dir",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON execution envelope for `vitest run --reporter=json`, containing exit code, parsed reporter payload when available, and otherwise raw stdout/stderr.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [],
"node_packages": [
{
"name": "vitest",
"version": "==4.1.10",
"required": true
}
],
"system_packages": [],
"commands": [
"vitest"
],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.xlsx2csv.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Extract every worksheet from one XLSX workbook as in-memory CSV text",
"description": "Opens one existing workbook with openpyxl in read-only, data-only mode, serializes every worksheet to CSV text, and returns a sheet-name-to-CSV mapping inside a JSON envelope. It does not create `.csv` files or evaluate formulas.",
"core_primitives": [
"load_xlsx_read_only",
"iterate_all_worksheets",
"serialize_rows_to_csv_text"
],
"problem_space": "Read-only extraction of all XLSX worksheets into CSV strings for downstream processing. It is not a filesystem CSV exporter, worksheet selector, workbook editor, formula calculator, spreadsheet renderer, or converter for legacy `.xls` files.",
"domain_tags": [
"data_processing",
"file_conversion",
"Excel"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"openpyxl installed"
],
"io_signature": "Input: required file_path string at CLI position 1 naming an existing openpyxl-readable XLSX workbook. Output: JSON envelope whose sheets_csv object contains CSV text for every worksheet; no output file is written.",
"accepted_inputs": [
"an existing `.xlsx` workbook readable by the installed openpyxl version"
],
"output_shape": "Success: {status: \"success\", tool: \"openpyxl\", target: string, sheet_names: [string, ...], sheets_csv: {<sheet name>: string, ...}}, exit 0. Non-existing path: {status: \"error\", message: string}, exit 2. Workbook/openpyxl/serialization exception: {status: \"error\", tool: \"openpyxl\", message: \"<ExceptionType>: <message>\"}, exit 1. Missing argument prints usage to stderr and exits 1 without JSON.",
"limitations": [
"returns CSV strings inside JSON and never creates per-sheet `.csv` files",
"reads every worksheet and retains all generated CSV strings in the JSON result; workbook size and result size are unbounded, with memory amplification from workbook cells to CSV strings and the outer JSON envelope",
"has no output truncation and no timeout; large or pathological workbooks can consume substantial memory or run without a time limit",
"always processes every worksheet and offers no sheet, range, delimiter, quoting, encoding, or output-path controls",
"loads with data_only=true, so formulas yield cached workbook values rather than formulas and are not recalculated; absent cached values become empty CSV fields",
"cell types and formatting are flattened through Python/csv string conversion; styles, merged-cell semantics, charts, macros, and workbook structure are not preserved"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "file_path",
"kind": "string",
"artifact_types": [
"xlsx"
],
"extensions": [
".xlsx"
],
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope listing worksheet names and mapping each sheet name to its in-memory CSV text; no CSV file artifact is written.",
"json_schema": {
"oneOf": [
{
"type": "object",
"properties": {
"status": {
"const": "success"
},
"tool": {
"const": "openpyxl"
},
"target": {
"type": "string",
"minLength": 1
},
"sheet_names": {
"type": "array",
"items": {
"type": "string"
}
},
"sheets_csv": {
"type": "object",
"additionalProperties": {
"type": "string"
}
}
},
"required": [
"status",
"tool",
"target",
"sheet_names",
"sheets_csv"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"status": {
"const": "error"
},
"tool": {
"const": "openpyxl"
},
"message": {
"type": "string",
"minLength": 1
}
},
"required": [
"status",
"message"
],
"additionalProperties": false
}
]
}
}
},
"routing": {
"family": "xlsx-all-sheets-to-csv-text",
"intent_tags": [
"extract all XLSX sheets as CSV text",
"read workbook rows into per-sheet CSV strings"
],
"negative_intents": [
"write CSV files to disk",
"convert legacy XLS workbooks",
"evaluate formulas or preserve spreadsheet formatting"
],
"dependency_slots": []
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://openpyxl.readthedocs.io",
"license": "MIT",
"backed_by": "openpyxl",
"recognized_public_tool": true,
"source_hash": "sha256:b31adbc376b919b071913015c1b6a085aabc88d7b6b99009dbdb13a865658e1e",
"local_implementation_uri": "file://Pool/resources/tools/script/xlsx2csv.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/xlsx2csv.py",
"execution_status": "active"
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"data_processing",
"file_conversion",
"Excel"
]
},
"input_contract": [
{
"name": "file_path",
"kind": "string",
"artifact_types": [
"xlsx"
],
"extensions": [
".xlsx"
],
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope listing worksheet names and mapping each sheet name to its in-memory CSV text; no CSV file artifact is written.",
"json_schema": {
"oneOf": [
{
"type": "object",
"properties": {
"status": {
"const": "success"
},
"tool": {
"const": "openpyxl"
},
"target": {
"type": "string",
"minLength": 1
},
"sheet_names": {
"type": "array",
"items": {
"type": "string"
}
},
"sheets_csv": {
"type": "object",
"additionalProperties": {
"type": "string"
}
}
},
"required": [
"status",
"tool",
"target",
"sheet_names",
"sheets_csv"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"status": {
"const": "error"
},
"tool": {
"const": "openpyxl"
},
"message": {
"type": "string",
"minLength": 1
}
},
"required": [
"status",
"message"
],
"additionalProperties": false
}
]
}
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "openpyxl",
"version": "==3.1.5",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.xml_to_json.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Map one XML document to a simplified JSON element tree",
"description": "Parses one local XML file with lxml and returns a simplified recursive element tree containing each element's local tag name, raw attribute mapping, optional stripped direct text, and optional element children. It reports XMLSyntaxError as JSON but is not a lossless XML representation.",
"core_primitives": [
"parse_local_xml_document",
"map_elements_to_json_nodes",
"preserve_child_element_order"
],
"problem_space": "Simplified structural inspection of one well-formed XML document as JSON. It is not XML Schema/DTD validation, XPath querying, namespace-preserving or round-trip conversion, canonicalization, remote endpoint processing, or a general secure parser for untrusted XML.",
"domain_tags": [
"data_format",
"xml",
"json",
"conversion"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"lxml installed"
],
"io_signature": "Input: required file_path string at CLI position 1 naming an existing XML file. Output: JSON envelope with a recursive json node shaped as {tag, attrib, optional text, optional children}; no output file is written.",
"accepted_inputs": [
"an existing local, well-formed XML document parseable by lxml.etree.parse"
],
"output_shape": "Success: {status: \"success\", tool: \"lxml\", target: string, json: {tag: string, attrib: object, text?: string, children?: [node, ...]}}, exit 0. Non-existing path: {status: \"error\", message: string}, exit 2. XMLSyntaxError: {status: \"error\", tool: \"lxml\", message: \"invalid XML: <details>\"}, exit 1. Missing argument prints usage to stderr and exits 1 without JSON. Other I/O, parser, QName, recursion, or serialization exceptions are uncaught and may produce a traceback/non-JSON exit.",
"limitations": [
"reads and recursively materializes the complete XML tree and complete JSON result in memory; document depth, node count, and result size are unbounded and can amplify memory use",
"has no output truncation and no timeout; large or deeply nested documents can consume substantial memory or exhaust recursion",
"element namespace URIs/prefixes are discarded from tag names via QName.localname, while namespaced attribute keys may remain in lxml expanded-name form",
"drops comments, processing instructions, namespace declarations, child tail text, document metadata, and whitespace-only/direct surrounding text; it is not round-trip lossless",
"uses lxml's default parser without explicit entity, DTD, recovery, size, depth, or network-hardening options, so it should not be treated as a hardened untrusted-XML boundary",
"only XMLSyntaxError is converted to the documented error envelope; other failures can traceback, and deeply nested XML can exhaust recursion"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "file_path",
"kind": "file_path",
"artifact_types": [
"xml"
],
"extensions": [
".xml"
],
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing a simplified recursive XML element tree (`tag`, `attrib`, optional `text` and `children`) or a handled parse error.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "xml-simplified-element-tree-converter",
"intent_tags": [
"convert XML elements to a simplified JSON tree",
"inspect XML tags attributes text and children as JSON"
],
"negative_intents": [
"run XPath queries against XML",
"validate XML against XSD or DTD",
"perform lossless namespace-preserving XML conversion"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/xml_to_json.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://lxml.de",
"license": "BSD",
"backed_by": "lxml",
"recognized_public_tool": true,
"source_hash": "sha256:8cedf1c6edd5ee5342e1a8d98a669419c484a6b5066296d8a2c1a8576cf9100d",
"local_implementation_uri": "file://Pool/resources/tools/script/xml_to_json.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"data_format",
"xml",
"json",
"conversion"
]
},
"input_contract": [
{
"name": "file_path",
"kind": "file_path",
"artifact_types": [
"xml"
],
"extensions": [
".xml"
],
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing a simplified recursive XML element tree (`tag`, `attrib`, optional `text` and `children`) or a handled parse error.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "lxml",
"version": "==5.3.0",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.xml_xpath_query_executor.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Run one lxml XPath expression against one local XML file",
"description": "Parses a local XML document with lxml, evaluates one XPath expression without caller-supplied namespace bindings or variables, normalizes list items to strings (serializing element nodes), and returns the matches in a JSON envelope.",
"core_primitives": [
"parse_local_xml_for_xpath",
"evaluate_single_lxml_xpath",
"normalize_xpath_values_to_strings"
],
"problem_space": "One-off XPath selection or scalar evaluation over an existing local XML document. It is distinct from XML-to-JSON tree conversion and is not XSLT, XSD/DTD validation, namespace-aware query configuration, remote XML querying, XML mutation, or a hardened untrusted-XML service.",
"domain_tags": [
"XML",
"XPath",
"data_processing"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"lxml installed"
],
"io_signature": "Input: required file_path string at CLI position 1 and required xpath_query string at position 2. Output: JSON envelope with xpath, match_count, and a list of string-normalized results; element results are serialized XML strings.",
"accepted_inputs": [
"an existing local, well-formed XML file plus one lxml-supported XPath expression requiring no external namespace map or variables"
],
"output_shape": "Success: {status: \"success\", tool: \"lxml\", target: string, xpath: string, match_count: integer, matches: [string, ...]}, exit 0. Node-set/list results yield one normalized string per item; element nodes use etree.tostring(..., encoding=\"unicode\").strip(), while non-elements use str(). A scalar XPath result is wrapped as one string, so match_count is 1 even for false/empty-string/numeric scalars. Non-existing path: {status: \"error\", message: string}, exit 2. XMLSyntaxError or XPathError: {status: \"error\", tool: \"lxml\", message: string}, exit 1. Missing arguments print usage to stderr and exit 1 without JSON; other exceptions may traceback.",
"limitations": [
"parses the complete XML document and materializes the complete XPath result list and normalized strings in memory; input, match count, subtree size, and result size are unbounded with possible memory amplification",
"has no output truncation and no timeout; broad XPath expressions or large documents can produce very large results or run without a time limit",
"passes no namespace-prefix mapping, variables, extension-function policy, or smart-string options; prefixed queries fail unless resolvable without caller configuration, so namespace-heavy XML may require local-name() expressions",
"all results lose native XPath types: booleans, numbers, and strings become strings, scalar results always become a one-item matches list, and element serialization may include subtree markup and tail text",
"uses lxml's default XML parser without explicit entity, DTD, recovery, size, depth, or network-hardening settings; do not treat it as a hardened untrusted-XML boundary",
"does not modify XML, return source-node locations, convert the whole document to JSON, or catch non-XMLSyntaxError/non-XPathError failures"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "xpath_query",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing the XPath expression, string-normalized matches, and match count, or a handled XML/XPath error.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "xml-lxml-single-xpath-query",
"intent_tags": [
"run an XPath expression on a local XML file",
"extract XML nodes or scalar values with lxml XPath"
],
"negative_intents": [
"convert an entire XML document to JSON",
"validate XML with XSD or DTD",
"supply XPath namespace bindings or mutate XML"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/xml_xpath_query_executor.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://lxml.de",
"license": "BSD",
"backed_by": "XPath query over XML via lxml",
"recognized_public_tool": true,
"source_hash": "sha256:2b38d53d77e0b721314e11c49623b1ff8abe9a6063297807118dbdb21703d0c6",
"local_implementation_uri": "file://Pool/resources/tools/script/xml_xpath_query_executor.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"XML",
"XPath",
"data_processing"
]
},
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "xpath_query",
"kind": "string",
"required": true,
"cli_position": 2
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing the XPath expression, string-normalized matches, and match count, or a handled XML/XPath error.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "lxml",
"version": "==5.3.0",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "1.0",
"resource_id": "tool.yaml_to_json.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Parse one UTF-8 YAML document and return its JSON-compatible value",
"description": "Reads one local UTF-8 file, parses exactly one YAML document with PyYAML safe_load, and emits the resulting Python value under a `json` field in a JSON envelope. It does not write a converted file, and safe YAML values that are not JSON-serializable can still fail during envelope emission.",
"core_primitives": [
"read_utf8_yaml_file",
"parse_single_yaml_document_safely",
"emit_json_compatible_yaml_value"
],
"problem_space": "Single-document YAML parsing for JSON-compatible configuration/data values. It is not multi-document streaming, schema validation, YAML linting, round-trip formatting, comment/style preservation, JSON-to-YAML conversion, or a filesystem JSON exporter.",
"domain_tags": [
"data_transformation",
"file_processing"
]
},
"constraint": {
"env_requirements": [
"Python >= 3.6",
"PyYAML installed"
],
"io_signature": "Input: required file_path string at CLI position 1 naming an existing UTF-8 YAML file containing one document. Output: JSON envelope with the safe_load value in `json`; no `.json` file is written.",
"accepted_inputs": [
"an existing UTF-8 YAML file containing exactly one PyYAML-safe document whose constructed value is JSON-serializable"
],
"output_shape": "Success JSON envelope: {status: \"success\", tool: \"PyYAML\", target: string, json: any JSON-compatible value}, exit 0; an empty document or YAML null produces json=null. The outer envelope is emitted by json.dumps with default allow_nan=true, so a payload containing YAML NaN/Infinity may be non-strict RFC JSON; non-string YAML mapping keys are stringified and can collide. Non-existing path: {status: \"error\", message: string}, exit 2. PyYAML YAMLError, including malformed or multiple-document input rejected by safe_load: {status: \"error\", tool: \"PyYAML\", message: \"invalid YAML: <details>\"}, exit 1. Missing argument prints usage to stderr and exits 1 without JSON. File/UTF-8 errors and JSON serialization failures are uncaught and may traceback.",
"limitations": [
"safe_load reads and materializes the complete YAML document before json.dumps emits the envelope; input and result sizes are unbounded and nested data can amplify memory use",
"the wrapper's json.dumps uses the default allow_nan=true behavior, so YAML NaN/Infinity values may be emitted as NaN/Infinity rather than strict RFC JSON",
"JSON emission stringifies non-string mapping keys; distinct YAML keys can therefore collide after stringification and overwrite/lose information in the JSON representation",
"has no output truncation and no timeout; large documents can consume substantial memory or run without a time limit",
"safe_load accepts one document only and does not preserve comments, anchors, aliases, scalar styles, tags, key ordering guarantees across consumers, or original formatting",
"some safely constructed YAML values are not directly JSON-compatible, including timestamps/dates, binary values, sets, recursive aliases, or unsuitable mapping keys; emit then raises an uncaught serialization error",
"duplicate mapping keys are not explicitly rejected and may be overwritten according to PyYAML behavior",
"reads UTF-8 only, writes no JSON file, applies no application schema, and catches only yaml.YAMLError"
],
"artifact_input": [
"file_path"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing the single PyYAML safe_load value when JSON-serializable; default json.dumps allow_nan=true can leave NaN/Infinity non-strict RFC JSON, and non-string YAML keys are stringified with possible collisions, or a handled YAML parse error.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "yaml-single-document-to-json-value",
"intent_tags": [
"parse one YAML document into a JSON-compatible value",
"convert a local YAML configuration to JSON output"
],
"negative_intents": [
"parse a multi-document YAML stream",
"preserve YAML comments formatting or anchors",
"write a JSON file or validate an application schema"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/yaml_to_json.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 100,
"token_cost_factor": 0.01,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://pyyaml.org",
"license": "MIT",
"backed_by": "PyYAML",
"recognized_public_tool": true,
"source_hash": "sha256:7b70695d55524478ca86d98c190cd23845e261b180c79d8a8a0689ca160b9314",
"local_implementation_uri": "file://Pool/resources/tools/script/yaml_to_json.py",
"supporting_source_hashes": {
"file://Pool/resources/tools/script/_sgar_cli.py": "sha256:42368f8d49cb6364ad3aeaac6d0f9602adc12cb29fea49322fd488400698b6b9"
}
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": true
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"type": {
"resource_type": "Tool",
"resource_tag": [
"data_transformation",
"file_processing"
]
},
"input_contract": [
{
"name": "file_path",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "JSON envelope containing the single PyYAML safe_load value when JSON-serializable; default json.dumps allow_nan=true can leave NaN/Infinity non-strict RFC JSON, and non-string YAML keys are stringified with possible collisions, or a handled YAML parse error.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "PyYAML",
"version": "==6.0.2",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": false,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.zotero_translation.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Normalize citation metadata through Zotero Translation Server",
"description": "SGAR adapter over upstream Zotero Translation Server identifier and webpage translation APIs.",
"domain_tags": [
"research",
"citation",
"metadata"
],
"core_primitives": [
"resolve_identifier_metadata",
"normalize_citation_items",
"return_zotero_json"
],
"problem_space": "Citation metadata normalization for public webpages and scholarly identifiers; not web search, evidence capture, quote extraction, or source hashing."
},
"constraint": {
"io_signature": "Input public URL or DOI/ISBN/PMID/arXiv identifier; output Zotero JSON items or translator diagnostics.",
"accepted_inputs": [
"public URL or supported scholarly identifier"
],
"output_shape": "JSON normalized citation item envelope.",
"limitations": [
"requires local/self-hosted translation-server",
"translator coverage varies by source",
"does not prove source truth or preserve a page snapshot",
"public metadata path requires no third-party token"
],
"operation_kinds": [
"network_metadata_read"
],
"artifact_output": [
"json"
]
},
"io": {
"input_contract": [
{
"name": "identifier",
"kind": "string",
"required": true,
"cli_position": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Normalized Zotero citation metadata.",
"json_schema": {
"description": "Native JSON representation only; no field or task-delivery guarantee.",
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"native_json_contract_scope": "value_only"
}
},
"routing": {
"family": "citation-metadata-normalization",
"intent_tags": [
"resolve DOI metadata",
"extract citation metadata",
"normalize a webpage citation"
],
"negative_intents": [
"rank web search results",
"capture WARC evidence",
"locate an exact quote"
]
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/zotero_translation.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 1000,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/zotero/translation-server/tree/2.0.3",
"version": "2.0.3",
"license": "AGPL-3.0",
"license_url": "https://github.com/zotero/translation-server/blob/2.0.3/COPYING",
"license_sha256": "c97f1925ce31549ed01eb29eec2226f17b9adcb3956669ea204d226a0c746831",
"backed_by": "Zotero Translation Server",
"recognized_public_tool": true,
"native_network_access": true,
"credential_class": "NONE",
"credential_env_names": [],
"third_party_account_required": false,
"paid_service_required": false,
"source_hash": "sha256:0ff5b89b9ef1f9ee1ea553bdc2e9cf57dd5b41c5ceb3a21ef38631a1459323bc",
"local_implementation_uri": "file://Pool/resources/tools/script/zotero_translation.py"
},
"type_specific": {
"tool": {
"tool_kind": "rest_api",
"deterministic": false
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "httpx",
"version": "==0.28.1",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [
"ZOTERO_TRANSLATION_SERVER_URL"
],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
},
{
"manifest_version": "v2",
"resource_id": "tool.httpx_download.v1",
"resource_type": "Tool",
"status": "active",
"capability": {
"summary": "Download a public URL to an exact binary or text file for subsequent Tools or visual/audio models.",
"description": "Acquire a public HTTP(S) response with HTTPX and save its exact bytes at an explicit task-workspace path. Returns a compact status, MIME type, size and hash receipt. Actual file effects are registered by the runtime and can be consumed by compatible downstream Tools or a live-verified visual/audio controller.",
"core_primitives": [
"download_remote_file",
"fetch_web_resource"
],
"domain_tags": [
"web",
"file-acquisition",
"image",
"audio",
"document"
],
"problem_space": "Acquire already located public images, audio, documents, datasets or source files. Does not find URLs, interpret images, extract page content, transcribe audio, or bypass unavailable websites.",
"execution_semantics": {
"determinism": "unknown",
"side_effects": "declared",
"effect_targets": [
"task_workspace"
],
"modalities": [
"file",
"image",
"audio",
"text"
]
}
},
"constraint": {
"io_signature": "Input public URL, output_path and optional timeout_ms/max_bytes. Output exact downloaded workspace file plus JSON status/MIME/size/hash receipt.",
"accepted_inputs": [
"public HTTP(S) URL",
"writable task-workspace destination with the correct extension"
],
"output_shape": "JSON receipt; downloaded bytes are a file effect, never decoded or embedded in JSON.",
"limitations": [
"remote endpoint availability is not guaranteed",
"no authentication or browser JavaScript",
"default response size 20 MiB and timeout 60s can be increased explicitly",
"image/audio model consumption still requires a supported format and verified model capability"
],
"operation_kinds": [
"download_remote_file",
"fetch_web_resource"
],
"artifact_output": [
"json"
],
"materialized_artifact_types": [
"file",
"image",
"audio",
"plaintext",
"code",
"pdf"
]
},
"io": {
"input_contract": [
{
"name": "url",
"kind": "string",
"required": true,
"cli_position": 1
},
{
"name": "output_path",
"kind": "string",
"required": true,
"cli_position": 2,
"description": "Workspace-relative destination; preserve the actual content extension for model-media delivery."
},
{
"name": "timeout_ms",
"kind": "integer",
"required": false,
"cli_flag": "--timeout-ms",
"default": 60000,
"minimum": 1
},
{
"name": "max_bytes",
"kind": "integer",
"required": false,
"cli_flag": "--max-bytes",
"default": 20971520,
"minimum": 1
}
],
"output_contract": {
"artifact_type": "json",
"description": "Downloaded file receipt; content remains in the task workspace.",
"json_schema": {
"oneOf": [
{
"type": "object",
"properties": {
"status": {
"const": "success"
},
"url": {
"type": "string"
},
"http_status": {
"const": 200
},
"byte_size": {
"type": "integer",
"minimum": 0
},
"content_sha256": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"content_type": {
"type": "string"
}
},
"required": [
"status",
"url",
"http_status",
"byte_size",
"content_sha256",
"content_type"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"status": {
"const": "error"
},
"reason_code": {
"type": "string"
},
"http_status": {
"type": "integer"
}
},
"required": [
"status",
"reason_code"
],
"additionalProperties": false
}
]
},
"result_status": {
"payload_path": "status",
"success_values": [
"success"
],
"failure_values": [
"error"
]
}
}
},
"routing": {
"family": "public-file-download",
"intent_tags": [
"acquire an image or audio file for model inspection",
"download a public document or dataset",
"save exact HTTP bytes to the task workspace"
],
"negative_intents": [
"discover a URL",
"interpret image contents",
"generate media"
],
"dependency_slots": []
},
"execution": {
"runtime": "python_script",
"uri": "file://Pool/resources/tools/script/httpx_download.py",
"execution_status": "active"
},
"utility": {
"latency_ms": 250,
"token_cost_factor": 0.02,
"expected_success_rate": 0.5,
"successes": 0,
"attempts": 0,
"evidence_status": "unobserved"
},
"provenance": {
"source": "https://github.com/encode/httpx/tree/0.28.1",
"version": "0.28.1",
"license": "BSD-3-Clause",
"license_url": "https://github.com/encode/httpx/blob/0.28.1/LICENSE.md",
"license_sha256": "4ec59d544f12b5f539a3a716fd321ac58ccd8030b465221f2c880200cdf28d8d",
"upstream_artifact": "https://files.pythonhosted.org/packages/source/h/httpx/httpx-0.28.1.tar.gz",
"upstream_artifact_sha256": "75e98c5f16b0f35b567856f597f06ff2270a374470a5c2392242528e3e3e42fc",
"backed_by": "HTTPX",
"recognized_public_tool": true,
"source_hash": "sha256:69f69e1f2740a779ebef6efe758b7135863e970ff5ad54aef4cfd60354c21000",
"local_implementation_uri": "file://Pool/resources/tools/script/httpx_download.py"
},
"type_specific": {
"tool": {
"tool_kind": "local_script",
"language": "python",
"deterministic": false
}
},
"memory": {
"success_trajectories": [],
"failure_reflections": []
},
"runtime_requirements": {
"runtime_profile": "sgar-runtime",
"python": "==3.11.9",
"python_packages": [
{
"name": "httpx",
"version": "==0.28.1",
"required": true
}
],
"node_packages": [],
"system_packages": [],
"commands": [],
"env_vars": [],
"network_required": true,
"install_policy": "never",
"max_auto_heals": 0,
"docker_image": "sgar-runtime:rc1",
"python_compatibility": ">=3.11,<4"
}
}
]