> Documentation index for agents: https://docs.rocketride.ai/llms.txt

# memory_internal

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:

| Function | Description |
| --- | --- |
| `memory.put` | Store a value under a key. |
| `memory.get` | Retrieve the value for a key. |
| `memory.list` | Return all stored keys in sorted order. |
| `memory.clear` | Remove 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

- [RocketRide documentation](https://docs.rocketride.org)

<!-- ROCKETRIDE:GENERATED:PARAMS START -->
<!-- Generated by nodes:docs-generate. Do not edit by hand. -->

## Schema

_No configuration fields._

## Source

[<svg viewBox="0 0 16 16" width="15" height="15" fill="currentColor" aria-hidden="true" style="vertical-align:-0.15em;margin-right:0.35em"><path d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"/></svg> View source](https://github.com/rocketride-org/rocketride-server/tree/develop/nodes/src/nodes/memory_internal)
<!-- ROCKETRIDE:GENERATED:PARAMS END -->
