# AI Task Hub

version: 3.0.5
preferred_install: connector_first
homepage_url: https://gateway.binaryworks.app
api_base_url: https://gateway-api.binaryworks.app
manifest_url: https://gateway-api.binaryworks.app/skills/manifest.json
skill_markdown_url: https://gateway-api.binaryworks.app/skills/SKILL.md
install_code_issue_url: https://gateway-api.binaryworks.app/agent/install-code/issue
openapi_url: https://gateway-api.binaryworks.app/.well-known/openapi.json
openapi_alias_url: https://gateway-api.binaryworks.app/openapi.json
bootstrap_url: https://gateway-api.binaryworks.app/agent/bootstrap

connector_install:
- catalog_url: https://gateway.binaryworks.app/connectors
- remote_connector_guide_url: https://gateway.binaryworks.app/connectors/remote
- remote_connector_manifest_url: https://gateway.binaryworks.app/connectors/remote/manifest.json
- remote_connector_install_endpoint_url: https://gateway-api.binaryworks.app/agent/hosted-connector/install
- remote_connector_connect_endpoint_url: https://gateway-api.binaryworks.app/agent/hosted-connector/connect
- remote_connector_invoke_endpoint_url: https://gateway-api.binaryworks.app/agent/hosted-connector/invoke
- remote_connector_status_endpoint_url: https://gateway-api.binaryworks.app/agent/hosted-connector/status
- remote_connector_logout_endpoint_url: https://gateway-api.binaryworks.app/agent/hosted-connector/logout
- remote_connector_auth_header: x-connector-token
- local_bootstrap_guide_url: https://gateway.binaryworks.app/connectors/local-bootstrap
- local_bootstrap_command: npx -y @binaryworks1024/ai-task-hub-connector@latest bootstrap --host <host_name> --check

surface_split:
- connector_lifecycle_commands: connect, status, invoke, logout
- published_skill_actions: portal.account.connect, portal.skill.execute, portal.skill.poll, portal.skill.presentation, portal.account.balance, portal.account.ledger
- note: do not summarize connector lifecycle commands as the capability inventory
- note: prefer connector/runtime result-first flow as the default host UX
- note: do not teach every capability as execute -> poll -> presentation; follow the published delivery mode instead

public_capability_families:
- image_analysis: Human Detect, Image Tagging, Face Detect, Body Keypoints 2D, Face Emotion Recognition
- background_removal: Person Instance Segmentation, Person Semantic Segmentation, Concert Cutout, Full Body Matting, Head Matting, Product Cutout
- audio: ASR, TTS Report, TTS Low Cost
- document: Markdown Convert
- retrieval: Embeddings, Reranker
- generation: Image Generation
- video: Video Face Generation

onboarding:
- first_step: POST /agent/install-code/issue to receive install_code
- second_step: POST /agent/bootstrap with agent_uid + install_code
- third_step: prefer hosted connector invoke or connector run; use raw execute/poll only when direct API compatibility is required
- api_key_path: data.api_key

discovery_urls:
- https://gateway.binaryworks.app/.well-known/ai-plugin.json
- https://gateway.binaryworks.app/.well-known/openapi.json
- https://gateway.binaryworks.app/.well-known/skill-hub.json
- https://gateway.binaryworks.app/llms.txt
- https://gateway.binaryworks.app/SKILL.md