Skip to documentation
Docs navigation
Docs/graftColorIntoAgent()
Fleet Memory

graftColorIntoAgent()

Transfer memory from one worker color.

What it does

Transfer memory from one worker color.

The operation follows the fleet’s memory mode and agent identity rules when selecting, storing, or transferring memory.

Signature

TypeScript
graftColorIntoAgent(sourceColor: string, targetAgent: WorkerAgent, options?: ConductorGraftOptions): Promise<TopicNode[]>

Parameters

sourceColor (string) — Required input for this operation.
targetAgent (WorkerAgent) — Required input for this operation.
options? (ConductorGraftOptions) — A typed options object. The applicable fields and defaults are documented below.

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.

Example

example.ts
await conductor.graftColorIntoAgent("red", blue, { limit: 4 });