{"name": "Aria", "description": "City Holdings' enterprise brain: cited answers from company knowledge (English or Burmese)", "version": "3.0.0-dev", "provider": {"organization": "City Holdings", "url": "https://itsm.citygpt.xyz"}, "supportedInterfaces": [{"url": "https://itsm.citygpt.xyz/api/v1/a2a", "protocolBinding": "JSONRPC", "protocolVersion": "1.0"}], "capabilities": {"streaming": true, "pushNotifications": false, "extensions": [{"uri": "urn:aria:a2a:answer-data:v1", "required": false, "description": "Each reply has a text part (markdown, unchanged) and a data part (application/json) with the same answer as structured data; completed tasks list it as an artifact (streamed as artifactUpdate when acceptedOutputModes includes application/json). metadata.aria is kept.", "params": {"version": 1, "types": ["aria.answer", "aria.approvals", "aria.decision", "aria.changes", "aria.choice"], "inputRequired": ["get_steps", "my_approvals"]}}, {"uri": "https://a2ui.org/a2a-extension/a2ui/v0.9.1", "description": "Answer card (steps, sources, follow-ups) as A2UI v0.9.1", "required": false, "params": {"supportedCatalogIds": ["https://a2ui.org/specification/v0_9/catalogs/basic/catalog.json"]}}]}, "securitySchemes": {"bearer": {"httpAuthSecurityScheme": {"scheme": "Bearer", "description": "The asking person's City SSO (Keycloak) access token — optionally with an X-Aria-App-Key — or an Aria session token"}, "type": "http", "scheme": "bearer", "description": "The asking person's City SSO (Keycloak) access token — optionally with an X-Aria-App-Key — or an Aria session token"}, "apiKey": {"apiKeySecurityScheme": {"location": "header", "name": "x-api-key", "description": "An Aria app key (ariak_…) made by an Aria admin in Edit Agent → Connectors; it answers as the account it was made for, limited to the chosen knowledge bases"}, "type": "apiKey", "in": "header", "name": "x-api-key", "description": "An Aria app key (ariak_…) made by an Aria admin in Edit Agent → Connectors; it answers as the account it was made for, limited to the chosen knowledge bases"}, "sso": {"openIdConnectSecurityScheme": {"openIdConnectUrl": "https://iam.citydigitalmm.com/realms/city-group/.well-known/openid-configuration", "description": "Office 365: Sign in with your company account. The app sends the person's access token from this provider as Authorization: Bearer; Aria answers as that person, with their own access. Only apps an Aria admin allows (Settings → Sign-in → Access from other apps) are accepted"}, "type": "openIdConnect", "openIdConnectUrl": "https://iam.citydigitalmm.com/realms/city-group/.well-known/openid-configuration", "description": "Office 365: Sign in with your company account. The app sends the person's access token from this provider as Authorization: Bearer; Aria answers as that person, with their own access. Only apps an Aria admin allows (Settings → Sign-in → Access from other apps) are accepted"}}, "securityRequirements": [{"schemes": {"bearer": {"list": []}}}, {"schemes": {"apiKey": {"list": []}}}, {"schemes": {"sso": {"list": ["openid", "email"]}}}], "defaultInputModes": ["text/plain"], "defaultOutputModes": ["text/markdown", "text/plain", "application/json"], "skills": [{"id": "ask_runbooks", "name": "Ask the runbooks", "description": "Answer an IT / operations question from City Holdings runbooks (SOPs), with numbered steps, inline citations and links to the source pages. English or Burmese. metadata.aria carries {text_md, steps, sources, open_runbook_url, served_from, trace_id, language}. The reply also carries a data part (application/json, type aria.answer): steps with the sources each cites, sources (title, quoted passage, location, link), links.", "tags": ["runbooks", "sop", "itsm"], "examples": ["How do I create a new site in Gold Central?", "ဆိုက်အသစ် ဘယ်လိုဖွင့်ရမလဲ"], "inputModes": ["text/plain"], "outputModes": ["text/markdown", "application/json"]}, {"id": "get_steps", "name": "Get a runbook's steps", "description": "The step-by-step procedure of one named runbook, with its source pages. Send the runbook name as the message and skillId=get_steps in metadata. Data part type aria.answer. When the name fits several runbooks the task stops at input-required (data part aria.choice); answer on the same task with the number or the name.", "tags": ["runbooks", "steps"], "examples": ["New Site Creation", "Patch Installation"], "inputModes": ["text/plain"], "outputModes": ["text/markdown", "application/json"]}, {"id": "my_approvals", "name": "Items waiting for my approval", "description": "Lists what waits for the caller's decision (corrections, facts, conflicts, Q&A, owner checks, standard drafts). Send 'approve fact:12' / 'reject standard:3' (optionally followed by a note) to decide one; the owning module records it. Data parts aria.approvals / aria.decision. 'approve' or 'reject' with no item id stops at input-required (aria.choice) to ask which item.", "tags": ["review", "approvals"], "examples": ["list", "approve qa:1000003 looks right"], "inputModes": ["text/plain"], "outputModes": ["text/markdown", "application/json"]}, {"id": "what_changed", "name": "What changed this week", "description": "A read-only summary of new/updated runbooks, approved facts, resolved conflicts and new gaps over the last N days (default 7). Posts nothing anywhere. Data part type aria.changes.", "tags": ["changes", "weekly"], "examples": ["7", "last 14 days"], "inputModes": ["text/plain"], "outputModes": ["text/markdown", "application/json"]}], "security": [{"bearer": []}, {"apiKey": []}, {"sso": ["openid", "email"]}], "protocolVersion": "0.3.0", "url": "https://itsm.citygpt.xyz/api/v1/a2a", "preferredTransport": "JSONRPC", "additionalInterfaces": [{"url": "https://itsm.citygpt.xyz/api/v1/a2a", "transport": "JSONRPC"}], "supportsAuthenticatedExtendedCard": false}