crudkit 0.6.1__tar.gz → 0.6.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (157) hide show
  1. {crudkit-0.6.1 → crudkit-0.6.2}/CHANGELOG.md +11 -0
  2. {crudkit-0.6.1 → crudkit-0.6.2}/PKG-INFO +1 -1
  3. {crudkit-0.6.1 → crudkit-0.6.2}/pyproject.toml +1 -1
  4. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/models.py +6 -2
  5. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_api/metadata.py +36 -1
  6. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_assistant/agent.py +5 -0
  7. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_assistant/tests/test_sidebar.py +27 -1
  8. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_assistant/tools.py +22 -14
  9. crudkit-0.6.1/src/crudkit_frontend/static/crudkit_frontend/assets/index-BQLfPmKu.js → crudkit-0.6.2/src/crudkit_frontend/static/crudkit_frontend/assets/index-Q2WMdfSq.js +181 -181
  10. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_frontend/templates/crudkit_frontend/index.html +1 -1
  11. {crudkit-0.6.1 → crudkit-0.6.2}/.gitignore +0 -0
  12. {crudkit-0.6.1 → crudkit-0.6.2}/README.md +0 -0
  13. {crudkit-0.6.1 → crudkit-0.6.2}/manage.py +0 -0
  14. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/__init__.py +0 -0
  15. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/admin.py +0 -0
  16. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/ai_backend.py +0 -0
  17. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/apps.py +0 -0
  18. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/audit.py +0 -0
  19. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/authorization.py +0 -0
  20. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/checks.py +0 -0
  21. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/decorators.py +0 -0
  22. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/fields.py +0 -0
  23. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/llm.py +0 -0
  24. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/management/__init__.py +0 -0
  25. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/management/commands/__init__.py +0 -0
  26. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/management/commands/add_default_exchange_rates.py +0 -0
  27. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/management/commands/backfill_ai_fields.py +0 -0
  28. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/management/commands/set_exchange_rate.py +0 -0
  29. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/migrations/0001_squashed.py +0 -0
  30. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/migrations/0002_workspace.py +0 -0
  31. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/migrations/0003_enforce_data_invariants.py +0 -0
  32. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/migrations/0004_changelog_audit.py +0 -0
  33. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/migrations/0005_aicontext.py +0 -0
  34. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/migrations/0006_changelog_audit_indexes.py +0 -0
  35. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/migrations/__init__.py +0 -0
  36. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/profile.py +0 -0
  37. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/realtime.py +0 -0
  38. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/signals.py +0 -0
  39. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/tasks.py +0 -0
  40. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/templatetags/__init__.py +0 -0
  41. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/templatetags/crm_forms.py +0 -0
  42. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/templatetags/crm_time.py +0 -0
  43. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/templatetags/gravatar.py +0 -0
  44. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/templatetags/model_magic.py +0 -0
  45. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/tests/__init__.py +0 -0
  46. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/tests/test_ai_backend.py +0 -0
  47. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/tests/test_ai_context.py +0 -0
  48. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/tests/test_ai_fields.py +0 -0
  49. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/tests/test_ai_tasks.py +0 -0
  50. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/tests/test_audit.py +0 -0
  51. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/tests/test_authorization.py +0 -0
  52. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/tests/test_backfill_command.py +0 -0
  53. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/tests/test_fields.py +0 -0
  54. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/tests/test_hardening.py +0 -0
  55. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/tests/test_integrity.py +0 -0
  56. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/tests/test_llm.py +0 -0
  57. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/tests/test_money.py +0 -0
  58. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/tests/test_tasks.py +0 -0
  59. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/tests/test_view_filters.py +0 -0
  60. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/tests/test_workspace.py +0 -0
  61. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/utils.py +0 -0
  62. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit/widgets.py +0 -0
  63. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_api/__init__.py +0 -0
  64. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_api/authentication.py +0 -0
  65. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_api/consumers.py +0 -0
  66. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_api/filters.py +0 -0
  67. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_api/pagination.py +0 -0
  68. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_api/permissions.py +0 -0
  69. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_api/records.py +0 -0
  70. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_api/routing.py +0 -0
  71. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_api/serializers.py +0 -0
  72. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_api/services.py +0 -0
  73. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_api/tests/__init__.py +0 -0
  74. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_api/tests/test_authorization.py +0 -0
  75. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_api/tests/test_email_id_serialization.py +0 -0
  76. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_api/tests/test_filters.py +0 -0
  77. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_api/tests/test_list_serialization.py +0 -0
  78. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_api/tests/test_merge.py +0 -0
  79. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_api/tests/test_metadata.py +0 -0
  80. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_api/tests/test_realtime.py +0 -0
  81. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_api/tests/test_reorder.py +0 -0
  82. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_api/tests/test_search.py +0 -0
  83. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_api/tests/test_user_profile.py +0 -0
  84. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_api/urls.py +0 -0
  85. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_api/views.py +0 -0
  86. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_api/ws_auth.py +0 -0
  87. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_assistant/__init__.py +0 -0
  88. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_assistant/admin.py +0 -0
  89. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_assistant/apps.py +0 -0
  90. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_assistant/background.py +0 -0
  91. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_assistant/consumers.py +0 -0
  92. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_assistant/deps.py +0 -0
  93. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_assistant/execution.py +0 -0
  94. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_assistant/migrations/0001_initial.py +0 -0
  95. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_assistant/migrations/0002_assistantconversation.py +0 -0
  96. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_assistant/migrations/0003_proposal_revert.py +0 -0
  97. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_assistant/migrations/0004_proposal_sources.py +0 -0
  98. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_assistant/migrations/0005_agent_agentrun.py +0 -0
  99. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_assistant/migrations/__init__.py +0 -0
  100. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_assistant/models.py +0 -0
  101. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_assistant/proposals.py +0 -0
  102. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_assistant/routing.py +0 -0
  103. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_assistant/runner.py +0 -0
  104. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_assistant/screen.py +0 -0
  105. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_assistant/signals.py +0 -0
  106. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_assistant/tasks.py +0 -0
  107. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_assistant/tests/__init__.py +0 -0
  108. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_assistant/tests/test_agents.py +0 -0
  109. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_assistant/tests/test_approvals.py +0 -0
  110. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_assistant/tests/test_hardening.py +0 -0
  111. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_assistant/tests/test_proposals.py +0 -0
  112. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_assistant/utils.py +0 -0
  113. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_frontend/__init__.py +0 -0
  114. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_frontend/apps.py +0 -0
  115. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_frontend/context_processors.py +0 -0
  116. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_frontend/static/crudkit_frontend/assets/favicon-Cit_9t8D.svg +0 -0
  117. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_frontend/static/crudkit_frontend/assets/index-aBiOgiJ7.css +0 -0
  118. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_frontend/tests/__init__.py +0 -0
  119. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_frontend/tests/templates/crudkit_frontend/index.html +0 -0
  120. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_frontend/tests/test_frontend.py +0 -0
  121. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_frontend/tests/urls.py +0 -0
  122. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_frontend/urls.py +0 -0
  123. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_frontend/views.py +0 -0
  124. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_mcp/__init__.py +0 -0
  125. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_mcp/admin.py +0 -0
  126. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_mcp/apps.py +0 -0
  127. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_mcp/authentication.py +0 -0
  128. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_mcp/checks.py +0 -0
  129. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_mcp/conf.py +0 -0
  130. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_mcp/migrations/0001_initial.py +0 -0
  131. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_mcp/migrations/__init__.py +0 -0
  132. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_mcp/models.py +0 -0
  133. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_mcp/oauth.py +0 -0
  134. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_mcp/server.py +0 -0
  135. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_mcp/templates/crudkit_mcp/authorize.html +0 -0
  136. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_mcp/tests/__init__.py +0 -0
  137. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_mcp/tests/test_hardening.py +0 -0
  138. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_mcp/tests/test_mcp.py +0 -0
  139. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_mcp/tests/test_oauth.py +0 -0
  140. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_mcp/tools.py +0 -0
  141. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_mcp/urls.py +0 -0
  142. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_mcp/views.py +0 -0
  143. {crudkit-0.6.1 → crudkit-0.6.2}/src/crudkit_mcp/well_known_urls.py +0 -0
  144. {crudkit-0.6.1 → crudkit-0.6.2}/tests/__init__.py +0 -0
  145. {crudkit-0.6.1 → crudkit-0.6.2}/tests/celery.py +0 -0
  146. {crudkit-0.6.1 → crudkit-0.6.2}/tests/settings.py +0 -0
  147. {crudkit-0.6.1 → crudkit-0.6.2}/tests/testapp/__init__.py +0 -0
  148. {crudkit-0.6.1 → crudkit-0.6.2}/tests/testapp/adapters.py +0 -0
  149. {crudkit-0.6.1 → crudkit-0.6.2}/tests/testapp/ai.py +0 -0
  150. {crudkit-0.6.1 → crudkit-0.6.2}/tests/testapp/apps.py +0 -0
  151. {crudkit-0.6.1 → crudkit-0.6.2}/tests/testapp/migrations/0001_initial.py +0 -0
  152. {crudkit-0.6.1 → crudkit-0.6.2}/tests/testapp/migrations/0002_customer_currency.py +0 -0
  153. {crudkit-0.6.1 → crudkit-0.6.2}/tests/testapp/migrations/0003_ticket_watchers.py +0 -0
  154. {crudkit-0.6.1 → crudkit-0.6.2}/tests/testapp/migrations/0004_topic_sort_order.py +0 -0
  155. {crudkit-0.6.1 → crudkit-0.6.2}/tests/testapp/migrations/__init__.py +0 -0
  156. {crudkit-0.6.1 → crudkit-0.6.2}/tests/testapp/models.py +0 -0
  157. {crudkit-0.6.1 → crudkit-0.6.2}/tests/urls.py +0 -0
@@ -1,5 +1,16 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.6.2 (2026-10-01)
4
+
5
+ - The assistant and agents can find the records that point at a record (association rows,
6
+ children): `describe_object` lists them under `related` with their counts, `get_related`
7
+ accepts the relation's accessor name, related name or TYPE_ID and names the valid relations
8
+ when it can't match, and leaves out soft-deleted rows. The default `get_ai_context()` shows
9
+ a foreign key's id next to its label (`case: Refund missing (CAS12)`), so the assistant can
10
+ follow it. Agents previously guessed relation names and concluded there were none. (#64)
11
+ - Workspace views in the sidebar get a colored dot like My Views instead of the grid icon.
12
+ (#63)
13
+
3
14
  ## 0.6.1 (2026-10-01)
4
15
 
5
16
  - Kanban card order persists: when a kanban view's `order_by` is a numeric field (e.g.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: crudkit
3
- Version: 0.6.1
3
+ Version: 0.6.2
4
4
  Summary: A metadata-driven CRUD framework for Django: typed object IDs, soft delete, merge, change log, activity feed, saved views, AI fields and a generic REST API.
5
5
  Project-URL: Homepage, https://github.com/fenerum/crudkit
6
6
  Project-URL: Changelog, https://github.com/fenerum/crudkit/blob/main/backend/CHANGELOG.md
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "crudkit"
3
- version = "0.6.1"
3
+ version = "0.6.2"
4
4
  description = "A metadata-driven CRUD framework for Django: typed object IDs, soft delete, merge, change log, activity feed, saved views, AI fields and a generic REST API."
5
5
  readme = "README.md"
6
6
  license = "MIT"
@@ -314,8 +314,12 @@ class BaseCrudKitModel(models.Model):
314
314
  if isinstance(field, (models.ImageField, models.FileField)):
315
315
  continue
316
316
  value = getattr(self, field.name, None)
317
- if value is not None:
318
- parts.append(f"{field.verbose_name}: {value}")
317
+ if value is None:
318
+ continue
319
+ # The id lets the assistant follow the link (get_object).
320
+ if hasattr(value, "TYPE_ID"):
321
+ value = f"{value} ({value.pk})"
322
+ parts.append(f"{field.verbose_name}: {value}")
319
323
  return "\n".join(parts)
320
324
 
321
325
  def get_fields(self):
@@ -18,6 +18,7 @@ from crudkit.authorization import get_authorized_queryset, has_model_permission
18
18
  from crudkit.fields import ModelField
19
19
  from crudkit.models import ExternalObject, FeedItem
20
20
  from crudkit.utils import get_model_types
21
+ from crudkit_api.records import SKIPPED_FIELDS
21
22
 
22
23
  # Fields that are housekeeping/audit — never useful patch targets and not
23
24
  # worth showing the LLM.
@@ -219,10 +220,35 @@ def _coerce_current_value(value: Any) -> Any:
219
220
  return str(value)
220
221
 
221
222
 
223
+ def reverse_relations(model, user=None) -> list:
224
+ """The relations through which CrudKit records point at a row of `model`
225
+ (reverse foreign keys and many-to-manys), limited to types `user` may view."""
226
+ return [
227
+ relation
228
+ for relation in model._meta.related_objects
229
+ if (relation.one_to_many or relation.many_to_many)
230
+ and not relation.hidden
231
+ and relation.field.name not in SKIPPED_FIELDS
232
+ and hasattr(relation.related_model, "TYPE_ID")
233
+ and (user is None or has_model_permission(user, relation.related_model, "view"))
234
+ ]
235
+
236
+
237
+ def related_queryset(instance: Model, relation, user=None):
238
+ """The live records pointing at `instance` through `relation` that `user` may view."""
239
+ queryset = getattr(instance, relation.get_accessor_name()).all()
240
+ if user is not None:
241
+ queryset = get_authorized_queryset(user, queryset, "view")
242
+ if "deleted" in {f.name for f in relation.related_model._meta.fields}:
243
+ queryset = queryset.filter(deleted=False)
244
+ return queryset
245
+
246
+
222
247
  def build_instance_metadata(instance: Model, user=None) -> dict[str, Any]:
223
248
  """Return a slim, LLM-friendly projection of the writable fields on an
224
249
  instance: name, type, current value, valid choices, FK options, plus
225
- the available @crm_action names. Skips audit/housekeeping fields."""
250
+ the available @crm_action names and the records pointing at it. Skips
251
+ audit/housekeeping fields."""
226
252
  base = build_model_metadata(instance.__class__)
227
253
  fields_out: dict[str, Any] = {}
228
254
  for name, meta in base["fields"].items():
@@ -250,4 +276,13 @@ def build_instance_metadata(instance: Model, user=None) -> dict[str, Any]:
250
276
  "type": base["type"],
251
277
  "fields": fields_out,
252
278
  "actions": [a["action"] for a in base["actions"]],
279
+ "related": [
280
+ {
281
+ "relation": relation.get_accessor_name(),
282
+ "type": relation.related_model.TYPE_ID,
283
+ "field": relation.field.name,
284
+ "count": related_queryset(instance, relation, user).count(),
285
+ }
286
+ for relation in (reverse_relations(instance.__class__, user) if instance.pk else [])
287
+ ],
253
288
  }
@@ -70,6 +70,11 @@ The ONLY tools you may call are exactly these — never invent another name:
70
70
  Record and propose tools take an optional `id` (e.g. CUS123); without it they
71
71
  use the record open on screen. Use `get_screen_rows` to read the selected or
72
72
  visible rows of a list, and `list_records(view=...)` for a whole saved view.
73
+ Records that point at a record (its children, links and association rows)
74
+ are listed under `related` in `describe_object`, with their counts: read them
75
+ with `get_related(relation)` and follow the ids in what it returns with
76
+ `get_object(id)`. Never conclude a record has no related records without
77
+ checking `related`.
73
78
 
74
79
  Proposals do NOT take effect immediately — they pop up as a Confirm/Skip
75
80
  card in the user's chat. You will be told the outcome in a later turn
@@ -23,7 +23,7 @@ from crudkit_assistant.deps import AssistantDeps
23
23
  from crudkit_assistant.models import AssistantConversation, AssistantProposal
24
24
  from crudkit_assistant.routing import websocket_urlpatterns
25
25
  from crudkit_assistant.screen import MAX_IDS, Screen, describe_screen, parse_screen
26
- from tests.testapp.models import Customer
26
+ from tests.testapp.models import Comment, Customer, Ticket
27
27
 
28
28
  User = get_user_model()
29
29
 
@@ -150,6 +150,32 @@ class CrossRecordToolTests(TestCase):
150
150
  self.assertTrue(self.run_tool(tools.get_related, "notes", id=self.other.pk).startswith("ERROR: Unknown"))
151
151
  self.assertIn("Other", self.run_tool(tools.get_object, id=self.other.pk))
152
152
 
153
+ def test_related_records_are_listed_and_followable(self):
154
+ grant(self.user, "view_ticket", "view_comment")
155
+ ticket = Ticket.objects.create(
156
+ customer=self.other, subject="Broken", created_by=self.user, updated_by=self.user
157
+ )
158
+ Ticket.objects.create(
159
+ customer=self.other, subject="Gone", deleted=True, created_by=self.user, updated_by=self.user
160
+ )
161
+ Comment.objects.create(ticket=ticket, body="Still broken", created_by=self.user, updated_by=self.user)
162
+
163
+ related = self.run_tool(tools.describe_object, id=self.other.pk)["related"]
164
+ self.assertEqual(related, [{"relation": "ticket_set", "type": "TIC", "field": "customer", "count": 1}])
165
+ for name in ("ticket_set", "ticket", "TIC"):
166
+ rows = self.run_tool(tools.get_related, name, id=self.other.pk)
167
+ self.assertEqual([row["id"] for row in rows], [ticket.pk])
168
+ error = self.run_tool(tools.get_related, "case_set", id=self.other.pk)
169
+ self.assertIn("Valid: ['ticket_set (TIC)']", error)
170
+ # Rows name the records they point at by id, so the assistant can follow them.
171
+ comment = self.run_tool(tools.get_related, "comment_set", id=ticket.pk)[0]
172
+ self.assertIn(f"ticket: Broken ({ticket.pk})", comment["context"])
173
+
174
+ def test_related_types_the_user_cannot_view_are_left_out(self):
175
+ Ticket.objects.create(customer=self.other, subject="Broken", created_by=self.user, updated_by=self.user)
176
+ self.assertEqual(self.run_tool(tools.describe_object, id=self.other.pk)["related"], [])
177
+ self.assertTrue(self.run_tool(tools.get_related, "ticket_set", id=self.other.pk).startswith("ERROR"))
178
+
153
179
  def test_screen_rows_skip_hidden_records(self):
154
180
  with hide(self.other):
155
181
  rows = self.run_tool(tools.get_screen_rows)
@@ -27,13 +27,12 @@ from pydantic_ai import RunContext
27
27
 
28
28
  from crudkit.authorization import (
29
29
  get_authorized_instance,
30
- get_authorized_queryset,
31
30
  has_action_permission,
32
31
  has_model_permission,
33
32
  )
34
33
  from crudkit.models import ChangeLog, parse_ck_id
35
34
  from crudkit_api import records, services
36
- from crudkit_api.metadata import build_instance_metadata
35
+ from crudkit_api.metadata import build_instance_metadata, related_queryset, reverse_relations
37
36
  from crudkit_assistant.deps import AssistantDeps
38
37
  from crudkit_assistant.models import AssistantProposal
39
38
  from crudkit_assistant.proposals import create_proposal, patch_label
@@ -159,23 +158,32 @@ async def get_feed(
159
158
  async def get_related(
160
159
  ctx: RunContext[AssistantDeps], relation_name: str, id: str | None = None, limit: int = 20
161
160
  ) -> list[dict[str, Any]] | str:
162
- """Walk a reverse FK relation on a record (default: the one open on screen),
163
- e.g. 'activity_set', 'opportunityproduct_set', 'message_set'. Returns up
164
- to `limit` rows summarised via get_ai_context()."""
161
+ """List the records pointing at a record (default: the one open on screen)
162
+ through one of the relations in describe_object's `related`, e.g.
163
+ 'ticket_set' (or its TYPE_ID, 'TIC'). Returns up to `limit` rows
164
+ summarised via get_ai_context()."""
165
165
 
166
166
  def _run():
167
167
  instance, error = _load_instance(ctx.deps, id)
168
168
  if instance is None:
169
169
  return f"ERROR: {error}"
170
- manager = getattr(instance, relation_name, None)
171
- if manager is None or not hasattr(manager, "all"):
172
- return f"ERROR: Unknown relation {relation_name!r}"
173
- out = []
174
- queryset = get_authorized_queryset(_load_user(ctx.deps), manager.all(), "view")
175
- for obj in queryset[:limit]:
176
- ctx_text = obj.get_ai_context() if hasattr(obj, "get_ai_context") else str(obj)
177
- out.append({"id": str(getattr(obj, "id", obj.pk)), "context": ctx_text})
178
- return out
170
+ user = _load_user(ctx.deps)
171
+ relations = reverse_relations(instance.__class__, user)
172
+ relation = next(
173
+ (
174
+ rel
175
+ for rel in relations
176
+ if relation_name in (rel.get_accessor_name(), rel.name, rel.related_model.TYPE_ID)
177
+ ),
178
+ None,
179
+ )
180
+ if relation is None:
181
+ valid = [f"{rel.get_accessor_name()} ({rel.related_model.TYPE_ID})" for rel in relations]
182
+ return f"ERROR: Unknown relation {relation_name!r}. Valid: {valid}"
183
+ return [
184
+ {"id": str(obj.pk), "context": obj.get_ai_context()}
185
+ for obj in related_queryset(instance, relation, user)[:limit]
186
+ ]
179
187
 
180
188
  return await sync_to_async(_run)()
181
189