Skip to main content
View source

Memory (Internal)

View as Markdown

A RocketRide in-process memory node for temporary, keyed values within a pipeline instance. Pick it for short-lived agent scratch space; use memory_persistent when state must be retained across sessions.

About RocketRide

RocketRide hosts this node as a Python pipeline component. The node itself implements a small in-process store and has no separately configured service or dependency.

What it does

Creates a new keyed store for each node instance, then clears that store when the instance is opened. It has no data lanes: its registered operations store, retrieve, list, and clear values for code or an agent using the node. Choose it over memory_persistent when the desired lifetime is only the current instance and an external backend is unnecessary.

Configuration

This node has no configuration fields, profiles, or lanes. Add it when its run-scoped lifetime is appropriate; stored values are not copied or persisted by the node, so do not use it for data that must survive a new instance.

Notes

Registered operations

The node registers four operations under the memory prefix:

FunctionDescription
memory.putStore a value under a key.
memory.getRetrieve the value for a key.
memory.listReturn all stored keys in sorted order.
memory.clearRemove one key or all keys.

memory.put requires a non-empty string key and a value; it trims the key before storing and returns {ok: true, key}. memory.get requires a non-empty string key; a missing key returns {ok: false, key, value: null}. The no-argument memory.list returns {ok: true, keys}. memory.clear accepts an optional string key; omitting it, or supplying an empty or whitespace-only key, clears every stored key and returns them in cleared.

Calls whose argument object is not a dictionary, or whose required key/value is invalid or missing, raise a ValueError before reaching the store. Clearing a specified key that does not exist is successful and returns an empty cleared list.

Lifetime

beginInstance creates the store and open clears it. In particular, opening the node starts with an empty store even if the same instance was previously used. The implementation uses a Python dictionary only; it does not provide cross-instance or cross-process persistence.

Upstream docs

Schema

No configuration fields.