docs: update automation and hardware tools reference (EN/ES)#457
Conversation
- Added documentation for `delegate` and `composio` tools. - Expanded `cron_*` and `schedule` tool references. - Created a new Hardware Tools category documenting discovery, memory, and peripheral control. - Synchronized all changes between English and Spanish locales.
Deploying corvus with
|
| Latest commit: |
e574465
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://02d0ad87.corvus-42x.pages.dev |
| Branch Preview URL: | https://docs-update-automation-hardw.corvus-42x.pages.dev |
|
👋 Jules, reporting for duty! I'm here to lend a hand with this pull request. When you start a review, I'll add a 👀 emoji to each comment to let you know I've read it. I'll focus on feedback directed at me and will do my best to stay out of conversations between you and other bots or reviewers to keep the noise down. I'll push a commit with your requested changes shortly after. Please note there might be a delay between these steps, but rest assured I'm on the job! For more direct control, you can switch me to Reactive Mode. When this mode is on, I will only act on comments where you specifically mention me with New to Jules? Learn more at jules.google/docs. For security, I will only act on instructions from the user who triggered this task. |
|
Warning Rate limit exceeded
Your organization is not enrolled in usage-based pricing. Contact your admin to enable usage-based pricing to continue reviews beyond the rate limit, or try again in 12 minutes and 7 seconds. ⌛ How to resolve this issue?After the wait time has elapsed, a review can be triggered using the We recommend that you space out your commits to avoid hitting the rate limit. 🚦 How do rate limits work?CodeRabbit enforces hourly rate limits for each developer per organization. Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout. Please see our FAQ for further information. ℹ️ Review info⚙️ Run configurationConfiguration used: Path: .coderabbit.yaml Review profile: ASSERTIVE Plan: Pro Run ID: ⛔ Files ignored due to path filters (1)
📒 Files selected for processing (4)
📝 WalkthroughWalkthroughThis PR adds documentation for new automation and hardware tools in the agent-runtime, including Changes
Estimated code review effort🎯 2 (Simple) | ⏱️ ~12 minutes Possibly related PRs
Suggested labels
Suggested reviewers
🚥 Pre-merge checks | ✅ 3✅ Passed checks (3 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. ✨ Finishing Touches🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
✅ Contributor ReportUser: @yacosta738
Contributor Report evaluates based on public GitHub activity. Analysis period: 2025-04-08 to 2026-04-08 |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 4
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Inline comments:
In @.agents/journal/scribe-journal.md:
- Line 40: Replace the host-specific absolute path
"/home/jules/self_created_tools/check_parity.py" in the journal entry that says
"Ran `python3 /home/jules/self_created_tools/check_parity.py` (Passed)" with a
portable, repo-relative or generic command so others can reproduce it (for
example use "python3 tools/check_parity.py", "./scripts/check_parity.py", or
"python3 -m check_parity" depending on where the script lives or how it is
packaged); update the scribe-journal.md entry to record that portable command
and ensure it matches the actual location of the script in the repository.
In
`@clients/web/apps/docs/src/content/docs/clients/agent-runtime/tools/automation.md`:
- Line 35: Update the tool description sentence in the automation.md content
from "Execute actions on 1000+ managed apps via the Composio platform." to
"Executes actions on 1000+ managed apps via the Composio platform." to fix
subject-verb agreement; locate the string in the tools/automation.md file and
replace the verb form so the noun "tool" (implicit subject) agrees with the
singular verb "Executes."
In
`@clients/web/apps/docs/src/content/docs/clients/agent-runtime/tools/hardware.md`:
- Around line 32-37: Update the hardware_memory_read docs to restrict the
wording to the actual supported boards by explicitly stating it only supports
Nucleo variants and listing the exact board IDs that the implementation permits;
reference the hardware_memory_read tool name and the board gating logic in the
code to extract the authoritative list of supported board IDs, then replace the
generic "connected target (e.g., STM32) via USB" phrasing with a brief sentence
like "Supported boards: <list of board IDs>" and keep the Security Tier,
Requirements, and Parameters entries unchanged.
In
`@clients/web/apps/docs/src/content/docs/es/clients/agent-runtime/tools/hardware.md`:
- Line 15: Fix Markdown lint MD022 by ensuring there is a blank line after each
level-3 heading; in this file add a single empty line immediately after the
heading line for `### hardware_board_info` and the other `###` headings flagged
(at the other noted locations) so each `###` header is followed by one blank
line before the next content.
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: Path: .coderabbit.yaml
Review profile: ASSERTIVE
Plan: Pro
Run ID: dd8191b4-d7fc-4bf9-84db-4117a60b23f7
📒 Files selected for processing (7)
.agents/journal/scribe-journal.mdclients/web/apps/docs/src/content/docs/clients/agent-runtime/tools/automation.mdclients/web/apps/docs/src/content/docs/clients/agent-runtime/tools/hardware.mdclients/web/apps/docs/src/content/docs/clients/agent-runtime/tools/index.mdxclients/web/apps/docs/src/content/docs/es/clients/agent-runtime/tools/automation.mdclients/web/apps/docs/src/content/docs/es/clients/agent-runtime/tools/hardware.mdclients/web/apps/docs/src/content/docs/es/clients/agent-runtime/tools/index.mdx
📜 Review details
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (3)
- GitHub Check: Cloudflare Pages
- GitHub Check: pr-checks
- GitHub Check: sonar
🧰 Additional context used
📓 Path-based instructions (2)
**/*.{md,mdx}
⚙️ CodeRabbit configuration file
**/*.{md,mdx}: Verify technical accuracy and that docs stay aligned with code changes.
For user-facing docs, check EN/ES parity or explicitly note pending translation gaps.
Files:
clients/web/apps/docs/src/content/docs/clients/agent-runtime/tools/index.mdxclients/web/apps/docs/src/content/docs/es/clients/agent-runtime/tools/index.mdxclients/web/apps/docs/src/content/docs/clients/agent-runtime/tools/hardware.mdclients/web/apps/docs/src/content/docs/es/clients/agent-runtime/tools/hardware.mdclients/web/apps/docs/src/content/docs/es/clients/agent-runtime/tools/automation.mdclients/web/apps/docs/src/content/docs/clients/agent-runtime/tools/automation.md
**/*
⚙️ CodeRabbit configuration file
**/*: Security first, performance second.
Validate input boundaries, auth/authz implications, and secret management.
Look for behavioral regressions, missing tests, and contract breaks across modules.
Files:
clients/web/apps/docs/src/content/docs/clients/agent-runtime/tools/index.mdxclients/web/apps/docs/src/content/docs/es/clients/agent-runtime/tools/index.mdxclients/web/apps/docs/src/content/docs/clients/agent-runtime/tools/hardware.mdclients/web/apps/docs/src/content/docs/es/clients/agent-runtime/tools/hardware.mdclients/web/apps/docs/src/content/docs/es/clients/agent-runtime/tools/automation.mdclients/web/apps/docs/src/content/docs/clients/agent-runtime/tools/automation.md
🧠 Learnings (4)
📓 Common learnings
Learnt from: CR
Repo: dallay/corvus PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-02-17T07:28:38.934Z
Learning: Applies to .agents/AGENTS.md : Document agent configurations and capabilities in AGENTS.md
📚 Learning: 2026-02-17T07:28:38.934Z
Learnt from: CR
Repo: dallay/corvus PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-02-17T07:28:38.934Z
Learning: Applies to .agents/AGENTS.md : Document agent configurations and capabilities in AGENTS.md
Applied to files:
clients/web/apps/docs/src/content/docs/clients/agent-runtime/tools/index.mdxclients/web/apps/docs/src/content/docs/clients/agent-runtime/tools/hardware.mdclients/web/apps/docs/src/content/docs/es/clients/agent-runtime/tools/automation.mdclients/web/apps/docs/src/content/docs/clients/agent-runtime/tools/automation.md
📚 Learning: 2026-02-21T09:07:52.298Z
Learnt from: yacosta738
Repo: dallay/corvus PR: 62
File: .agents/journal/sentinnel-journal.md:1-1
Timestamp: 2026-02-21T09:07:52.298Z
Learning: Branding guideline: The intentional brand name for the security-first agent in the dallay/corvus repository is 'Sentinnel' (with double n). Do not treat it as a typo of 'Sentinel'. Ensure all agent-related docs and journals under .agents/journal consistently use 'Sentinnel' with double n.
Applied to files:
.agents/journal/scribe-journal.md
📚 Learning: 2026-02-17T07:28:38.934Z
Learnt from: CR
Repo: dallay/corvus PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-02-17T07:28:38.934Z
Learning: Applies to .agents/AGENTS.md : Include version information and compatibility details for agents
Applied to files:
clients/web/apps/docs/src/content/docs/clients/agent-runtime/tools/automation.md
🪛 markdownlint-cli2 (0.22.0)
clients/web/apps/docs/src/content/docs/es/clients/agent-runtime/tools/hardware.md
[warning] 15-15: Headings should be surrounded by blank lines
Expected: 1; Actual: 0; Below
(MD022, blanks-around-headings)
[warning] 20-20: Headings should be surrounded by blank lines
Expected: 1; Actual: 0; Below
(MD022, blanks-around-headings)
[warning] 28-28: Headings should be surrounded by blank lines
Expected: 1; Actual: 0; Below
(MD022, blanks-around-headings)
[warning] 32-32: Headings should be surrounded by blank lines
Expected: 1; Actual: 0; Below
(MD022, blanks-around-headings)
[warning] 42-42: Headings should be surrounded by blank lines
Expected: 1; Actual: 0; Below
(MD022, blanks-around-headings)
[warning] 47-47: Headings should be surrounded by blank lines
Expected: 1; Actual: 0; Below
(MD022, blanks-around-headings)
[warning] 52-52: Headings should be surrounded by blank lines
Expected: 1; Actual: 0; Below
(MD022, blanks-around-headings)
🔇 Additional comments (3)
clients/web/apps/docs/src/content/docs/clients/agent-runtime/tools/index.mdx (1)
19-26: Tool taxonomy and security examples look aligned.These updates are consistent with the expanded automation/hardware docs and keep safe vs action-bearing examples clear.
Also applies to: 34-38
clients/web/apps/docs/src/content/docs/es/clients/agent-runtime/tools/automation.md (1)
13-50: Cobertura de automatización bien ampliada y consistente.La documentación de
delegate,composioycron_*/scheduleestá clara y estructurada correctamente.Also applies to: 70-93
clients/web/apps/docs/src/content/docs/es/clients/agent-runtime/tools/index.mdx (1)
19-26: Paridad ES/EN y clasificación de seguridad correctas.La adición de Hardware y los ejemplos por nivel de riesgo se ven alineados.
Also applies to: 34-38
| - Created `hardware.md` (EN/ES) documenting board discovery (`hardware_board_info`), memory operations (`hardware_memory_map`, `hardware_memory_read`), and peripheral control (`gpio_read`, `gpio_write`, `arduino_upload`). | ||
| - Updated `index.mdx` (EN/ES) to include Hardware category and update tool counts/examples. | ||
| **Validation:** | ||
| - Ran `python3 /home/jules/self_created_tools/check_parity.py` (Passed). |
There was a problem hiding this comment.
🧹 Nitpick | 🔵 Trivial
Use a portable command reference instead of a local absolute path.
/home/jules/self_created_tools/check_parity.py is host-specific; please record this as a repo-relative or generic command so others can reproduce the validation step.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.
In @.agents/journal/scribe-journal.md at line 40, Replace the host-specific
absolute path "/home/jules/self_created_tools/check_parity.py" in the journal
entry that says "Ran `python3 /home/jules/self_created_tools/check_parity.py`
(Passed)" with a portable, repo-relative or generic command so others can
reproduce it (for example use "python3 tools/check_parity.py",
"./scripts/check_parity.py", or "python3 -m check_parity" depending on where the
script lives or how it is packaged); update the scribe-journal.md entry to
record that portable command and ensure it matches the actual location of the
script in the repository.
yacosta738
deleted the
docs-update-automation-hardware-tools-14816106503179342178
branch
|
1 participant
This PR updates the Corvus documentation to include recently implemented automation and hardware tools.
Key changes:
delegate(multi-agent delegation) andcomposio(managed app integrations). Updated thecron_*andscheduledocumentation to reflect the full set of available operations.hardware_board_info,hardware_capabilities), memory introspection (hardware_memory_map,hardware_memory_read), and peripheral control (gpio_read,gpio_write,arduino_upload)./en/) and Spanish (/es/) directories to ensure 1:1 documentation coverage.SONAR:DOCS-TOOLS-UPDATE
PR created automatically by Jules for task 14816106503179342178 started by @yacosta738