Inno.Assets
Section titled “Inno.Assets”
- Logical asset identities, runtime lookup, residency and retained artifact reads.
Inno.Assets separates an asset’s identity and canonical object from its loaded resources and immutable artifact bytes. Runtime consumers use logical paths or persistent IDs; they do not need an authoring cache’s physical directory.
Start with loading and retaining assets or reading retained artifact bytes. Importing and source mutation belong to Inno.Assets.Pipeline.
Asset ownership contract
Section titled “Asset ownership contract”AssetDatabase borrows its content store. It loads deployed content but does not run importers, create authoring directories or own the store’s final disposal. The host retires asset services before releasing that store.
A lookup returns the current canonical asset. AssetLease<TAsset> expresses explicit residency retention; retaining a managed object reference is not a replacement for the owner’s loading, dependency and release protocol. Residency coordinates preparation, dependency retention, preload budgets, cancellation and retirement. RetentionScope groups retention owned by one caller.
RetirementPendingException preserves an unfinished value and its cleanup callback for the owning lifecycle to advance. A terminal release failure is not permission to invoke the same destructive release repeatedly. Do not discard an owner because its first disposal attempt could not finish.
Runtime budget-eviction retries preserve the same release state; they must not decrement a lease count twice. Asset and artifact leases retain pending values and callbacks, while a retention scope uses the shared Core lifetime protocol.
Missing assets retain persistent identity, stable type identity, neutral property bytes and dependencies. Recovery participates in the shared generation transaction. Values containing references require the owner’s complete serialization context, not an unrelated global serializer. Reference recovery explains how saved intent survives an unavailable generation.
Artifact reading contract
Section titled “Artifact reading contract”AssetArtifactInfo contains a content-addressed key, output name, hash and length; it does not expose a physical location. ArtifactLease.OpenRead() obtains a stream with an independent retention pin. Disposing the outer lease does not invalidate an already opened stream; the caller must still close that stream.
Closing a provider prevents new acquisitions. Missing content and corrupt content are different failures, neither represented by an empty successful payload. ArtifactRetention.GetRetainedKeys() is a snapshot for coordinated collection, not proof that no reader can arrive later. Retention counts do not independently authorize physical cache deletion.
Host and script entry points
Section titled “Host and script entry points”Hosts receive explicit IAssetLookup, IAssetResidency and artifact lookup contracts. The script-facing Assets facade resolves services from the active runtime session and owns no second database. Assets.LocalPath uses the scripting compiler’s canonical caller location so source-local paths follow a project into an installed plugin; an arbitrary host filesystem path is not that identity.
The reference describes the CLR surface. Actual script projections are separately selected; do not assume that every host owner or infrastructure type is exported.
API reference
Section titled “API reference”Asset types and member contracts cover lookup, paths, leases, residency, neutral state and the built-in text/binary asset values.
Logical script references
Section titled “Logical script references”The compiler-selected script declarations are separate from this project’s host CLR surface. Read the script calling guide and the associated module contracts before using a projected member.
Source project facts
Section titled “Source project facts”Project: Inno.Assets
Source: src/content/assets/Inno.Assets/Inno.Assets.csproj
| Type | API | Description |
|---|---|---|
| ArtifactLease | engine | Keeps one verified immutable artifact generation available for an explicit lifetime. |
| ArtifactRetention | engine | Counts explicit leases over immutable artifact keys independently of asset object residency. |
| AssetArtifactInfo | engine | Describes one named output in an immutable artifact bundle. |
| AssetArtifactKey | engine | Identifies one immutable content-addressed artifact bundle. |
| AssetChange | engine | Describes one committed asset database change. |
| AssetChangeKind | engine | Identifies a committed asset database change. |
| AssetChangeSet | engine | Contains one atomically committed asset database revision. |
| AssetDatabase | engine | Loads canonical runtime assets exclusively from a verified catalog and content-addressed artifact bundles. Separates immutable artifact preparation from owner-thread asset materialization. |
| AssetDependency | engine | Describes a persistent direct dependency on another asset. |
| AssetDependencyCollection | engine | Collects direct asset dependencies encountered by a serialization operation. |
| AssetExecutionContext | engine | Binds one host-owned asset lookup to the current asynchronous script execution context. |
| AssetImportStatus | engine | Identifies the current source and import state of an asset. |
| AssetInfo | engine | Provides an immutable public snapshot of one cataloged asset. |
| AssetLease<TAsset> | engine | Keeps one canonical asset generation resident for an explicit lifetime. |
| AssetObject | engine | Provides the common runtime identity and payload contract for imported assets. |
| AssetPath | engine | Addresses one asset without conflating isolated source mounts. |
| AssetPreparationStatistics | engine | Reports owner-thread cold-load admission and unique encoded IO reservations without retaining assets or tasks. |
| AssetPropertySnapshot | engine | Contains native properties and automatically captured asset dependencies without retaining their owner or typed object. |
| AssetReferenceInfo | engine | Provides a stable diagnostic snapshot of references known to the asset pipeline. |
| AssetReferenceKind | engine | Identifies a reference source known to the asset pipeline. |
| AssetReferenceLocation | engine | Describes one engine-known reference location for an asset. |
| AssetReferenceProtocol | engine | Defines the open cross-domain protocol used to resolve persistent asset identities. |
| AssetResidencyProvider | engine | Provides controlled lease construction to concrete asset residency implementations. |
| AssetResidencyStatistics | engine | Reports current explicit runtime asset residency accounting. |
| AssetRuntimeContentInfo | engine | Describes one deployed runtime-only asset content snapshot. |
| AssetRuntimeOwner | engine | Grants one database exclusive mutation authority over the asset instances it initializes. |
| AssetSerializationContext | engine | Creates complete asset-aware converter contexts from an owner-provided reference generation. |
| AssetSourceId | engine | Identifies one isolated asset source mount. |
| AssetSourceKind | engine | Identifies the durable source role recorded by an asset metadata sidecar. |
| Assets | engine | Provides script-facing asset queries through the lookup bound to the current runtime session. |
| BinaryAsset | engine | Describes an imported opaque binary payload. |
| IAssetArtifactLookup | engine | Resolves verified named outputs from immutable asset artifact bundles. |
| IAssetLookup | engine | Defines the read-only asset lookup boundary shared by authoring and deployed runtime databases. |
| IAssetPropertyStateResolver | engine | Restores nested neutral asset properties with the owning database’s converter generation and references. |
| IAssetReferenceResolver | engine | Resolves persistent asset references against one isolated asset database generation. |
| IAssetResidency | engine | Exposes explicit asynchronous asset and artifact residency ownership. |
| RetentionScope | engine | Owns multiple asset, artifact, or subsystem leases as one reverse-order lifetime. |
| TextAsset | engine | Stores decoded text content and its language hint. |
| ArtifactLease | Runtime | Keeps one verified immutable artifact generation available for an explicit lifetime. |
| AssetArtifactInfo | Runtime | Describes one named output in an immutable artifact bundle. |
| AssetArtifactKey | Runtime | Identifies one immutable content-addressed artifact bundle. |
| AssetChange | Runtime | Describes one committed asset database change. |
| AssetChangeKind | Runtime | Identifies a committed asset database change. |
| AssetChangeSet | Runtime | Contains one atomically committed asset database revision. |
| AssetDependency | Runtime | Describes a persistent direct dependency on another asset. |
| AssetImportStatus | Runtime | Identifies the current source and import state of an asset. |
| AssetInfo | Runtime | Provides an immutable public snapshot of one cataloged asset. |
| AssetLease<TAsset> | Runtime | Keeps one canonical asset generation resident for an explicit lifetime. |
| AssetObject | Runtime | Provides the common runtime identity and payload contract for imported assets. |
| AssetPath | Runtime | Addresses one asset without conflating isolated source mounts. |
| AssetPropertySnapshot | Runtime | Contains native properties and automatically captured asset dependencies without retaining their owner or typed object. |
| AssetReferenceInfo | Runtime | Provides a stable diagnostic snapshot of references known to the asset pipeline. |
| AssetReferenceKind | Runtime | Identifies a reference source known to the asset pipeline. |
| AssetReferenceLocation | Runtime | Describes one engine-known reference location for an asset. |
| AssetResidencyStatistics | Runtime | Reports current explicit runtime asset residency accounting. |
| AssetSourceId | Runtime | Identifies one isolated asset source mount. |
| AssetSourceKind | Runtime | Identifies the durable source role recorded by an asset metadata sidecar. |
| Assets | Runtime | Provides script-facing asset queries through the lookup bound to the current runtime session. |
| BinaryAsset | Runtime | Describes an imported opaque binary payload. |
| RetentionScope | Runtime | Owns multiple asset, artifact, or subsystem leases as one reverse-order lifetime. |
| TextAsset | Runtime | Stores decoded text content and its language hint. |