Arcane.applications.list()

This focused page is derived from the mechanically checked full member inventory.

Syntax

Arcane.applications.list()

Parameters

None

Return value

Promise<{verified, securityMode, publisherTrustSource, revocationStatus, applications}>

Description

Returns the verified installed-application catalog wrapper visible to Shell or Terminal; it is not a bare array. The RPC authority name is apps.list.

Overview

Arcane.applications.list() reads the installed, launchable application catalog. It is available only to the bound shell or terminal application with the applications.read grant on Core or Android. It performs a verified catalog read and emits no event.

The result is a catalog wrapper, not a bare array. At most 256 unique applications are returned, ordered by ascending order, then by display name and id on Core. Android validates its generated order before returning it.

Result

const catalog = {
    verified: true,
    securityMode: 'unsigned-local-test',
    publisherTrustSource: null,
    revocationStatus: null,
    applications: [
        {
            id: 'files',
            displayName: 'Files',
            description: 'Browse app-owned files.',
            iconUrl: '/apps/files/icon.png',
            version: '1.0.0',
            order: 10,
            verified: true
        }
    ]
};

Each record has exactly id, displayName, description, iconUrl, version, order, and verified. Nullable metadata is returned as null. Every record's verified value equals the wrapper value. Publisher-verified Core catalogs include bounded trust source and revocation evidence; unsigned-development catalogs use null evidence. A non-debug Android package can report verified: false, securityMode: "unverified", and null evidence; do not turn that development fact into a trust claim.

Errors and recovery

METHOD_NOT_ALLOWED or ANDROID_CAPABILITY_DENIED means the app identity or grant is not admitted. Catalog or package failures use APPLICATION_ADAPTER_UNAVAILABLE, APPLICATION_CATALOG_UNAVAILABLE, APPLICATION_CATALOG_UNVERIFIED, or APPLICATION_CATALOG_INVALID. Treat those as installation-integrity failures and offer repair; do not display or launch a partially accepted catalog.

Example

const catalog = await Arcane.applications.list();

if (!catalog.verified) {
    console.warn('The host did not verify this development catalog.');
}

for (const application of catalog.applications) {
    console.log(application.id, application.displayName, application.version);
}

Reference group

Applications, terminal, and capabilities