delete#
Delete a key from the session-scoped key-value store.
Availability#
The KV delete syscall is declared in the guest/host WIT boundary and implemented by the kernel host, but sys_interface does not yet ship a mudu_delete wrapper for in-procedure Rust code. The standalone SDK facade exposes it as:
pub async fn delete(oid: &UniOid, key: &[u8]) -> Result<UniResponse<()>, ApiError>;
Until a wrapper lands, procedure code removes relational rows with command (DELETE statements).
Conceptual signature#
The wire-level signature in uni-syscall.wit:
delete: func(oid: uni-oid, key: list<u8>) -> result<_, uni-error>
Parameters#
oid— the session whose key-value store is modified.key— raw key bytes.
Behavior#
Removes the key from the session’s key-value store. As with
put, the delete is staged in the current session transaction when one is open, and applies directly otherwise.
Return value#
()on success.
Errors#
EntityNotFound: theoiddoes not identify a live session.
Transaction semantics#
Participates in the current session transaction; outside a transaction the host applies the delete directly (autocommit).
Notes#
deleteis the KV counterpart ofget/put/range; it is unrelated to SQLDELETEstatements executed throughcommand.