# AI Task Hub

Version: 3.0.5

Connector-first installation is recommended. Published skill remains fallback-only, and raw execute/poll/presentation is compatibility-oriented.

## Read This First
- Do not mix connector lifecycle commands with published skill actions.
- Connector lifecycle commands are host/runtime controls: connect, status, invoke, logout.
- Published skill actions are the stable AI/account operations: portal.account.connect, portal.skill.execute, portal.skill.poll, portal.skill.presentation, portal.account.balance, portal.account.ledger.
- Prefer connector/runtime result-first flow before raw execute/poll/presentation surfaces.
- Do not treat poll/presentation as universal default steps; use them only when the capability delivery mode needs follow-up.
- Public capability families list only enabled, intentionally advertised capabilities.

## Connector Install Surfaces
- Add AI Task Hub Connector: https://gateway.binaryworks.app/connectors/remote
- Hosted connector manifest: https://gateway.binaryworks.app/connectors/remote/manifest.json
- Hosted connector install endpoint: https://gateway-api.binaryworks.app/agent/hosted-connector/install
- Hosted connector connect endpoint: https://gateway-api.binaryworks.app/agent/hosted-connector/connect
- Hosted connector invoke endpoint: https://gateway-api.binaryworks.app/agent/hosted-connector/invoke
- Hosted connector status endpoint: https://gateway-api.binaryworks.app/agent/hosted-connector/status
- Hosted connector logout endpoint: https://gateway-api.binaryworks.app/agent/hosted-connector/logout
- One-command Bootstrap: https://gateway.binaryworks.app/connectors/local-bootstrap
- Bootstrap command: npx -y @binaryworks1024/ai-task-hub-connector@latest bootstrap --host <host_name> --check

Install from this site URL without pre-shared bootstrap secrets.

## Compatibility Onboarding (Install Code)
1. POST https://gateway-api.binaryworks.app/agent/install-code/issue with JSON body {"channel":"local"}.
2. Read data.install_code (and data.owner_uid if returned).
3. POST https://gateway-api.binaryworks.app/agent/bootstrap with JSON body {"agent_uid":"<agent_uid>","install_code":"<install_code>"}.
4. Read data.api_key and prefer connector/hosted-connector invoke surfaces before direct raw execute/poll calls.
5. Only use https://gateway-api.binaryworks.app/skill/execute and https://gateway-api.binaryworks.app/skill/runs/%3Crun_id%3E when direct API compatibility or debugging is required.

## 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

## Compatibility Runtime Contract
- Raw execute: POST https://gateway-api.binaryworks.app/skill/execute
- Raw poll: GET https://gateway-api.binaryworks.app/skill/runs/%7Brun_id%7D
- Default host UX should stay connector-first and result-first; use the raw contract only when compatibility or debugging requires it.
- Supports file uploads/chat attachments; user-facing forms should not require manual URL or raw JSON input.

## Discovery Entry Points
- site_skill_markdown_url: https://gateway.binaryworks.app/SKILL.md
- llms_url: https://gateway.binaryworks.app/llms.txt
- skill_hub_url: https://gateway.binaryworks.app/.well-known/skill-hub.json
- connectors_url: https://gateway.binaryworks.app/connectors
- remote_connector_manifest_url: https://gateway.binaryworks.app/connectors/remote/manifest.json
- api_skill_markdown_url: https://gateway-api.binaryworks.app/skills/SKILL.md
- manifest_url: https://gateway-api.binaryworks.app/skills/manifest.json