MemoGrafter
ingestGraftedNodes()
Copy supplied nodes into a target session.
What it does
Copy supplied nodes into a target session.
When to use it
Use to copy already-selected source topics into an application-owned target session.
Signature
TypeScript
ingestGraftedNodes(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
Creates target-side topic and memory IDs and records source provenance.
Side effects and completion
Writes to the target session; source nodes remain unchanged.
Example
example.ts
await memo.ingestGraftedNodes(nodes, "target");