Skip to documentation
Docs navigation
Docs/absorbNodes()
MemoGrafter

absorbNodes()

Copy selected nodes into a target session.

What it does

Copy selected nodes into a target session.

When to use it

Use after selectNodesForAbsorb() or another trusted selection step to persist copied topics.

Signature

TypeScript
absorbNodes(nodes: TopicNode[], targetSessionId: string): Promise<TopicNode[]>

Parameters

nodes (TopicNode[]) — Topic nodes, including their active memories, to copy.
targetSessionId (string) — The session that will receive copied memory.

TopicNode fields

id, sessionId, and segmentId identify the topic and its owning session/segment.
label is the short extracted topic name; summary is its generated description.
messageRange is the inclusive source-message index range; topicOrder is its position in the session.
driftScore records the topic-boundary signal. embedding is the stored semantic vector and can be large.
tags and source preserve caller metadata.
suppressed and suppressedAt describe topic lifecycle state.
agentColor, fleetId, and agentId are populated for fleet-owned topics and otherwise are null.
createdAt is a JavaScript Date when read through the package API.

Result

The topic nodes created, selected, or copied by the operation.

Behavior

Copies eligible active memory and provenance into the target session and returns the new target nodes.

Side effects and completion

Writes target-session graph state.

Example

example.ts
await memo.absorbNodes(selected, "target");