@archastro/sdk
    Preparing search index...

    Interface SolutionSummary

    A catalog entry for an imported Solution, including its display metadata, bundled templates, owner scopes, and any available upgrade information.

    interface SolutionSummary {
        category_keys?: string[];
        created_at?: string;
        description?: string;
        id: string;
        kind: string;
        latest_solution?: string;
        latest_version?: string;
        lookup_key?: string;
        metadata?: Record<string, unknown>;
        name?: string;
        org?: string;
        org_logo?: ImageSource;
        org_name?: string;
        org_slug?: string;
        owners: string[];
        readme_url?: string;
        solution_id?: string;
        solution_version?: string;
        tag_keys?: string[];
        template_kind?: string;
        templates: SolutionTemplateSummary[];
        updated_at?: string;
        upgrade_available: boolean;
        virtual_path?: string;
    }
    Index

    Properties

    category_keys?: string[]

    Category tag keys declared in the Solution body, used to group Solutions in the catalog. An empty array when the body declares none.

    created_at?: string

    When the Solution config was first imported (ISO 8601).

    description?: string

    Short tagline or summary declared in the Solution body, used as the card subhead in catalog UIs. null when the Solution body does not set one.

    id: string

    Solution config ID (cfg_...).

    kind: string

    Resource type. Always "Solution".

    latest_solution?: string

    When upgrade_available is true, the system-scope Solution config ID (cfg_...) that should be used as the upgrade source. null otherwise.

    latest_version?: string

    When upgrade_available is true, the higher system-scope solution_version available to upgrade to. null otherwise.

    lookup_key?: string

    The lookup key stored on the Solution config, if one was assigned during import. null when no lookup key was set.

    metadata?: Record<string, unknown>

    Arbitrary key-value metadata declared in the Solution body (e.g. category or display hints). Present as an empty object when the body declares none.

    name?: string

    Human-facing display name declared in the Solution body. null when the Solution body does not set one.

    org?: string

    Organization ID (org_...) that owns this Solution config, when the Solution is scoped to a specific org. null for system-scope (app-level) Solutions.

    org_logo?: ImageSource

    Canonical image-source object for the resolved org's logo, used as the principal category section glyph. Carries the signed url plus a refresh_url. null when org_slug is null or the org has no logo.

    org_name?: string

    Display name of the resolved org. Pairs with org_slug as the principal catalog category's label. null when org_slug is null.

    org_slug?: string

    Resolved slug of the Solution body's org (the publishing organization), when set and it resolves to a real org visible to the viewer. When present this is the Solution's principal catalog category key — clients group the Solution under this org ahead of category_keys. null when the body has no org or it doesn't resolve.

    owners: string[]

    Owner scopes this Solution appears under. Members: "system" (app-level system scope) and/or "org" (viewer's org scope).

    readme_url?: string

    Relative path to the public README endpoint with a signed token already embedded. null when the Solution has no README. Token expires in 1 hour — refresh via GET /api/v1/solutions/:solution.

    solution_id?: string

    Stable UUID declared in the Solution body, used to identify the same logical Solution across multiple installed copies and owner scopes. null when the body omits it.

    solution_version?: string

    Semver string declared in the Solution body (e.g. "1.2.0"). null when the body does not declare a version.

    tag_keys?: string[]

    Freeform tag keys declared in the Solution body. An empty array when the body declares none.

    template_kind?: string

    Wrapped template kind — "AgentTemplate", "AutomationTemplate", "AgentRoutineTemplate", "AgentToolTemplate", "AgentComputerTemplate", or "SolutionTemplateRef" for ref-mode bundles.

    Template configs bundled by this Solution, in declaration order — the first entry is the deployable template the Solution wraps; the rest are sibling templates the wrapped template references.

    updated_at?: string

    When the Solution config was last modified (ISO 8601).

    upgrade_available: boolean

    true when this Solution is installed at the viewer's org scope and the app-level system scope carries a higher solution_version. Always false for system-only rows.

    virtual_path?: string

    The stable virtual path assigned to this Solution config, used as the deduplication key when the same Solution appears under multiple owner scopes. null when unset.