Metadata-Version: 2.4
Name: bazaar-contrib-manager
Version: 0.3.0rc33
Summary: The Bazaar Compute Node Manager Contrib
License-Expression: Apache-2.0
License-File: LICENSE
Requires-Dist: bazaar-contrib-config~=0.3.0rc1
Requires-Dist: bazaar-contrib-invoke~=0.3.0rc1
Requires-Dist: bazaar-contrib-sidecar~=0.3.0rc1
Requires-Dist: bazaar-contrib-timer~=0.3.0rc7
Requires-Dist: filelock>=3.16.0
Requires-Dist: jinja2>=3.1.6
Requires-Dist: packaging>=25.0
Requires-Dist: tomli-w>=1.2.0
Requires-Python: >=3.15
Project-URL: Repository, https://github.com/yuchanns/bazaar-compute-node
Description-Content-Type: text/markdown

# bazaar-contrib-manager

Install and manage contrib packages with `bcn contrib`.

```sh
bcn contrib add manager --enable
bcn contrib list
bcn contrib configured
bcn contrib --help
```

The corresponding entry in `config.toml`:

```toml
version = "5"

[[contribs]]
package = "bazaar-contrib-manager==0.3.*"
[[contribs.enabled]]
entry = "contrib-manager"
[[contribs.enabled]]
entry = "contrib-indexes"
```

## Index entries

Each local file, HTTP(S) index or `resource://` index uses the same document:

```json
{
  "contribs": [
    {
      "package": "bazaar-contrib-telegram",
      "source": "https://pypi.org/simple/",
      "summary": "Connect agents to Telegram",
      "description": "A Telegram channel for Bazaar Compute Node agents.",
      "icon_url": "https://example.org/icons/telegram.svg"
    }
  ]
}
```

`package` and `source` are required. `summary` (short text), `description`
(Markdown) and `icon_url` (image URL) are optional display fields maintained by
the index author. Omitted fields are `None` and their corresponding UI regions
are omitted.

Entries with the same package and source share one catalog entry. The last entry
in configured index order supplies its display fields, including omissions;
the catalog retains all index locations. Different sources remain separate
choices. Display fields are preserved in the index cache and catalog results.

Use `bcn contrib index add <location>` to append an index and
`bcn contrib index refresh` to refresh online indexes.

## Remote catalog and management

Sidecar exposes `contrib-catalog.indexes`, `entries` and `refresh`, and
`contrib-manager.add`, `operation`, `installed`, `detail` and `index`.
The server market calls these through its selected computer. Local paths and
resource indexes resolve in that computer's environment; index changes and
operation records use its configuration and storage.
