asset name and id

This commit is contained in:
Nilton Constantino
2026-01-22 14:46:23 +00:00
parent 8d97f6225b
commit 81f7813c7c
5 changed files with 88 additions and 57 deletions
+7 -5
View File
@@ -44,7 +44,8 @@ It describes **content**, not residency.
### Required Fields (conceptual)
* `asset_id` (string or hash)
* `asset_id` (integer, internal identifier)
* `asset_name` (string, user-facing identifier)
* `asset_type` (TILEBANK, SOUNDBANK, BLOB, TILEMAP, ...)
* `bank_kind` (mandatory, single)
* `offset` (byte offset in cartridge)
@@ -139,12 +140,12 @@ Conceptually, each Bank is a **specialized allocator**.
### Conceptual API
```text
handle = asset.load(asset_id, slotRef, flags)
handle = asset.load(asset_name, slotRef, flags)
```
Load flow:
1. Resolve `asset_id` via Asset Table
1. Resolve `asset_name` via Asset Table to get its `asset_id`
2. Read `bank_kind` from asset entry
3. Validate compatibility with `slotRef`
4. Enqueue load request
@@ -264,6 +265,7 @@ Each Bank must expose:
* inflight memory
* occupied slots
* `asset_id` per slot
* `asset_name` per slot
* generation per slot
This enables debuggers to visualize:
@@ -279,7 +281,7 @@ This enables debuggers to visualize:
The following syscalls form the minimal hardware contract for asset management:
```text
asset.load(asset_id, slotRef, flags) -> handle
asset.load(asset_name, slotRef, flags) -> handle
asset.status(handle) -> LoadStatus
asset.commit(handle)
asset.cancel(handle)
@@ -292,7 +294,7 @@ Where:
* `LoadStatus` ∈ { PENDING, LOADING, READY, COMMITTED, CANCELED, ERROR }
* `BankStats` exposes memory usage and limits
* `SlotStats` exposes current asset_id and generation
* `SlotStats` exposes current asset_id, asset_name and generation
---