dynamitecircle 2.0.4__tar.gz → 2.3.1__tar.gz

{dynamitecircle-2.0.4 → dynamitecircle-2.3.1}/.gitignore

@@ -13,10 +13,14 @@ __pycache__/
 .venv*
 *.egg-info/
 dist/
+
+# MCPB bundle — built in CI (publish.yml) + attached to releases; never commit
+*.mcpb
 build/
 
 # Node (in case any tool ships a sub-app)
 node_modules/
+.npm-cache/
 
 # OS
 .DS_Store

{dynamitecircle-2.0.4 → dynamitecircle-2.3.1}/CHANGELOG.md

@@ -3,9 +3,10 @@
 All notable changes to the **`dc` client repo** (formerly `dc-official` /
 `dc-py`) are listed here. The version
 numbers below track `DC_API_VERSION` in [`py/dc.py`](py/dc.py), which is
-deliberately aligned with the DC Member API server version it was last
-verified against. Patch bumps from the server are silent; minor or major
-bumps surface a one-shot stderr warning when this client falls behind.
+deliberately aligned with the DC Member API contract version it was last
+verified against. Python, TypeScript, and the API contract are released
+together on purpose. Patch bumps from the API are silent; minor or major bumps
+surface a one-shot stderr warning when an installed client falls behind.
 
 The format is loosely based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and the project follows [Semantic Versioning](https://semver.org/) for
@@ -14,8 +15,238 @@ the public Python API surface (`dc.DC`, `dc.DCError`, `dc.Result`,
 
 ---
 
+## [v2.3.1] - 2026-07-14
+
+### Added
+- **`virtual-event-attendees`** — list the attendees (RSVP `yes`/`maybe`) of a Live Call: `dc virtual-event-attendees <sessionID> [--limit N] [--cursor TOKEN]`. Mirrors `event-attendees` — same paginated envelope, surfaces the true `total` (under `extra`) + `cursor`. TS: `client.virtualEvents.attendees(sessionID, { limit, cursor })`.
+
+### Changed
+- Realigned `DC_API_VERSION` to the deployed Member API contract **2.3.1**. The server added the Live Call attendees endpoint plus cursor pagination and a true aggregate `total` on `GET /events/:eventID/attendees`; the pinned OpenAPI snapshot + operation-map were updated to match (no other client command changes since 2.0.4).
+
+## [v2.0.4] - 2026-06-16
+
+### Added
+
+- list in the Official MCP Registry (b2f1d26)
+- one-click install badges, VS Code docs, and .mcpb bundle (6108d51)
+- MCP tool annotations and structured output (9b62eb0)
+- snake_case MCP tool names and fields (f4573f8)
+
+
+## [v2.0.1] - 2026-06-16
+
+### Added
+
+- v2.0.1 — formal field names (breaking) to match Member API rename (2bb90f2)
+
+
+## [v1.23.3] - 2026-06-13
+
+### Fixed
+
+- dc.py help — sponsors/attendee-agenda/agendas are public (not ticket-gated) (9181cc8)
+
+
+## [v1.22.6] - 2026-06-05
+
+### Fixed
+
+- explicit profile-update/calendar parsers + offline test suite (aecaca1)
+- accept top-level --note on trip-create and trip-update (26a9c61)
+
+
+## [v1.22.5] - 2026-06-03
+
+### Fixed
+
+- accept declared args= flags on parser-less commands (MCP bridge) (267fad2)
+
+
+## [v1.22.4] - 2026-05-27
+
+### Fixed
+
+- align client with api 1.22.4 (3fe5f91)
+
+
+## [v1.22.3] - 2026-05-24
+
+### Added
+
+- 6 follow commands + Follows SKILL.md section (no version bump — pending server deploy) (5f19db6)
+
+
+## [v1.20.1] - 2026-05-22
+
+_No customer-facing changes in this release._
+
+
+## [v1.19.3] - 2026-05-21
+
+_No customer-facing changes in this release._
+
+
+## [v1.19.2] - 2026-05-21
+
+_No customer-facing changes in this release._
+
+
+## [v1.17.3] - 2026-05-20
+
+_No customer-facing changes in this release._
+
+
+## [v1.17.2] - 2026-05-20
+
+_No customer-facing changes in this release._
+
+
+## [v1.17.1] - 2026-05-20
+
+_No customer-facing changes in this release._
+
+
+## [v1.17.0] - 2026-05-20
+
+_No customer-facing changes in this release._
+
+
+## [v1.16.2] - 2026-05-20
+
+_No customer-facing changes in this release._
+
+
+## [v1.14.1] - 2026-05-19
+
+### Added
+
+- dc-py rooms — path-segment URLs + trim type enum (be09d76)
+- dc 1.14.0 — room + room-messages; rooms enum adds direct/group (a7b8ea9)
+
+
+## [v1.13.1] - 2026-05-19
+
+### Fixed
+
+- stabilize MCP stdio transport (21c8022)
+
+
+## [v1.12.5] - 2026-05-14
+
+_No customer-facing changes in this release._
+
+
+## [v1.12.1] - 2026-05-08
+
+_No customer-facing changes in this release._
+
+
+## [v1.11.1] - 2026-05-07
+
+_No customer-facing changes in this release._
+
+
+## [v1.10.5] - 2026-05-07
+
+_No customer-facing changes in this release._
+
+
+## [v1.10.4] - 2026-05-04
+
+_No customer-facing changes in this release._
+
+
+## [v1.10.2] - 2026-05-04
+
+_No customer-facing changes in this release._
+
+
+## [v1.9.1] - 2026-05-04
+
+_No customer-facing changes in this release._
+
+
+## [v1.8.1] - 2026-05-04
+
+_No customer-facing changes in this release._
+
+
+## [v1.7.1] - 2026-05-03
+
+_No customer-facing changes in this release._
+
+
+## [v1.6.3] - 2026-05-02
+
+### Fixed
+
+- rewrite CLI smoke step + bump to 1.6.3 (b098dfe)
+
+
+## [v1.6.2] - 2026-05-02
+
+### Added
+
+- PyPI packaging (`dynamitecircle`) + publish workflow (77aefa4)
+- add Gemini CLI pre-approval (.gemini/settings.json) (fd09acb)
+- pre-approve dc MCP server + skill + CLI for Claude Code & Codex (4d234ec)
+- flip canonical paths to /dc/ and /docs/, rename dc_skill.py → dc.py (42aa541)
+
+### Changed
+
+- monorepo restructure — repo renamed to dc, Python client moved to /py/ (80d7166)
+- SKILL_VERSION → DC_API_VERSION; deduplicate Quick start sections in README (a1e99c6)
+- User-Agent → 'dc-py/<version>' (e1b5a6a)
+- rename Skill base class → Runtime; SkillError → DCError; SkillResult → Result (06a2c44)
+- rename public class DCSkill → DC, rename doc files (bc9d04f)
+
+### Fixed
+
+- use only-include + bypass-selection so sdist ships py/ (c42abed)
+
+
+## [v1.6.1] - 2026-05-02
+
+### Added
+
+- add manifest.json + LICENSE; bump to 1.6.1 (8e949d6)
+- add dc/ symlink shortcut + drop hardcoded command counts (96bc6a3)
+
+
+## [v1.6.0] - 2026-04-30
+
+_No customer-facing changes in this release._
+
+
+## [v1.5.0] - 2026-04-30
+
+### Added
+
+- add announcements + event-extras commands (10 new) (f4f901f)
+
+
+## [v1.3.0] - 2026-04-30
+
+### Added
+
+- add 429 retry handling and `limits` command (02bf994)
+
+
+## [v1.0.0] - 2026-04-30
+
+_No customer-facing changes in this release._
+
+
 ## [Unreleased]
 
+### Added
+
+- TypeScript npm library scaffold under `ts/`, published as
+  `@dynamitecircle/dc`, with a hand-written SDK surface for every pinned
+  Member API operation. It is a library only: no CLI and no MCP server.
+- Pinned OpenAPI contract under `contracts/` plus an explicit operation map
+  that validates API operation → Python command → TypeScript method parity.
+
 ## [2.0.4] – 2026-06-16
 
 ### Added
@@ -277,7 +508,7 @@ cutover — were server-only with no client surface change, so no client release
 
   No client-side change required — the `hint` field on 404 payloads
   is already surfaced by `DCError`. Bump kept in lockstep with the
-  deployed server version per the triple-lock rule.
+  deployed API contract version per the triple-lock rule.
 
 ---
 
@@ -1121,7 +1352,8 @@ Tag exists but no PyPI release. Replaced by 1.6.3.
 
 ---
 
-[Unreleased]: https://github.com/dynamitecircle/dc/compare/v2.0.4...HEAD
+[Unreleased]: https://github.com/dynamitecircle/dc/compare/v2.3.1...HEAD
+[2.3.1]: https://github.com/dynamitecircle/dc/compare/v2.0.4...v2.3.1
 [2.0.4]: https://github.com/dynamitecircle/dc/compare/v2.0.1...v2.0.4
 [2.0.1]: https://github.com/dynamitecircle/dc/releases/tag/v2.0.1
 [1.23.3]: https://github.com/dynamitecircle/dc/releases/tag/v1.23.3

{dynamitecircle-2.0.4 → dynamitecircle-2.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dynamitecircle
-Version: 2.0.4
+Version: 2.3.1
 Summary: Official Python client for the public Dynamite Circle Member API. CLI, library, Agent Skill, and MCP server in one file.
 Project-URL: Homepage, https://github.com/dynamitecircle/dc
 Project-URL: Repository, https://github.com/dynamitecircle/dc
@@ -51,14 +51,18 @@ Provides-Extra: test
 Requires-Dist: pytest>=7.0; extra == 'test'
 Description-Content-Type: text/markdown
 
-# DC Official Client
+# DC Official Clients
 
-The official Python client for the [Dynamite Circle Member API](https://www.dynamitecircle.com/developers/) — your own profile, trips, events, virtual events, tickets, invites, inbox, rooms, chapters, places lookup, and the weekly locator digest.
+Official clients for the [Dynamite Circle Member API](https://www.dynamitecircle.com/developers/) — your own profile, trips, events, virtual events, tickets, invites, inbox, rooms, chapters, places lookup, and the weekly locator digest.
 
-A single self-contained file. Zero dependencies (stdlib only). Works as a CLI, a Python library, **and** a [Model Context Protocol](https://modelcontextprotocol.io) server. Compatible with Claude Code, Claude Desktop, Codex CLI, Gemini CLI, Cursor, GitHub Copilot, and every other Agent Skills / MCP-compatible tool.
+The Python client is a single self-contained file. Zero dependencies (stdlib only). Works as a CLI, a Python library, **and** a [Model Context Protocol](https://modelcontextprotocol.io) server. Compatible with Claude Code, Claude Desktop, Codex CLI, Gemini CLI, Cursor, GitHub Copilot, and every other Agent Skills / MCP-compatible tool.
+
+The TypeScript client is an npm library for trusted server-side TypeScript projects. It is not a CLI and not an MCP server.
 
 ```
-py/dc.py    ← one file, three integration modes
+py/dc.py       ← Python: CLI + library + MCP server
+ts/src/        ← TypeScript: npm library
+contracts/     ← pinned OpenAPI contract shared by both clients
 ```
 
 ## About the Dynamite Circle
@@ -153,6 +157,21 @@ The same `dc.py` file is shipped as **four** integrations — pick whichever fit
 
 The `mcp` package is **lazy-imported** — Agent Skill / CLI / Python-library users never need it.
 
+### TypeScript npm library
+
+For TypeScript projects, use the package under [`ts/`](ts/):
+
+```ts
+import { DC } from "@dynamitecircle/dc";
+
+const dc = new DC({ apiKey: process.env.DC_API_KEY! });
+
+const profile = await dc.profile.get();
+const trips = await dc.trips.list({ limit: 10 });
+```
+
+Keep `dk_...` API keys server-side. Do not ship a member API key in browser JavaScript.
+
 ### Don't want to install anything? Use the hosted MCP
 
 The DC Member API is **also a hosted MCP server** — a remote endpoint you point your AI app at, with nothing to clone, install, or update:
@@ -437,7 +456,7 @@ The full live reference for the DC Member API — every endpoint, parameter, and
 
 ## Staying up to date
 
-The DC Member API ships new endpoints and refinements regularly. This skill is the official client and we update it whenever the API changes. **Plan for updates** — the skill will warn you on stderr the first time a request returns a server `X-API-Version` newer than `DC_API_VERSION`, and major-version bumps may break older clients.
+The DC Member API ships new endpoints and refinements regularly. This skill is the official client and we update it whenever the API changes. **Plan for updates** — the skill will warn you on stderr the first time a request returns an `X-API-Version` newer than `DC_API_VERSION`, and major-version bumps may break older clients.
 
 **The no-maintenance option:** if you use the [hosted MCP](#hosted-mcp-no-install-always-current) (`https://api.dynamitecircle.com/mcp`), there's nothing to update — the server always runs the current API version. The strategies below apply only to the **local client**.
 
@@ -544,7 +563,7 @@ Best for: CI environments, ephemeral containers, scripted setups.
 
 - **Stay current.** The DC Member API ships new endpoints regularly and the client mirrors them; running stale means missing features and (eventually) compatibility warnings on stderr.
 - **Run `self-test` after every update.** Five seconds, catches breakage.
-- **Watch stderr the first time you call any command after updating.** The version-mismatch warning prints once per process when the server is on a newer minor/major.
+- **Watch stderr the first time you call any command after updating.** The version-mismatch warning prints once per process when the API is on a newer minor/major.
 - **Major version bumps may be backwards-incompatible.** Read the release notes on the GitHub repo before pulling across a major boundary.
 
 ## Rate limits
@@ -590,7 +609,16 @@ dc/
 │   ├── .env.dc.example                # template
 │   └── .env.dc                        # gitignored (created by `setup`)
 │
-│   (Future: go/, node/, rs/ folders for sister clients in other languages)
+├── ts/                                # ← TypeScript npm library (@dynamitecircle/dc)
+│   ├── src/                           # hand-written SDK surface
+│   ├── tests/                         # contract + request behavior tests
+│   ├── examples/                      # TypeScript usage examples
+│   ├── package.json
+│   └── tsconfig.json
+│
+├── contracts/                         # pinned API contract shared by clients
+│   ├── openapi.json                   # committed snapshot of /openapi.json
+│   └── operation-map.json             # OpenAPI op → Python command → TS method
 │
 ├── DC/
 │   └── SKILL.md     → ../py/SKILL.md  # human-friendly skill path (symlink)
@@ -616,9 +644,9 @@ dc/
 
 ### About the layout
 
-This is a **monorepo**. The Python client lives at `/py/` so we can add future sister clients (`go/`, `node/`, `rs/`) at the same level — they all wrap the same DC Member API. `/docs/` is shared. The dotfile-prefixed directories (`.claude/`, `.agents/`, `.gemini/`) exist because AI tools auto-discover skills from those specific paths — they're kept hidden but each one **symlinks (or points) straight to the canonical folder**, so you only edit files in one place. Edit `py/dc.py` and Claude Code, Codex, and Gemini CLI all see the same file via their respective discovery directories. Gemini CLI also reads `.agents/skills/` as an alias, so we don't need a redundant `.gemini/skills/` symlink.
+This is a **monorepo**. The Python client lives at `/py/`; the TypeScript client lives at `/ts/`. Both wrap the same DC Member API and are validated against the pinned contract in `/contracts/`. `/docs/` is shared. The dotfile-prefixed directories (`.claude/`, `.agents/`, `.gemini/`) exist because AI tools auto-discover skills from those specific paths — they're kept hidden but each one **symlinks (or points) straight to the canonical folder**, so you only edit files in one place. Edit `py/dc.py` and Claude Code, Codex, and Gemini CLI all see the same file via their respective discovery directories. Gemini CLI also reads `.agents/skills/` as an alias, so we don't need a redundant `.gemini/skills/` symlink.
 
-If you're adding new code or docs, edit `py/` (or `docs/`) directly. The discovery folders take care of themselves.
+If you're adding Python code or skill docs, edit `py/` (or `docs/`) directly. If you're adding TypeScript library code, edit `ts/`. The discovery folders take care of themselves.
 
 ### Pre-approval out of the box
 
@@ -631,4 +659,3 @@ This repo is maintained by the Dynamite Circle team. It's read-only for the publ
 ## License
 
 [MIT](LICENSE) — see the LICENSE file for the full text.
-

{dynamitecircle-2.0.4 → dynamitecircle-2.3.1}/README.md

@@ -1,11 +1,15 @@
-# DC Official Client
+# DC Official Clients
 
-The official Python client for the [Dynamite Circle Member API](https://www.dynamitecircle.com/developers/) — your own profile, trips, events, virtual events, tickets, invites, inbox, rooms, chapters, places lookup, and the weekly locator digest.
+Official clients for the [Dynamite Circle Member API](https://www.dynamitecircle.com/developers/) — your own profile, trips, events, virtual events, tickets, invites, inbox, rooms, chapters, places lookup, and the weekly locator digest.
 
-A single self-contained file. Zero dependencies (stdlib only). Works as a CLI, a Python library, **and** a [Model Context Protocol](https://modelcontextprotocol.io) server. Compatible with Claude Code, Claude Desktop, Codex CLI, Gemini CLI, Cursor, GitHub Copilot, and every other Agent Skills / MCP-compatible tool.
+The Python client is a single self-contained file. Zero dependencies (stdlib only). Works as a CLI, a Python library, **and** a [Model Context Protocol](https://modelcontextprotocol.io) server. Compatible with Claude Code, Claude Desktop, Codex CLI, Gemini CLI, Cursor, GitHub Copilot, and every other Agent Skills / MCP-compatible tool.
+
+The TypeScript client is an npm library for trusted server-side TypeScript projects. It is not a CLI and not an MCP server.
 
 ```
-py/dc.py    ← one file, three integration modes
+py/dc.py       ← Python: CLI + library + MCP server
+ts/src/        ← TypeScript: npm library
+contracts/     ← pinned OpenAPI contract shared by both clients
 ```
 
 ## About the Dynamite Circle
@@ -100,6 +104,21 @@ The same `dc.py` file is shipped as **four** integrations — pick whichever fit
 
 The `mcp` package is **lazy-imported** — Agent Skill / CLI / Python-library users never need it.
 
+### TypeScript npm library
+
+For TypeScript projects, use the package under [`ts/`](ts/):
+
+```ts
+import { DC } from "@dynamitecircle/dc";
+
+const dc = new DC({ apiKey: process.env.DC_API_KEY! });
+
+const profile = await dc.profile.get();
+const trips = await dc.trips.list({ limit: 10 });
+```
+
+Keep `dk_...` API keys server-side. Do not ship a member API key in browser JavaScript.
+
 ### Don't want to install anything? Use the hosted MCP
 
 The DC Member API is **also a hosted MCP server** — a remote endpoint you point your AI app at, with nothing to clone, install, or update:
@@ -384,7 +403,7 @@ The full live reference for the DC Member API — every endpoint, parameter, and
 
 ## Staying up to date
 
-The DC Member API ships new endpoints and refinements regularly. This skill is the official client and we update it whenever the API changes. **Plan for updates** — the skill will warn you on stderr the first time a request returns a server `X-API-Version` newer than `DC_API_VERSION`, and major-version bumps may break older clients.
+The DC Member API ships new endpoints and refinements regularly. This skill is the official client and we update it whenever the API changes. **Plan for updates** — the skill will warn you on stderr the first time a request returns an `X-API-Version` newer than `DC_API_VERSION`, and major-version bumps may break older clients.
 
 **The no-maintenance option:** if you use the [hosted MCP](#hosted-mcp-no-install-always-current) (`https://api.dynamitecircle.com/mcp`), there's nothing to update — the server always runs the current API version. The strategies below apply only to the **local client**.
 
@@ -491,7 +510,7 @@ Best for: CI environments, ephemeral containers, scripted setups.
 
 - **Stay current.** The DC Member API ships new endpoints regularly and the client mirrors them; running stale means missing features and (eventually) compatibility warnings on stderr.
 - **Run `self-test` after every update.** Five seconds, catches breakage.
-- **Watch stderr the first time you call any command after updating.** The version-mismatch warning prints once per process when the server is on a newer minor/major.
+- **Watch stderr the first time you call any command after updating.** The version-mismatch warning prints once per process when the API is on a newer minor/major.
 - **Major version bumps may be backwards-incompatible.** Read the release notes on the GitHub repo before pulling across a major boundary.
 
 ## Rate limits
@@ -537,7 +556,16 @@ dc/
 │   ├── .env.dc.example                # template
 │   └── .env.dc                        # gitignored (created by `setup`)
 │
-│   (Future: go/, node/, rs/ folders for sister clients in other languages)
+├── ts/                                # ← TypeScript npm library (@dynamitecircle/dc)
+│   ├── src/                           # hand-written SDK surface
+│   ├── tests/                         # contract + request behavior tests
+│   ├── examples/                      # TypeScript usage examples
+│   ├── package.json
+│   └── tsconfig.json
+│
+├── contracts/                         # pinned API contract shared by clients
+│   ├── openapi.json                   # committed snapshot of /openapi.json
+│   └── operation-map.json             # OpenAPI op → Python command → TS method
 │
 ├── DC/
 │   └── SKILL.md     → ../py/SKILL.md  # human-friendly skill path (symlink)
@@ -563,9 +591,9 @@ dc/
 
 ### About the layout
 
-This is a **monorepo**. The Python client lives at `/py/` so we can add future sister clients (`go/`, `node/`, `rs/`) at the same level — they all wrap the same DC Member API. `/docs/` is shared. The dotfile-prefixed directories (`.claude/`, `.agents/`, `.gemini/`) exist because AI tools auto-discover skills from those specific paths — they're kept hidden but each one **symlinks (or points) straight to the canonical folder**, so you only edit files in one place. Edit `py/dc.py` and Claude Code, Codex, and Gemini CLI all see the same file via their respective discovery directories. Gemini CLI also reads `.agents/skills/` as an alias, so we don't need a redundant `.gemini/skills/` symlink.
+This is a **monorepo**. The Python client lives at `/py/`; the TypeScript client lives at `/ts/`. Both wrap the same DC Member API and are validated against the pinned contract in `/contracts/`. `/docs/` is shared. The dotfile-prefixed directories (`.claude/`, `.agents/`, `.gemini/`) exist because AI tools auto-discover skills from those specific paths — they're kept hidden but each one **symlinks (or points) straight to the canonical folder**, so you only edit files in one place. Edit `py/dc.py` and Claude Code, Codex, and Gemini CLI all see the same file via their respective discovery directories. Gemini CLI also reads `.agents/skills/` as an alias, so we don't need a redundant `.gemini/skills/` symlink.
 
-If you're adding new code or docs, edit `py/` (or `docs/`) directly. The discovery folders take care of themselves.
+If you're adding Python code or skill docs, edit `py/` (or `docs/`) directly. If you're adding TypeScript library code, edit `ts/`. The discovery folders take care of themselves.
 
 ### Pre-approval out of the box
 
@@ -578,4 +606,3 @@ This repo is maintained by the Dynamite Circle team. It's read-only for the publ
 ## License
 
 [MIT](LICENSE) — see the LICENSE file for the full text.
-

dynamitecircle-2.3.1/contracts/README.md

@@ -0,0 +1,10 @@
+# DC Member API Contract
+
+This directory pins the API contract used to validate the official clients.
+
+- `openapi.json` is a committed snapshot of `https://api.dynamitecircle.com/openapi.json`.
+- `operation-map.json` maps each OpenAPI operation to the Python command and
+  TypeScript SDK method that covers it.
+
+CI should read this pinned contract, not the live API. Live drift checks can be
+run manually during releases, then the pinned snapshot is updated intentionally.