Graphorin API reference v0.1.0

---

Graphorin API reference / @graphorin/sessions / facade / SessionManager

Interface: SessionManager

Defined in: packages/sessions/src/facade.ts:250

Surface returned by createSessionManager.

Stable

Properties

Property	Modifier	Type	Description	Defined in
agents	readonly	AgentRegistry	The underlying agent registry.	packages/sessions/src/facade.ts:252
commentary	readonly	CommentarySanitizer	Default sanitizer instance (test seam).	packages/sessions/src/facade.ts:254

Methods

create()

create(args): Promise<Session>;

Defined in: packages/sessions/src/facade.ts:262

Create a fresh session. The optional commentaryPolicy overrides the manager-level default just for this session — useful for deployments that pin a stricter posture per-conversation (e.g. 'strip' for compliance-sensitive sessions while everything else uses the 'wrap' default).

Parameters

Parameter	Type
args	{ agentId: string; commentaryPolicy?: CommentaryPolicy; sessionId?: string; tags?: readonly string[]; title?: string; userId: string; }
args.agentId	string
args.commentaryPolicy?	CommentaryPolicy
args.sessionId?	string
args.tags?	readonly string[]
args.title?	string
args.userId	string

Returns

Promise<Session>

---

find()

find(sessionId): Promise<
  | Session
| null>;

Defined in: packages/sessions/src/facade.ts:273

Best-effort lookup. Returns null when the id is unknown.

Parameters

Parameter	Type
sessionId	string

Returns

Promise< | Session | null>

---

get()

get(sessionId): Promise<Session>;

Defined in: packages/sessions/src/facade.ts:271

Hydrate an existing session by id.

Parameters

Parameter	Type
sessionId	string

Returns

Promise&lt;Session&gt;

---

importFromString()

importFromString(body, opts?): Promise<{
  read: SessionExportReadResult;
  session:   | Session
     | null;
}>;

Defined in: packages/sessions/src/facade.ts:279

Import a JSONL stream into a fresh session.

Parameters

Parameter	Type
body	string
opts?	SessionExportReadOptions

Returns

Promise<{ read: SessionExportReadResult; session: | Session | null; }>

---

listSessions()

listSessions(scope): Promise<readonly SessionMetadata[]>;

Defined in: packages/sessions/src/facade.ts:275

List sessions for a scope (newest-first by createdAt).

Parameters

Parameter	Type
scope	Pick<SessionScope, "userId" | "agentId">

Returns

Promise&lt;readonly SessionMetadata[]&gt;

---

pruneAudit()

pruneAudit(beforeEpochMs): Promise<number>;

Defined in: packages/sessions/src/facade.ts:286

Prune audit rows older than the supplied epoch ms.

Parameters

Parameter	Type
beforeEpochMs	number

Returns

Promise&lt;number&gt;

---

replayer()

replayer(): SessionReplayer;

Defined in: packages/sessions/src/facade.ts:284

Build the underlying replay engine for advanced consumers.

Returns

SessionReplayer