Skip to content

Add minimal Runtime inspection commands#11

Merged
V3RON merged 3 commits intomasterfrom
feat/runtime-domain
May 6, 2026
Merged

Add minimal Runtime inspection commands#11
V3RON merged 3 commits intomasterfrom
feat/runtime-domain

Conversation

@V3RON
Copy link
Copy Markdown
Contributor

@V3RON V3RON commented May 6, 2026

Summary

Adds a new runtime command family so tool users can evaluate live expressions, inspect returned remote object handles, and explicitly release preserved Runtime references on Chrome, Node.js, and React Native targets.

Context

This change introduces a focused src/runtime/ module and keeps the scope intentionally small: runtime eval, runtime props, runtime release, and runtime release-group. The default behavior preserves remote object handles in the agent-cdp-runtime object group so an agent can evaluate first and inspect properties in a follow-up step before releasing the handle.

Backward-compatibility: existing command families, daemon lifecycle, and default output formats remain unchanged. This only adds a new top-level command family, new packaged skill guidance, and README coverage for Runtime inspection.

Risks

  • Runtime evaluation is intentionally powerful and can cause side effects if the expression mutates target state.
  • Runtime object handles are preserved by default, so callers need to release them in long-lived sessions when they are no longer needed.
  • Property/value previews depend on what the target runtime exposes through CDP, so Chrome, Node.js, and React Native may differ slightly in descriptions even though the command surface is shared.

Fixes #8

Manual testing

  1. Start the daemon and select a Chrome, Node.js, or React Native target that exposes CDP.
  2. Run agent-cdp runtime eval --expr "process.version" or another read-only expression appropriate for the target, and verify primitive values print compactly.
  3. Run agent-cdp runtime eval --expr "globalThis" and verify the output includes an objectId for follow-up inspection.
  4. Run agent-cdp runtime props --id <OBJECT_ID> --own and verify returned properties include concise summaries and nested object handles when present.
  5. Run agent-cdp runtime release --id <OBJECT_ID> or agent-cdp runtime release-group and verify cleanup succeeds without changing other command workflows.

@V3RON V3RON merged commit 73167b9 into master May 6, 2026
4 checks passed
@V3RON V3RON deleted the feat/runtime-domain branch May 6, 2026 10:59
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.

Add minimal Runtime domain support for live inspection

1 participant