Graphorin API reference v0.15.1

---

Graphorin API reference / @graphorin/memory / / WorkingMemory

Class: WorkingMemory

Defined in: packages/memory/src/tiers/working-memory.ts:105

Stable

WorkingMemory - labeled, character-bounded blocks rendered into every system prompt. Operations:

• define(spec): idempotently registers a block definition; the block's row is created in storage on the next write call so operators can change description between runs without triggering a write.
• read(scope, label) / list(scope): surface the current block contents.
• write(scope, label, value): full replace.
• append(scope, label, content): append-with-newline.
• replace(scope, label, oldUnique, newText): targeted replace with a uniqueness check.
• compile(scope): render the active blocks for the context engine (used by Phase 10d).

Constructors

Constructor

new WorkingMemory(args): WorkingMemory;

Defined in: packages/memory/src/tiers/working-memory.ts:110

Parameters

Parameter	Type
args	{ store: MemoryStoreAdapter; tracer: Tracer; }
args.store	MemoryStoreAdapter
args.tracer	Tracer

Returns

WorkingMemory

Methods

append()

append(
   scope, 
   label, 
content): Promise<Block>;

Defined in: packages/memory/src/tiers/working-memory.ts:167

Append content to a block (with a newline separator).

Parameters

Parameter	Type
scope	SessionScope
label	string
content	string

Returns

Promise<Block>

---

attach()

attach(
   scope, 
   blockId, 
agentId): Promise<void>;

Defined in: packages/memory/src/tiers/working-memory.ts:251

Attach a working block to an additional agent. Backed by the adapter's shared.attach(...) join table so multi-agent crews can share the same block without duplicating storage.

Parameters

Parameter	Type
scope	SessionScope
blockId	string
agentId	string

Returns

Promise<void>

---

compile()

compile(scope, agentId?): Promise<string>;

Defined in: packages/memory/src/tiers/working-memory.ts:294

Render a deterministic <memory_blocks> XML fragment for the supplied scope. The full layered system prompt (six layers) is produced by Phase 10d's ContextEngine; this method ships the minimum-viable rendering used by the smoke acceptance criteria.

The optional agentId argument is reserved for the per-agent filtering Phase 10d wires through. In Phase 10a the argument is accepted but ignored - the rendering is scope-wide.

Parameters

Parameter	Type
scope	SessionScope
agentId?	string

Returns

Promise<string>

---

define()

define(definition): BlockDefinition;

Defined in: packages/memory/src/tiers/working-memory.ts:117

Register a block definition. Returns the same definition object.

Parameters

Parameter	Type
definition	BlockDefinition

Returns

BlockDefinition

---

definitionFor()

definitionFor(label): 
  | BlockDefinition
  | undefined;

Defined in: packages/memory/src/tiers/working-memory.ts:128

Lookup a definition by label.

Parameters

Parameter	Type
label	string

Returns

| BlockDefinition | undefined

---

definitions()

definitions(): readonly BlockDefinition[];

Defined in: packages/memory/src/tiers/working-memory.ts:123

Snapshot of every registered definition.

Returns

readonly BlockDefinition[]

---

detach()

detach(
   scope, 
   blockId, 
agentId): Promise<void>;

Defined in: packages/memory/src/tiers/working-memory.ts:268

Detach a working block from an agent.

Parameters

Parameter	Type
scope	SessionScope
blockId	string
agentId	string

Returns

Promise<void>

---

forget()

forget(
   scope, 
   label, 
reason?): Promise<void>;

Defined in: packages/memory/src/tiers/working-memory.ts:205

Soft-delete a block.

Parameters

Parameter	Type
scope	SessionScope
label	string
reason?	string

Returns

Promise<void>

---

list()

list(scope): Promise<readonly Block[]>;

Defined in: packages/memory/src/tiers/working-memory.ts:133

List active (non-deleted) blocks for the supplied scope.

Parameters

Parameter	Type
scope	SessionScope

Returns

Promise<readonly Block[]>

---

purge()

purge(scope, label): Promise<void>;

Defined in: packages/memory/src/tiers/working-memory.ts:227

Hard-delete a block (GDPR path). Unlike forget (soft tombstone), the stored value is gone. This is the erasure surface for USER-scoped blocks (e.g. the profile projection): the session-delete cascade never reaches rows without a session id, so user-level erasure must call this explicitly. Throws when the storage adapter does not implement the optional WorkingMemoryStoreExt.purge - a silent soft-delete fallback would misreport erasure.

Parameters

Parameter	Type
scope	SessionScope
label	string

Returns

Promise<void>

---

read()

read(scope, label): Promise<string | null>;

Defined in: packages/memory/src/tiers/working-memory.ts:142

Read a single block's value (or null when absent).

Parameters

Parameter	Type
scope	SessionScope
label	string

Returns

Promise<string | null>

---

replace()

replace(
   scope, 
   label, 
   oldUnique, 
newText): Promise<Block>;

Defined in: packages/memory/src/tiers/working-memory.ts:179

Replace the unique substring oldUnique inside the block's value with newText. Throws WorkingBlockReplaceMismatchError when the substring is missing or appears more than once.

Parameters

Parameter	Type
scope	SessionScope
label	string
oldUnique	string
newText	string

Returns

Promise<Block>

---

rethink()

rethink(
   scope, 
   label, 
mutator): Promise<Block>;

Defined in: packages/memory/src/tiers/working-memory.ts:196

Run mutator(current) => next and persist the result.

Parameters

Parameter	Type
scope	SessionScope
label	string
mutator	(current) => string | Promise<string>

Returns

Promise<Block>

---

write()

write(
   scope, 
   label, 
value): Promise<Block>;

Defined in: packages/memory/src/tiers/working-memory.ts:162

Replace a block's value entirely. Honours overflow policy.

Parameters

Parameter	Type
scope	SessionScope
label	string
value	string

Returns

Promise<Block>