fix(admin): second review pass

Correctness
- /api/remote never recorded source.created, so URL, GitHub and connector
  sources had a source.deleted with no matching creation. All three creation
  paths now go through one _audit_source_created helper.
- The prompt-cache rate divided cached tokens by a whole bucket's prompt
  tokens. A bucket is a day and mixes calls whose provider reports a cache
  breakdown with calls whose provider does not, so filtering buckets in the
  client could not separate them and the rate was understated by however much
  traffic ran on a non-reporting provider. The denominator is now computed in
  SQL over the reporting rows.
- The outcome pill matched values nothing writes. Guardrails emit triggered /
  not_evaluated and the device feed emits dispatched; the map had blocked /
  denied / allowed, so a guardrail that fired rendered neutral grey -- the one
  signal the merged feed exists to surface. Fixtures were seeding the
  fictional values, so the tests passed on it too.
- Stream duration_ms timed the consumer. stream_token_usage is a generator,
  so start-to-exhaustion includes the agent loop's tool handling and the SSE
  client's pace; a slow browser recorded ~30s for a sub-second call. It now
  accumulates only the time spent inside next().

Safety
- Activity filters failed open: an unknown facet or unparseable timestamp was
  dropped, and no filter means every row, so a typo widened an audit view and
  on the export streamed the full history. Both are now a 400.
- The search term was interpolated into an ILIKE pattern, so "100%" matched
  everything and "q1_report" matched more than it should. Escaped.
- 0034 set actor_id NOT NULL with no default. A previous-release process
  inserting mid-rollout would raise, and in admin/routes.py that insert shares
  the request transaction, so a role grant beside it would roll back too.

Noise and dead code
- The per-user panel is a security panel: data-plane events file under the
  actor, so an active account's routine deletes pushed a denied login out of
  the 20-row window. It now excludes them; the Activity tab shows everything.
- device_audit_log had no created_at-leading index, so the merged feed
  sequentially scanned that branch every page (migration 0036).
- conversation.deleted_all no longer records when nothing was deleted, and
  agent.updated no longer records an empty field list.
- Dropped by_model from /admin/usage (no consumer; an extra aggregate per page
  load), the duplicate filter surface on AuthEventsRepository that nothing
  called, and the unreachable FLOW_LABELS.schedule entry.
- Type hints on record_event's conn and the remaining unannotated helpers.

tests/api/test_admin_activity.py

@@ -129,19 +129,36 @@ class TestFeed:
         assert kwargs["until"] == datetime(2026, 2, 1, tzinfo=timezone.utc)
         assert kwargs["search"] == "handbook"
 
-    def test_unknown_facet_values_are_ignored_not_rejected(self, client):
-        repo = _repo()
-        with _admin(repo):
-            resp = client.get("/api/admin/activity?feed=bogus&category=bogus")
-        assert resp.status_code == 200
-        kwargs = repo.list.call_args.kwargs
-        assert kwargs["feeds"] is None and kwargs["categories"] is None
+    def test_unknown_facet_is_refused_not_dropped(self, client):
+        """Dropping it would mean no filter, and no filter means everything.
 
-    def test_unparseable_time_is_ignored(self, client):
+        A typo or a stale chip must never widen an audit view.
+        """
         repo = _repo()
         with _admin(repo):
-            assert client.get("/api/admin/activity?since=nonsense").status_code == 200
-        assert repo.list.call_args.kwargs["since"] is None
+            resp = client.get("/api/admin/activity?category=bogus")
+        assert resp.status_code == 400
+        assert "bogus" in json.loads(resp.data)["message"]
+        repo.list.assert_not_called()
+
+    def test_unknown_feed_is_refused(self, client):
+        repo = _repo()
+        with _admin(repo):
+            assert client.get("/api/admin/activity?feed=bogus").status_code == 400
+        repo.list.assert_not_called()
+
+    def test_unparseable_time_is_refused(self, client):
+        """Ignoring it would drop the bound and return the full history."""
+        repo = _repo()
+        with _admin(repo):
+            assert client.get("/api/admin/activity?since=nonsense").status_code == 400
+        repo.list.assert_not_called()
+
+    def test_a_valid_facet_still_passes_through(self, client):
+        repo = _repo()
+        with _admin(repo):
+            assert client.get("/api/admin/activity?category=data").status_code == 200
+        assert repo.list.call_args.kwargs["categories"] == ["data"]
 
     def test_repeated_params_accumulate(self, client):
         repo = _repo()
@@ -221,6 +238,15 @@ class TestExport:
             body = client.get("/api/admin/activity/export").get_data(as_text=True)
         assert body.strip().startswith("feed,id,event,category")
 
+    def test_export_refuses_an_unknown_facet(self, client):
+        """Failing open here would stream the whole history to the 100k cap."""
+        repo = _repo()
+        with _admin(repo):
+            resp = client.get("/api/admin/activity/export?category=bogus")
+            resp.get_data()
+        assert resp.status_code == 400
+        repo.iter_all.assert_not_called()
+
     def test_rejects_an_unknown_format(self, client):
         with _admin(_repo()):
             assert (

tests/api/test_admin_dashboard.py

@@ -238,12 +238,10 @@ class TestUsageAndAudit:
                 "generated_tokens": 3,
                 "cost": 0.25,
                 "cached_tokens": None,
+                "cache_eligible_prompt_tokens": 0,
             }
         ]
         usage.sum_tokens_in_range.return_value = 8
-        usage.tokens_by_model.return_value = [
-            {"model_id": "gpt-x", "tokens": 8, "cost": 0.25}
-        ]
         stats = Mock()
         stats.top_token_users.return_value = [
             {"user_id": "a", "tokens": 8, "cost": 0.25}
@@ -280,10 +278,20 @@ class TestUsageAndAudit:
             data = _body(client.get("/api/admin/usage"))
         assert data["total_cost"] == 0.25
         assert data["series"][0]["cost"] == 0.25
-        assert data["by_model"][0]["model_id"] == "gpt-x"
         assert data["latency"]["p95_ms"] == 400
         assert data["top_users"][0]["cost"] == 0.25
 
+    def test_usage_does_not_run_an_aggregate_nothing_reads(self, client):
+        """Per-model spend is served by the per-user endpoint and by group_by."""
+        usage, stats = self._usage_repos()
+        with _admin(
+            TokenUsageRepository=Mock(return_value=usage),
+            AdminStatsRepository=Mock(return_value=stats),
+        ):
+            data = _body(client.get("/api/admin/usage"))
+        assert "by_model" not in data
+        usage.tokens_by_model.assert_not_called()
+
     def test_usage_group_by_reaches_the_repository(self, client):
         usage, stats = self._usage_repos()
         with _admin(

tests/api/test_data_plane_audit.py

@@ -8,6 +8,7 @@ that the audit row is written with the acting user and the resource id.
 
 from __future__ import annotations
 
+import json
 from contextlib import ExitStack, contextmanager
 from unittest.mock import MagicMock, Mock, patch
 
@@ -79,6 +80,81 @@ class TestSourceAudit:
         assert recorded == []
 
 
+_UPLOAD = "docsgpt.api.user.sources.upload"
+
+
+@pytest.mark.unit
+class TestRemoteSourceAudit:
+    """``source.deleted`` is recorded for remote sources, so creation must be.
+
+    A trail showing a source deleted that was apparently never created is
+    worse than no trail, and the docs state ``source.created`` is recorded.
+    """
+
+    @contextmanager
+    def _remote_env(self):
+        recorded: list[tuple] = []
+
+        def _record(_conn, event, *, actor, target=None, **metadata):
+            recorded.append((event, actor, target, metadata))
+
+        @contextmanager
+        def _conn():
+            yield MagicMock()
+
+        task = Mock(id="task-9")
+        with ExitStack() as stack:
+            stack.enter_context(
+                patch("docsgpt.app.handle_auth", return_value={"sub": "u1"})
+            )
+            stack.enter_context(
+                patch("docsgpt.app.resolve_roles", return_value=["user"])
+            )
+            stack.enter_context(patch(f"{_UPLOAD}.db_session", _conn))
+            stack.enter_context(patch(f"{_UPLOAD}.record_event", _record))
+            stack.enter_context(
+                patch(
+                    f"{_UPLOAD}.ingest_remote",
+                    Mock(apply_async=Mock(return_value=task)),
+                )
+            )
+            yield recorded
+
+    def test_url_source_records_source_created(self, client):
+        # The route reads ``request.form``; ``data`` is a JSON string.
+        with self._remote_env() as recorded:
+            resp = client.post(
+                "/api/remote",
+                data={
+                    "user": "u1",
+                    "source": "url",
+                    "name": "Handbook",
+                    "data": json.dumps({"url": "https://example.com"}),
+                },
+            )
+        assert resp.status_code == 200
+        assert [row[0] for row in recorded] == ["source.created"]
+        event, actor, target, metadata = recorded[0]
+        assert (actor, target) == ("u1", None)
+        assert metadata["name"] == "Handbook"
+        assert metadata["type"] == "url"
+        assert metadata["source_id"] == json.loads(resp.data)["source_id"]
+
+    def test_github_source_records_source_created(self, client):
+        with self._remote_env() as recorded:
+            resp = client.post(
+                "/api/remote",
+                data={
+                    "user": "u1",
+                    "source": "github",
+                    "name": "Repo",
+                    "data": json.dumps({"repo_url": "https://github.com/a/b"}),
+                },
+            )
+        assert resp.status_code == 200
+        assert recorded[0][3]["type"] == "github"
+
+
 @pytest.mark.unit
 class TestAgentAudit:
     def test_delete_records_agent_deleted(self, client):