Session Record
@vcjdeboer/session-recordv2026.07.16.1
01README
Never lose how a result was computed. A language-agnostic provenance ledger for interactive data-science sessions: append one immutable, content-checksummed record per executed cell/chunk — its code, value, figures, console output, warnings, packages, and even runtime-declared functions with their internal dependencies — from any client (R/RStudio, Python/Jupyter, targets, …). One append-only ledger, one record per cell, identical shape across languages: the foundation the rest of the session-* suite fills, seals, and replays. Capture the real computation as it happens, so a session can be audited, sealed (session-witness), or re-run later — not reconstructed from memory.
02Models
@vcjdeboer/session-recordv2026.07.16.1session_record.ts
fn record(language: string, clientName: string, clientVersion: string, runtimeName: string, runtimeKind: string, codeLanguage: string, codePath: string, valueSummaryPath: string, consolePath: string, plotPath: string, framePath: string, objectPath: string, inputsManifest: string, functionsManifest: string, readsManifest: string, outputsManifest: string, warningsPath: string, sysmetaPath: string, optionsPath: string, loadedPath: string, installedPath: string, reproStatePath: string, seq: string, session: string, executionCount: string, execTimestamp: string, errorPath: string, errorType: string, status: string)
Record one code execution's input→code→output triple (language-agnostic passive ledger)
| Argument | Type | Description |
|---|---|---|
| language | string | |
| clientName | string | |
| clientVersion | string | |
| runtimeName | string | |
| runtimeKind | string | |
| codeLanguage | string | |
| codePath | string | |
| valueSummaryPath | string | |
| consolePath | string | |
| plotPath | string | |
| framePath | string | |
| objectPath | string | |
| inputsManifest | string | |
| functionsManifest | string | |
| readsManifest | string | |
| outputsManifest | string | |
| warningsPath | string | |
| sysmetaPath | string | |
| optionsPath | string | |
| loadedPath | string | |
| installedPath | string | |
| reproStatePath | string | |
| seq | string | |
| session | string | |
| executionCount | string | |
| execTimestamp | string | |
| errorPath | string | |
| errorType | string | |
| status | string |
fn query(session: string, kind: enum)
Roll up a session across the ledger's versions — counts + all warnings/functions/errors — using swamp's in-process queryData (version enumeration) + readResource (per-version content). No subprocess, no datastore.
| Argument | Type | Description |
|---|---|---|
| session | string | |
| kind | enum |
Resources
execution(infinite)— One recorded code execution (any language): inputs + code + value
query(infinite)— Cross-version session rollup (counts + warnings/functions/errors), built in-process via queryData + readResource
Files
artifact(application/octet-stream)— A value artifact (artifact-<session>-<seq>-<idx>); mediaType per-write
reprostate(application/octet-stream)— RNG-state file (reprostate-<session>-<seq>)
input(application/octet-stream)— Full data of a small input (input-<session>-<seq>-<name>)
readin(application/octet-stream)— Full data of a small file the run READ (readin-<session>-<seq>-<i>-<name>)
fileout(application/octet-stream)— A file the run WROTE (fileout-<session>-<seq>-<i>-<name>)
03Previous Versions
2026.06.29.1
Modified 1 models
2026.06.21.2
2026.06.21.1
04Stats
A
100 / 100
Downloads
1
Archive size
21.9 KB
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned
05Platforms
06Labels