FileAgentTelemetrySink class final
Appends one fa.log line per telemetry record. Never throws — a broken log path degrades to silence exactly like the CLI's own diagnostic writer.
- Implemented types
Constructors
- FileAgentTelemetrySink(String path, {String tag = '-'})
-
Creates a sink appending to
path(the CLI's is~/.fah/logs/fa.log).tagis the correlation id rendered assid=<tag>on every line — the CLI's own lines always name their session for shared-log post-mortems;-(the CLI's no-session marker) when the host has none.
Properties
- hashCode → int
-
The hash code for this object.
no setterinherited
- path → String
-
The log file path.
final
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- tag → String
-
The correlation id rendered as
sid=<tag>(the CLI's_logSidconvention;-when the host runs session-less).final
Methods
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
record(
AgentTelemetryEvent event) → void -
Records one lifecycle event.
override
-
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited
Static Methods
-
forHomeDir(
String? homeDir, {String tag = '-'}) → FileAgentTelemetrySink? -
The canonical fa.log sink for
homeDir, or null when the host has no home dir (web build, sandbox) — mirror of the CLI's own null path stance.