automation-template / Observability
Session Documenter
A reusable documentation automation for preserving the full execution story of an agent session without creating a new top-level object in Addyco.
ArtifactsHistoryAutoresearch
Inputs4required context
Outputs3expected products
Secrets1credential gates
Tools3declared access
Targets3install surfaces
Contract
Turns terminal output, Codex threads, and Autoresearch ledgers into durable raw and polished artifacts.
Reusable asRun history and terminal transcript exporter
Runner adaptertool:session-documenter
Artifact contractCreate a raw log artifact plus a Markdown report artifact with sourceKind, format, mimeType, and metadata.
Event contractEmit capture-started, raw-saved, document-generated, and failed events.
Runbook
Read the run, redact sensitive lines, save raw output, generate a Markdown summary, attach artifacts, and append a timeline event.
GuardrailNever include secrets in saved transcripts.
GuardrailSave raw captures separately from polished summaries.
GuardrailAttach every document to a run.
Installations
Project-scoped instances created from this reusable template.
Session Documenter Pilotgemsearch / planned / tool:session-documenter
Inputs
What an installation or run must provide.
Inputrun id
Inputraw terminal output or thread transcript
Inputproject slug
Inputoptional Autoresearch ledger entry
Outputs
What the template should leave behind.
Outputraw log artifact
OutputMarkdown session document
Outputtimeline event
Allowed tools
Capabilities this template can use.
Allowed toolSupabase Storage
Allowed toolMarkdown formatter
Allowed toolAutoresearch ledger reader
Verification
Checks before treating the template as ready.
VerificatioDocument opens in /artifacts/[id].
VerificatioRaw capture remains linked.
VerificatioMetadata includes source kind and related commit or ledger run.