Graphorin API reference v0.1.0
Graphorin API reference / @graphorin/core / / Logger
Interface: Logger
Defined in: packages/core/src/contracts/logger.ts:32
Pluggable logger contract consumed by every @graphorin/* runtime package. The concrete implementation lives in @graphorin/observability — declaring the interface here keeps level-zero packages free of an observability dependency.
Loggers are intentionally structured and side-effect-free in the type contract: the info(msg, fields?) signature is a hint, not a mandate to actually emit anything. Implementations may sample, drop, or batch.
Stable
Methods
child()
child(fields): Logger;Defined in: packages/core/src/contracts/logger.ts:43
Return a child logger with fields merged into every record's structured payload. Useful for binding runId / sessionId / agentId once at the top of a request.
Parameters
| Parameter | Type |
|---|---|
fields | LogFields |
Returns
Logger
debug()
debug(message, fields?): void;Defined in: packages/core/src/contracts/logger.ts:34
Parameters
| Parameter | Type |
|---|---|
message | string |
fields? | Readonly<Record<string, unknown>> |
Returns
void
error()
error(message, fields?): void;Defined in: packages/core/src/contracts/logger.ts:37
Parameters
| Parameter | Type |
|---|---|
message | string |
fields? | Readonly<Record<string, unknown>> |
Returns
void
info()
info(message, fields?): void;Defined in: packages/core/src/contracts/logger.ts:35
Parameters
| Parameter | Type |
|---|---|
message | string |
fields? | Readonly<Record<string, unknown>> |
Returns
void
trace()
trace(message, fields?): void;Defined in: packages/core/src/contracts/logger.ts:33
Parameters
| Parameter | Type |
|---|---|
message | string |
fields? | Readonly<Record<string, unknown>> |
Returns
void
warn()
warn(message, fields?): void;Defined in: packages/core/src/contracts/logger.ts:36
Parameters
| Parameter | Type |
|---|---|
message | string |
fields? | Readonly<Record<string, unknown>> |
Returns
void