{"_id":"@agenticros/detect-humans","name":"@agenticros/detect-humans","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@agenticros/detect-humans","version":"0.1.0","type":"module","description":"External ROS-node skill: read human/person detections from a vision_msgs Detection2DArray topic.","keywords":["agenticros","ros2","vision","detection","yolo","humans"],"homepage":"https://github.com/agenticros/agenticros-skill-detect-humans#readme","bugs":{"url":"https://github.com/agenticros/agenticros-skill-detect-humans/issues"},"repository":{"type":"git","url":"git+https://github.com/agenticros/agenticros-skill-detect-humans.git"},"main":"dist/index.js","types":"dist/index.d.ts","scripts":{"build":"tsc","typecheck":"tsc --noEmit"},"agenticros":{"id":"detect-humans","displayName":"Detect Humans","description":"Subscribe once to a vision_msgs/Detection2DArray topic (or compatible detection stream) published by your on-robot YOLO/MediaPipe stack. Differentiates from in-process find_object: the perception node stays on the robot.","categories":["vision","perception"],"capabilities":[{"id":"detect_humans","verb":"detect","description":"Read one Detection2DArray message from the configured detections topic (person/human class filter is operator-side).","inputs":{"topic":{"type":"string","description":"Detections topic (default: detections). Namespaced under the robot namespace.","optional":true},"mode":{"type":"string","description":"Must be subscribe for read-once (default subscribe).","optional":true,"default":"subscribe"},"timeout_ms":{"type":"number","description":"Subscribe timeout in milliseconds.","optional":true}},"outputs":{"detections":{"type":"object","description":"Raw Detection2DArray (or transport-decoded equivalent)."}},"interruptible":true,"blocks_base":false,"implementation":{"kind":"external_ros_node","package":"vision_msgs","topic":"detections","msg_type":"vision_msgs/msg/Detection2DArray"}}]},"devDependencies":{"@types/node":"^20.17.0","typescript":"^5.7.0"},"author":{"name":"AgenticROS"},"license":"Apache-2.0","publishConfig":{"access":"public"},"_id":"@agenticros/detect-humans@0.1.0","gitHead":"c881ccb4baf8569767f455ef0528f7394a19a558","_nodeVersion":"22.23.1","_npmVersion":"10.9.8","dist":{"integrity":"sha512-G7z/xJ9pw9mpEB414yeSmuuTBOsagUQcihY1zXeKt3uzfQXmmN0n9QlXlNRzzqZGGX6mKa6fSBKc+Cy8F6NGZQ==","shasum":"dee04ce00f0f389810011821edb735b6166fe674","tarball":"https://registry.npmjs.org/@agenticros/detect-humans/-/detect-humans-0.1.0.tgz","fileCount":7,"unpackedSize":16095,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIA4nh96ASLDz5/jMfLs3VrvwzGgeq9PH7II9MwcJ5xmBAiEAyM3rVEj30eJrqJJC6erzDBxtv05SuTlmizI7ZkpWfCg="}]},"_npmUser":{"name":"chrismatthieu","email":"chris@matthieu.us"},"directories":{},"maintainers":[{"name":"chrismatthieu","email":"chris@matthieu.us"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/detect-humans_0.1.0_1783638133102_0.4675121128646347"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-09T23:02:12.920Z","0.1.0":"2026-07-09T23:02:13.268Z","modified":"2026-07-09T23:02:13.535Z"},"maintainers":[{"name":"chrismatthieu","email":"chris@matthieu.us"}],"description":"External ROS-node skill: read human/person detections from a vision_msgs Detection2DArray topic.","homepage":"https://github.com/agenticros/agenticros-skill-detect-humans#readme","keywords":["agenticros","ros2","vision","detection","yolo","humans"],"repository":{"type":"git","url":"git+https://github.com/agenticros/agenticros-skill-detect-humans.git"},"author":{"name":"AgenticROS"},"bugs":{"url":"https://github.com/agenticros/agenticros-skill-detect-humans/issues"},"license":"Apache-2.0","readme":"# Detect Humans — external vision skill\n\nAgenticROS skill that wraps an **on-robot** detection topic as the `detect_humans` capability. AgenticROS does **not** run YOLO for you — bring up your perception node, then install this skill.\n\n```bash\nnpx agenticros skills install chrismatthieu/detect-humans\n# or pin in config:\n# \"skillRefs\": [\"chrismatthieu/detect-humans\"]\n```\n\nRestart the gateway / MCP server. `ros2_list_capabilities` should include `detect_humans`.\n\n## Mission example\n\n```json\n{\n  \"mission\": {\n    \"name\": \"sample detections\",\n    \"steps\": [\n      {\n        \"id\": \"det\",\n        \"capability\": \"detect_humans\",\n        \"inputs\": { \"mode\": \"subscribe\", \"timeout_ms\": 5000 }\n      }\n    ]\n  }\n}\n```\n\nOverride the topic if your stack does not publish `detections`:\n\n```json\n{ \"capability\": \"detect_humans\", \"inputs\": { \"topic\": \"yolo/detections\", \"mode\": \"subscribe\" } }\n```\n\n## Requirements\n\n- A ROS 2 node publishing `vision_msgs/msg/Detection2DArray` (or a transport-compatible equivalent)\n- Transport with subscribe support (Zenoh, rosbridge, local, WebRTC)\n\n## vs `find_object`\n\n| | `find_object` | `detect_humans` |\n|---|---|---|\n| Where inference runs | In-process (gateway / MCP) | On the robot |\n| Motion | Rotates base until hit | Read-only subscribe |\n| Typical use | Quick object search demos | Fleet-standard perception stacks |\n","readmeFilename":"README.md","_rev":"1-97aa3071d11c90db9659e2dfb354d62a"}