OptionalmodelOverride: PromptModelConfigReadonlyrunnerStable, human-readable name for the runner. Must be set explicitly on each subclass so we don't break the logger and trace span names when minified.
ProtectedloggerProtectedexecutePrimary entry point for the runner. Subclass must implement this method to provide the
runner's logic. The optional ctx carries cross-cutting concerns (cancellation via
ctx.signal, request/user identity); simple runners may ignore it.
Optionalctx: RunnerContextProtectedrecordAdd a component's token usage to this run's total, surfaced as RunnerRun.usage. Call it for
every agent / prompt the runner invokes; anything not recorded is invisible to cost reporting.
Optionalctx: RunnerContextProtectedtraceOptional hook for subclasses to record the root LangSmith span's INPUTS — what was asked, rather than the metadata facets you filter runs by.
Returns {} by default, which is what every runner recorded before this hook existed: a root
span you had to open a child span to understand. Unlike traceMetadata this is the place free
text legitimately belongs, so only override it on surfaces where the payload is acceptable in
the trace, and keep it to what a human reading the run needs.
ProtectedtraceOptional hook for subclasses to attach non-PII metadata to the root LangSmith span.
Merged on top of the auto-extracted metadata and ctx.metadata
Safe by default: returns {} when not overridden.
Never include emails, names, dob, free-text, etc.
Classifies one chart: a single structured call, no persistence and no chart loading.
Thin on purpose. What it adds over calling the prompt directly is everything
BaseRunner.run()wraps aroundexecute()— the root trace, theSafeenvelope so one unclassifiable chart cannot throw out of a bulk loop, structured logging, andentity_id/patient_idspan tagging fromRunnerContext. Those are the properties that matter once this runs over the whole corpus.Token usage is not recorded:
BasePrompt.invoke()returns only its output, soRunnerRun.usagestays zeroed here as it does for every other prompt-only path in this package. Per-call cost during the pilot comes from the LangSmith trace.