Skip to documentation
Docs navigation
Docs/enqueueTextIngest()
MemoGrafter

enqueueTextIngest()

Submit raw-text ingestion to the queue.

What it does

Submit raw-text ingestion to the queue.

When to use it

Use for large or latency-insensitive text when a configured worker should perform extraction.

Signature

TypeScript
enqueueTextIngest(text: string, sessionId: string, options?: IngestTextOptions & IngestOptions): Promise<void>

Parameters

text (string) — Raw text to analyze and convert into memories.
sessionId (string) — The application-owned session whose memory should be read or changed.
options? (IngestTextOptions & IngestOptions) — A typed options object. The applicable fields and defaults are documented below.

IngestOptions fields

tags? (string[]) — Normalized metadata copied to topics and memories created by this ingestion.

IngestTextOptions fields

replace? (boolean, default false) — Clear the target session graph before processing this text.
label? (string) — Supply a document/topic label instead of relying only on extraction.
source? (string) — Preserve an application-defined provenance label.

Result

The requested identifier or text value.

Behavior

Resolves after queue acceptance. Without a queue, it processes the text inline.

Side effects and completion

New graph nodes may not be readable when the queued promise resolves.

Example

example.ts
await memo.enqueueTextIngest(documentText, "project-a");