cmpnd 0.72.0__tar.gz → 0.73.0__tar.gz

{cmpnd-0.72.0 → cmpnd-0.73.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: cmpnd
-Version: 0.72.0
+Version: 0.73.0
 Summary: DSPy observability and deployment SDK for cmpnd
 Project-URL: Homepage, https://cmpnd.ai
 Author-email: cmpnd <hello@cmpnd.ai>

{cmpnd-0.72.0 → cmpnd-0.73.0}/cmpnd/cli/commands/admin.py

@@ -121,6 +121,12 @@ def _register_org(sub: _SubParsersAction[ArgumentParser]) -> None:
     elect_owner.add_argument("user_id", help="User id to make owner")
     elect_owner.set_defaults(func=handle_org_elect_owner)
 
+    usage = osub.add_parser(
+        "usage", help="Show the org's limits in use and its activity over 24 hours, 7 days and 30 days"
+    )
+    _org_id_arg(usage)
+    usage.set_defaults(func=handle_org_usage)
+
     plan = osub.add_parser("plan", help="An org's plan and its limits")
     plsub = plan.add_subparsers(dest="org_plan_action")
     plan_show = plsub.add_parser("show", help="Show the org's plan and every limit as it resolves for the org")
@@ -162,6 +168,10 @@ def _register_user(sub: _SubParsersAction[ArgumentParser]) -> None:
     _user_id_arg(show)
     show.set_defaults(func=handle_user_show)
 
+    activity = usub.add_parser("activity", help="Show a user's milestones, memberships and recorded changes")
+    _user_id_arg(activity)
+    activity.set_defaults(func=handle_user_activity)
+
     deprecation.alias(usub, "get", "show", func=handle_user_show, configure=_user_id_arg)
 
     create = usub.add_parser("create", help="Provision a user")
@@ -349,6 +359,10 @@ def handle_org_elect_owner(client: api_client.ApiClient, args: Any) -> Any:
     return {"elected": args.user_id, "github_login": args.github_login}
 
 
+def handle_org_usage(client: api_client.ApiClient, args: Any) -> Any:
+    return client.get(f"/api/v1/admin/organizations/{args.org_id}/usage")
+
+
 def handle_org_plan_show(client: api_client.ApiClient, args: Any) -> Any:
     return client.get(f"/api/v1/admin/organizations/{args.org_id}/plan")
 
@@ -424,6 +438,10 @@ def handle_user_show(client: api_client.ApiClient, args: Any) -> Any:
     return client.get(f"/api/v1/admin/users/{args.id}")
 
 
+def handle_user_activity(client: api_client.ApiClient, args: Any) -> Any:
+    return client.get(f"/api/v1/admin/users/{args.id}/activity")
+
+
 def handle_user_create(client: api_client.ApiClient, args: Any) -> Any:
     # email/name/org_id/is_admin are always sent; password is only included
     # when supplied so the server keeps its own default (e.g. no local login).

{cmpnd-0.72.0 → cmpnd-0.73.0}/cmpnd/cli/verbs.py

@@ -192,7 +192,8 @@ RELATION_NOUNS: dict[str, str] = {
     "registry": "the registered programs, as distinct from the organization's programs",
     "optimized": "the compiled programs optimization runs produced, as distinct from the organization's programs",
     "stats": "a program's execution statistics",
-    "usage": "a program's usage over time",
+    "usage": "a program's usage over time, or an organization's limits in use and recent activity",
+    "activity": "a user's account milestones, memberships and recorded changes",
     "openapi": "the OpenAPI document a deployment serves",
     "history": "a program's distinct prompt instructions over time",
     "evals": "the eval runs recorded against a program",

{cmpnd-0.72.0 → cmpnd-0.73.0}/docs/cli.md

@@ -890,6 +890,23 @@ and a value of `none` lifts the plan's limit for that org.
 `cmpnd admin org overrides delete ORG_ID NAME` deletes the override, so the org
 follows its plan again.
 
+`cmpnd admin org usage ORG_ID` shows what each limit bounds now, in `in_use`,
+and the org's activity in the last 24 hours, 7 days and 30 days, in `windows`.
+Each window counts traces, model calls and tokens, deployment runs by status,
+and hosted optimizations started and cancelled with their compute. `since` is
+the start of the window's first hour. `traces` or `model_usage` is `null` when
+the server has no published count for the window yet.
+
+`cmpnd admin user activity USER_ID` shows a user's milestones, every org they
+belong to, and the newest 50 authority changes recorded about them, such as
+approvals, ownership grants, invites and leaves. A milestone that has not
+happened is `null`. `first_approved_at` is the first approval still on record: an admin-created
+user, an invite redemption and an approved founder write no approval event, so
+their date survives only while a membership keeps it. `oldest_key_at` and
+`last_key_used_at` cover only the keys
+the user still holds, because leaving an org deletes the user's keys there.
+Sign-ins are not recorded, and deployment keys do not count as the user's keys.
+
 `cmpnd admin plans list` shows every plan's limits and feature flags.
 `cmpnd admin plans limits update PLAN NAME VALUE` and `limits delete PLAN NAME`
 change a plan's default for every org on it. `cmpnd admin plans flags update

{cmpnd-0.72.0 → cmpnd-0.73.0}/pyproject.toml

@@ -5,7 +5,7 @@ name = "cmpnd"
 # it's new) — no git tags. Bump with `uv version --bump {minor,patch}` or by
 # hand. Runtime `cmpnd.__version__` reads installed metadata, so it tracks
 # this automatically. See docs/plans/2026-07-02-sdk-pypi-tag-free-publish.md.
-version = "0.72.0"
+version = "0.73.0"
 description = "DSPy observability and deployment SDK for cmpnd"
 readme = "README.md"
 requires-python = ">=3.11"

{cmpnd-0.72.0 → cmpnd-0.73.0}/tests/test_cli/test_admin.py

@@ -283,6 +283,24 @@ def _parse(*argv: str) -> Namespace:
     return parser.parse_args(["admin", *argv])
 
 
+class TestAdminUserActivity:
+    def test_activity_reads_the_users_history(self, mock_client):
+        mock_client.get.return_value = {"user_id": "u_1", "memberships": [], "events": []}
+        args = _parse("user", "activity", "u_1")
+        result = args.func(mock_client, args)
+        mock_client.get.assert_called_once_with("/api/v1/admin/users/u_1/activity")
+        assert result["user_id"] == "u_1"
+
+
+class TestAdminOrgUsage:
+    def test_usage_reads_the_orgs_limits_in_use_and_activity(self, mock_client):
+        mock_client.get.return_value = {"org_id": "o_1", "in_use": {"members.approved": 2}, "windows": []}
+        args = _parse("org", "usage", "o_1")
+        result = args.func(mock_client, args)
+        mock_client.get.assert_called_once_with("/api/v1/admin/organizations/o_1/usage")
+        assert result["in_use"] == {"members.approved": 2}
+
+
 class TestAdminOrgPlan:
     def test_plan_shows_the_orgs_plan(self, mock_client):
         mock_client.get.return_value = {"org_id": "o_1", "plan": "free", "limits": []}

{cmpnd-0.72.0 → cmpnd-0.73.0}/uv.lock

@@ -505,7 +505,7 @@ wheels = [
 
 [[package]]
 name = "cmpnd"
-version = "0.72.0"
+version = "0.73.0"
 source = { editable = "." }
 default-groups = ["dspy-3-4-1"]
 dependencies = [