LedgerAPI
Defined in: namespaces-core-plugins.ts:495
Durable forensic record + approval ledger (fn-94).
No bridge-level scope precheck — access is enforced row-level by the
cross-plugin gate. Anti-enum: read denials degrade to []/null;
markKeepForever on unknown/foreign rows throws sanitized unknownRef.
Calls before plugin activation completes reject LEDGER_NOT_AVAILABLE.
Scopes: ledger.read.own, ledger.read.shared.
fn-94
Methods
Section titled “Methods”query()
Section titled “query()”query(
filter):Promise<{records:ExecutionRecord[];nextScanCursor:AnyJSONValue; }>
Defined in: namespaces-core-plugins.ts:497
Queries ledger records.
Parameters
Section titled “Parameters”filter
Section titled “filter”Returns
Section titled “Returns”Promise<{ records: ExecutionRecord[]; nextScanCursor: AnyJSONValue; }>
get(
recordId):Promise<ExecutionRecord|null>
Defined in: namespaces-core-plugins.ts:499
Gets one record, or null.
Parameters
Section titled “Parameters”recordId
Section titled “recordId”string
Returns
Section titled “Returns”Promise<ExecutionRecord | null>
subscribe()
Section titled “subscribe()”subscribe(
filter,handler):Promise<string>
Defined in: namespaces-core-plugins.ts:501
Subscribes to matching new records. Returns a subscription id.
Parameters
Section titled “Parameters”filter
Section titled “filter”handler
Section titled “handler”(record) => void
Returns
Section titled “Returns”Promise<string>
unsubscribe()
Section titled “unsubscribe()”unsubscribe(
subscriptionId):Promise<void>
Defined in: namespaces-core-plugins.ts:503
Cancels a subscription.
Parameters
Section titled “Parameters”subscriptionId
Section titled “subscriptionId”string
Returns
Section titled “Returns”Promise<void>
markKeepForever()
Section titled “markKeepForever()”markKeepForever(
recordId):Promise<void>
Defined in: namespaces-core-plugins.ts:505
One-way pin: sets keepForever (nil → true; never reversible).
Parameters
Section titled “Parameters”recordId
Section titled “recordId”string
Returns
Section titled “Returns”Promise<void>