Interface OfflineRegionDiagnosticV1

Secret-safe, payload-free explanation of one persistent offline region.

interface OfflineRegionDiagnosticV1 {
    admission: OfflineRegionDiagnosticAdmission;
    cache: {
        ageMs: number;
        completeness: "complete" | "partial" | "missing";
        expectedLogicalBytes: number;
        expiresAt?: string;
        freshness: "stale" | "expired" | "fresh";
        lastAccessedAt?: string;
        observedAt: string;
        pinned: boolean;
        readable: boolean;
        reason:
            | "stale-entry"
            | "cache-miss"
            | "offline-entry"
            | "expired-entry"
            | "partial-entry";
        staleAfterMs: number;
        state: "offline" | "missing";
        storedLogicalBytes?: number;
    };
    contents: {
        attributionIds: readonly string[];
        logicalBytes: number;
        resourceCount: number;
        resourceKinds: Readonly<Record<OfflineRegionResourceKind, number>>;
    };
    generatedAt: string;
    inventoryRevision: string;
    kind: "honua.offline-region-diagnostic";
    provenance: {
        authorizationScopeDigest: `sha256:${string}`;
        endpointFingerprint: `sha256:${string}`;
        observation: OfflineRegionObservation;
        planVersion: string;
        schemaVersion: string;
        sourceId: string;
        sourceVersion: string;
        validator?: {
            etagFingerprint?: `sha256:${string}`;
            lastModified?: string;
        };
    };
    regionId: string;
    storage?: OfflineStorageBudgetV1;
    version: "1.0";
}

Properties

admission cache contents generatedAt inventoryRevision kind provenance regionId storage? version

Properties

Readonlyadmission

admission: OfflineRegionDiagnosticAdmission

Readonlycache

cache: {
    ageMs: number;
    completeness: "complete" | "partial" | "missing";
    expectedLogicalBytes: number;
    expiresAt?: string;
    freshness: "stale" | "expired" | "fresh";
    lastAccessedAt?: string;
    observedAt: string;
    pinned: boolean;
    readable: boolean;
    reason:
        | "stale-entry"
        | "cache-miss"
        | "offline-entry"
        | "expired-entry"
        | "partial-entry";
    staleAfterMs: number;
    state: "offline" | "missing";
    storedLogicalBytes?: number;
}

Readonlycontents

contents: {
    attributionIds: readonly string[];
    logicalBytes: number;
    resourceCount: number;
    resourceKinds: Readonly<Record<OfflineRegionResourceKind, number>>;
}

ReadonlygeneratedAt

generatedAt: string

ReadonlyinventoryRevision

inventoryRevision: string

Readonlykind

kind

Readonlyprovenance

provenance: {
    authorizationScopeDigest: `sha256:${string}`;
    endpointFingerprint: `sha256:${string}`;
    observation: OfflineRegionObservation;
    planVersion: string;
    schemaVersion: string;
    sourceId: string;
    sourceVersion: string;
    validator?: {
        etagFingerprint?: `sha256:${string}`;
        lastModified?: string;
    };
}

ReadonlyregionId

regionId: string

Optional Readonlystorage

storage?: OfflineStorageBudgetV1

Present only when the caller supplied a storage-budget observation.

Readonlyversion

version

Settings

Member Visibility

On This Page

Properties