Skip to content

Update Eldritch documentation for built-ins and stdlib#1923

Merged
KCarretto merged 1 commit intomainfrom
eldritch-docs-update-6686632203357497327
Feb 27, 2026
Merged

Update Eldritch documentation for built-ins and stdlib#1923
KCarretto merged 1 commit intomainfrom
eldritch-docs-update-6686632203357497327

Conversation

@KCarretto
Copy link
Collaborator

Identified missing and incorrect documentation for Eldritch functions by inspecting the source code in implants/lib/eldritch. Added a new section for built-in functions and updated the standard library documentation to match the current implementation. Regenerated the JSON documentation file used by the ShellV2 UI.


PR created automatically by Jules for task 6686632203357497327 started by @KCarretto

…rary functions

- Add `# Built-Ins` section to `eldritch.md` documenting all built-in functions (e.g., `abs`, `len`, `print`).
- Update `# Standard Library` section:
  - `crypto`: Add `aes_decrypt`, `aes_encrypt`, `md5`, `sha1`, `sha256`.
  - `file`: Rename `moveto` to `move`, update `timestomp` signature.
  - `pivot`: Add `create_portal`, `reverse_shell_repl`, update `port_scan` with `fd_limit`.
  - `random`: Add `bytes`, `uuid`.
  - `report`: Add `screenshot`.
  - `sys`: Add `list_users`, update `exec` with `input`.
  - `time`: Fix `sleep` parameter type.
- Regenerate `tavern/internal/www/src/assets/eldritch-docs.json`.

Co-authored-by: KCarretto <16250309+KCarretto@users.noreply.github.com>
@google-labs-jules
Copy link
Contributor

👋 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 @jules. You can find this option in the Pull Request section of your global Jules UI settings. You can always switch back!

New to Jules? Learn more at jules.google/docs.


For security, I will only act on instructions from the user who triggered this task.

@github-actions
Copy link
Contributor

Summary

Tests 📝 Passed ✅ Failed ❌ Skipped ⏭️ Other ❓ Flaky 🍂 Duration ⏱️
2690    ±0 2690    ±0 0    ±0 0    ±0 0    ±0 0    ±0 1ms    ±0

Previous Results

Build 🏗️ Result 🧪 Tests 📝 Passed ✅ Failed ❌ Skipped ⏭️ Other ❓ Flaky 🍂 Duration ⏱️
#1316 2690 2690 0 0 0 0 43.4s

Insights

Average Tests per Run Total Flaky Tests Total Failed Slowest Test (p95)
2690 0 0 6.0s

Slowest Tests

Test 📝 Results 📊 Duration (avg) ⏱️ Duration (p95) ⏱️
TestDockerExecutor_Build_ContextCancellation 1 6.0s 6.0s
eldritch-libsys: std::dll_inject_impl::tests::test_dll_inject_simple 1 5.1s 5.1s
TestInteractiveShell 1 5.0s 5.0s
TestOtherStreamOutput 1 5.0s 5.0s
imix::bin/imix: install::tests::test_install_execution 3 1.6s 4.6s
imix::bin/imix: install::tests::test_install_execution 3 1.6s 4.6s
imix::bin/imix: install::tests::test_install_execution 3 1.6s 4.6s
imix::bin/imix: tests::task_tests::test_task_streaming_output 3 3.0s 3.0s
imix::bin/imix: tests::task_tests::test_task_streaming_output 3 3.0s 3.0s
imix::bin/imix: tests::task_tests::test_task_streaming_output 3 3.0s 3.0s

🎉 No failed tests in this run. | 🍂 No flaky tests in this run.

Github Test Reporter by CTRF 💚

@KCarretto KCarretto marked this pull request as ready for review February 27, 2026 00:47
@KCarretto KCarretto merged commit 12306d0 into main Feb 27, 2026
8 checks passed
@KCarretto KCarretto deleted the eldritch-docs-update-6686632203357497327 branch February 27, 2026 00:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant