Ticketmaster connector skill for Muse

# Ticketmaster connector skill (Muse)

A Muse workspace skill for searching the Ticketmaster Discovery API
(events, attractions, venues). Authentication uses an API key stored in the
assistant's Secure Vault — the key never appears in this repo, in chat, or
in logs.

## Layout

- `SKILL.md` — skill definition: purpose, tooling, auth model, operating rules
- `bin/tm_api.py` — Discovery API client (`RESOURCE [--param key=value ...]`)
- `bin/dynamic_credentials.py` — vendored helper that exchanges the stored
  credential for a request surrogate (`hsurr:*`) at call time

## Auth model

The CLI never reads a raw secret. It appends a surrogate token as the
`apikey` query parameter; the runtime swaps it for the real key on approved
egress to `app.ticketmaster.com` only. If the bundled helper exists at
`/opt/hatch/skills/skill-creator/bin/dynamic_credentials.py` it is used,
otherwise the vendored copy in `bin/` is used.

## Usage

```sh
# Events by keyword and city
bin/tm_api.py events.json --param keyword=Coldplay --param city="San Jose" --param size=5

# Attractions
bin/tm_api.py attractions.json --param keyword=Eagles --param countryCode=US

# Venues
bin/tm_api.py venues.json --param keyword=Chase --param stateCode=CA

# Single event by id
bin/tm_api.py events/k7vGFKzL1d8Gd.json
```

Base URL: `https://app.ticketmaster.com/discovery/v2/`. Get a key from the
[Ticketmaster developer portal](https://developer.ticketmaster.com/) — the
default app's Consumer Key is the API key.

Note: the Discovery API is search-only; it cannot buy tickets or read your
orders.