Telemetry settings

Everything OmniCoreAgent(telemetry_config={...}) takes: what a trace records, where it is kept, and for how long. Each description is the comment above the setting in the code.

Setting	Type	Default	What it does
`storage`	`str`	`"auto"`	`auto` (like `jsonl`) keeps every trace on local disk, in telemetry/traces.jsonl under the workspace directory (./workspace unless configured), even when the workspace itself is S3 or R2. `memory` keeps them in this process only. No external exporter is required.
`storage_path`	`str \| None`	`None`	Where the jsonl store writes; None is telemetry/traces.jsonl in the workspace.
`retention_days`	`int \| None`	`7`	Finished traces older than this are pruned automatically; `None` keeps every trace.
`payload_retention_days`	`int \| None`	`7`	The same for offloaded payloads, on their own window; a payload a kept trace still refers to is never pruned.
`memory_max_traces`	`int \| None`	`1000`	Upper bound on finished traces kept by an in-memory store.
`capture`	`str`	`"full"`	A preset fills every `record_*` field left unset (`None`); a field set explicitly always wins. After construction all are booleans. `full` is the default (the maintainer’s decision, 2026-09-22): a trace is worth keeping only if it holds what the model was sent, and a trainer or an evaluator cannot use one that does not. `default` is the privacy-first preset for a deployment that must not record prompts.
`record_inputs`	`bool \| None`	`None`	What a trace keeps of each part of a run: inputs, outputs, what the model was sent and what it answered, and what tools returned. None takes the capture preset’s value.
`record_outputs`	`bool \| None`	`None`	What a trace keeps of each part of a run: inputs, outputs, what the model was sent and what it answered, and what tools returned. None takes the capture preset’s value.
`record_model_prompts`	`bool \| None`	`None`	What a trace keeps of each part of a run: inputs, outputs, what the model was sent and what it answered, and what tools returned. None takes the capture preset’s value.
`record_model_responses`	`bool \| None`	`None`	What a trace keeps of each part of a run: inputs, outputs, what the model was sent and what it answered, and what tools returned. None takes the capture preset’s value.
`record_tool_results`	`bool \| None`	`None`	What a trace keeps of each part of a run: inputs, outputs, what the model was sent and what it answered, and what tools returned. None takes the capture preset’s value.
`record_token_details`	`bool`	`False`	The tokens a model chose and their probabilities, when the provider returns them (`logprobs`). Off: they are large, and only a trainer reusing the run needs them.
`max_payload_bytes`	`int`	`64_000`	A recorded payload larger than this is replaced by a truncated marker with its size and checksum, unless offload_large_payloads keeps it whole.
`redact_keys`	`list[str]`	see below	Keys whose values are replaced with [REDACTED] wherever they appear in a recorded payload, at any depth.
`offload_large_payloads`	`bool`	`False`	Keep payloads over max_payload_bytes whole, in the workspace or object storage, referenced from the trace, instead of truncating them.
`offload_target`	`str`	`"workspace"`	Keep payloads over max_payload_bytes whole, in the workspace or object storage, referenced from the trace, instead of truncating them.
`archive_index_url`	`str \| None`	`None`	Where the archive of finished traces keeps its index and its bodies. Unset is a SQLite file and a directory beside the log, which is what one process needs. A database URL makes the index shared, and `archive_target="object_storage"` puts the bodies in the deployment’s bucket, so several server processes can read one archive.
`archive_target`	`str`	`"local"`	Where the archive of finished traces keeps its index and its bodies. Unset is a SQLite file and a directory beside the log, which is what one process needs. A database URL makes the index shared, and `archive_target="object_storage"` puts the bodies in the deployment’s bucket, so several server processes can read one archive.
`archive_bodies_path`	`str \| None`	`None`	A directory the processes share, for a deployment that shares one host rather than a bucket. Ignored when `archive_target` is object storage.
`strict`	`bool`	`False`	Raise when a record cannot be made safely (redaction or persistence failed) instead of recording a marker and carrying on.
`persistence_timeout_seconds`	`float \| None`	`5.0`	Seconds a write to the trace store, or an export to an external exporter, may take before it is given up and reported.
`export_timeout_seconds`	`float \| None`	`5.0`	Seconds a write to the trace store, or an export to an external exporter, may take before it is given up and reported.

Defaults in full

`redact_keys`

Keys whose values are replaced with [REDACTED] wherever they appear in a recorded payload, at any depth.

[
  "access_token",
  "api_key",
  "apikey",
  "authorization",
  "client_secret",
  "cookie",
  "password",
  "refresh_token",
  "secret",
  "set-cookie",
  "token"
]