feat: per-object node parameters (object property bag) — POC

[stepmikhaylov]

⚠️ POC / proof-of-concept — opened for design review, not merge-ready.

Adds per-object node parameters: a client can attach parameters to an individual object that override a node's startup configuration for that object only, addressed by pipeline component id.

Flow

client.send_files(..., parameters={'<nodeId>': {...}})
  → rrext_process "open"
  → seeded onto the shared Entry (entry.setParameters)
  → node reads its OWN slice via self.params

Changes

• engine (C++) — Entry.parameters transport bag (namespaced by component id) + entry.setParameters() binding (entry.hpp, bindings.cpp).
• rocketlib — IInstanceBase.params: lazy, per-object accessor that merges the node's resolved config (Config.getNodeConfig) with the object's own slice (per-object overrides win); cached and reset on close() (filters.py).
• ai — data_conn open handler seeds the source Entry from the parameters argument.
• client SDKs — parameters= added to send_files / pipe / DataPipe (Python and TypeScript).
• frame_grabber — reads self.params['interval'] to vary frame-extraction rate per object (rebuilds the reader since fps is baked at construction).

Isolation

self.params exposes only the processing node's own slice (entry.parameters[selfId]); other nodes' parameters are not reachable through it.

Open items / known rough edges (POC)

• rocketlib → ai runtime dependency (local import) for getNodeConfig.
• Shallow merge of object slice over node config.
• UI declaration (Object section in services.json) and the engine-side rrext_process HTTP path are not included — this PR is the runtime/SDK path only.
• POC demo test (client-python frame_grabber interval comparison).

Design discussion: #1292

🤖 Generated with Claude Code

[github-actions]

🤖 Internal: Discord sync marker

Auto-managed by the Discord notification workflow. Stores the linked Discord message ID. Do not edit or delete.

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

Run ID: 6a2e9244-6b90-4ad4-8361-8f118df78d42

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/object-property-bag

---

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.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}