> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archetypeai.app/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Start with /introduction/getting-started. Use the Inference API's Direct Query endpoint (POST /api/inference/query) with the newton-c-2.6 or newton-fusion-1.0 model (text, image, and video reasoning) or the omega-embedding encoder (time-series embeddings). ATAI_API_ENDPOINT is the base URL https://platform.u1.archetypeai.app with no version path; every endpoint path begins with /api. Pages whose descriptions are marked (Archived) document the legacy Lens runtime — do not use them for new projects.

# Packages

> View, run, and delete the packages built from your blueprints, in every project, from the Developer Console.

Requires [version 2.0.1](https://docs.archetypeai.app/release-notes/2.0.x.md#v2-0-1) or later of the Archetype platform.

A package is a blueprint built with its models fixed. To view every package you can access, in
and outside your projects, select **Packages** under **Agents** in the Developer Console
sidebar. The **Packages** page replaces the [Agent Manager](https://docs.archetypeai.app/developer-console/agents/agent-manager),
and links to the Agent Manager open this page.

To build packages, use the [Create Package](https://docs.archetypeai.app/api-reference/agents/packages/create-package.md)
endpoint. To list them through the API, use [List Packages](https://docs.archetypeai.app/api-reference/agents/packages/list-packages.md).

## The Packages List

The columns shown in the list are:

* **Package**: The package's name. Select it to open the package's details in a side panel.
* **Project**: The project the package belongs to, or **No project**. Select the project's name
  to open the project.
* **Blueprint**: The blueprint the package was built from.
* **Status**: The package's build status: **Building**, **Ready**, or **Build failed**.
* **Created**: The date on which the package was built.

Use the blueprint menu to show only the packages built from one blueprint, and the search field
to find packages by name. You can sort the list by **Package** or **Created** by selecting the
column's header, or with the sorting popup button next to the search field.

## Package Details

Selecting a package opens its details in a side panel. The top of the panel shows the package's
status, description, target, creation date, creator, project, and package ID. From the panel, you
can step to the previous or next package in the list, or open the package on its own page.

The panel has two tabs:

* **Overview** lists:
  * **Models**: Each model slot of the blueprint and what it was resolved to when the package
    was built.
  * **Deployments**: The package's deployments, with their kind, status, and creation date.
    Select **View all** to open the **Deployments** tab of the package's
    [project](https://docs.archetypeai.app/developer-console/projects.md).
  * **Latest sessions**: The newest sessions run on the package's deployments, with their
    status, start time, and duration.
* **API** shows the API requests that get the package, list its deployments, deploy it, and
  delete it.

## Running a Package

You can run a package if your role is **Developer** or **Admin**. To run a package, open it and
select ** Run package**. This opens the
**Run package** dialog. Pick one or more input files, then select **Start run**. The run uses
the values from the package's blueprint, and the output file is named for you.

Starting a run creates a batch deployment of the package in the package's project and opens a
session on it. The Developer Console then opens the new deployment in the project.

You can only run a package that is ready, built to run on Archetype Cloud, and in a project.
While a package is still building, the button reads **Building…**, and it unlocks on its own once
the build finishes. A package whose build failed shows **Build failed** instead. A package
outside any project can't be deployed: build it again from a blueprint in a project.

## Deleting a Package

To delete a package, open it on its own page, select the more actions button
() next to **Run package**, and select **Delete package**. Review
the package's name in the confirmation dialog, then select **Delete package** again.

> [!NOTE]
>
> A package that has runs or deployments can't be deleted. Deleting a package doesn't affect
> the blueprint it was built from.

## Related Content

* [Deployments](https://docs.archetypeai.app/developer-console/agents/deployments.md)
* [Sessions](https://docs.archetypeai.app/developer-console/agents/sessions.md)
* [Get Package](https://docs.archetypeai.app/api-reference/agents/packages/get-package.md)
* [Delete Package](https://docs.archetypeai.app/api-reference/agents/packages/delete-package.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.