@reventlessdev/reventless-core 3.0.0-alpha.211 → 3.0.0-alpha.213

package/CHANGELOG.md

@@ -3,6 +3,28 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# 3.0.0-alpha.213 (2026-08-05)
+
+### Bug Fixes
+
+* **core:** describe slice TODO items by their own schema in the API ([d863056](https://github.com/ReventlessDev/reventless-core/commit/d863056ba734ba3dc76721c32bfb766d777ceb9a))
+### Features
+
+* **core:** cap rendered values in command, event and action logs ([8e07752](https://github.com/ReventlessDev/reventless-core/commit/8e077527ad3c8258582951544ee53d2722876191))
+* **local:** offload large pluginDefinition fields to the object store ([84c5fab](https://github.com/ReventlessDev/reventless-core/commit/84c5fab339856b5d64f0c05110b1fa7f38646f5e))
+* **local:** scoped seed:reset for the local platform ([a4dd003](https://github.com/ReventlessDev/reventless-core/commit/a4dd0033b7d01be23be91bac3f01d38ebeab7d45))
+
+
+# 3.0.0-alpha.212 (2026-08-04)
+
+### Bug Fixes
+
+* **admin:** declare the component fields the resolver already returned ([879fdf3](https://github.com/ReventlessDev/reventless-core/commit/879fdf3e7ac68be23f915db6bdd0fdc68294de5d))
+### Features
+
+* **admin:** serve the complete plugin structure to developer tooling ([e99cda0](https://github.com/ReventlessDev/reventless-core/commit/e99cda02a2f862b36bcfdb018a0fb34bb7426a2b))
+
+
 # 3.0.0-alpha.211 (2026-08-04)
 
 ### Features

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reventlessdev/reventless-core",
-  "version": "3.0.0-alpha.211",
+  "version": "3.0.0-alpha.213",
   "description": "Core package for Reventless framework",
   "license": "Apache-2.0",
   "jest": {
@@ -28,17 +28,17 @@
   "dependencies": {
     "sury": "11.0.0-alpha.4",
     "uuid": "^13.0.0",
-    "@reventlessdev/rescript-fast-csv": "2.0.0-alpha.1",
     "@reventlessdev/rescript-effect": "0.1.0-alpha.32",
+    "@reventlessdev/rescript-fast-csv": "2.0.0-alpha.2",
     "@reventlessdev/rescript-jest": "1.0.0-alpha.10",
     "@reventlessdev/rescript-hash-object": "1.2.0-alpha.14",
-    "@reventlessdev/rescript-node": "2.0.0-alpha.1",
+    "@reventlessdev/rescript-node": "2.0.0-alpha.2",
     "@reventlessdev/rescript-pulumi-pulumi": "2.3.0-alpha.18",
-    "@reventlessdev/rescript-uuid": "2.0.0-alpha.0",
-    "@reventlessdev/rescript-ssh2": "2.0.0-alpha.1",
-    "@reventlessdev/reventless-infra": "3.0.0-alpha.126",
+    "@reventlessdev/rescript-ssh2": "2.0.0-alpha.2",
     "@reventlessdev/reventless-interop": "3.0.0-alpha.30",
-    "@reventlessdev/reventless-spec": "3.0.0-alpha.100"
+    "@reventlessdev/rescript-uuid": "2.0.0-alpha.0",
+    "@reventlessdev/reventless-infra": "3.0.0-alpha.127",
+    "@reventlessdev/reventless-spec": "3.0.0-alpha.101"
   },
   "devDependencies": {
     "rescript": "12.3.0",

package/src/Projection.res

@@ -126,9 +126,12 @@ let applyChanges = async (
 }
 
 // Best-effort: a state that can't be JSON-serialized (e.g. carries a function)
-// must not crash the projection just to produce a debug line.
+// must not crash the projection just to produce a debug line. Capped at the
+// shared log budget — an action line names which row changed, and a read model
+// holding a large field (a plugin structure, an inline offload payload) would
+// otherwise print the whole row twice, once per side of the `=>`.
 let stateToString: 'a => string = state =>
-  state->JSON.stringifyAny->Option.getOr("<unserializable>")
+  state->JSON.stringifyAny->Option.getOr("<unserializable>")->LogFormat.truncate
 let statesToString: array<'a> => string = states =>
   states->Array.map(stateToString)->Array.joinUnsafe(", ")
 

package/src/Projection.res.mjs

@@ -16,6 +16,7 @@ import * as DisplayName$Reventless from "@reventlessdev/reventless-spec/src/comp
 import * as Message$ReventlessCore from "./Message.res.mjs";
 import * as QueryDb$ReventlessCore from "./components/QueryDb/QueryDb.res.mjs";
 import * as QueryDb$ReventlessInfra from "@reventlessdev/reventless-infra/src/components/QueryDb.res.mjs";
+import * as LogFormat$ReventlessCore from "./util/LogFormat.res.mjs";
 
 let log = Logger$ReventlessCore.fromEnv();
 
@@ -195,7 +196,7 @@ async function applyChanges(action, id, beforeStates, afterStates, param, param$
 }
 
 function stateToString(state) {
-  return Stdlib_Option.getOr(JSON.stringify(state), "<unserializable>");
+  return LogFormat$ReventlessCore.truncate(Stdlib_Option.getOr(JSON.stringify(state), "<unserializable>"));
 }
 
 function statesToString(states) {

package/src/admin/Platform_AdminApi.res

@@ -136,11 +136,13 @@ let baseFragment = (~cloner: bool) => {
     ->Array.concat(uiFragmentSubscriptionTypes)
     ->Array.concat(pluginStatusSubscriptionTypes)
     ->Array.concat(Platform_ComponentDefinitionsApi.sdlTypes)
+    ->Array.concat(Platform_PluginStructuresApi.sdlTypes)
     ->Array.concat(Platform_UIFragmentsApi.sdlTypes),
     queries: Array.concat(
       parts.queries,
       [
         Platform_ComponentDefinitionsApi.sdlQueryField,
+        Platform_PluginStructuresApi.sdlQueryField,
         Platform_UIFragmentsApi.sdlQueryField,
       ],
     ),

package/src/admin/Platform_AdminApi.res.mjs

@@ -7,6 +7,7 @@ import * as PluginBaseFragment$ReventlessCore from "../plugin/api/PluginBaseFrag
 import * as Platform_UIFragmentsApi$ReventlessCore from "./Platform_UIFragmentsApi.res.mjs";
 import * as GraphQL_FragmentGenerator$ReventlessCore from "../components/Api/GraphQL_FragmentGenerator.res.mjs";
 import * as Plugin_SubscriptionSchema$ReventlessCore from "../plugin/component/Plugin_SubscriptionSchema.res.mjs";
+import * as Platform_PluginStructuresApi$ReventlessCore from "./Platform_PluginStructuresApi.res.mjs";
 import * as Platform_ComponentDefinitionsApi$ReventlessCore from "./Platform_ComponentDefinitionsApi.res.mjs";
 
 let cloneArgsSchema = S.schema(s => ({
@@ -90,10 +91,11 @@ function baseFragment(cloner) {
   let parts = GraphQL_Stitcher$ReventlessCore.decode(base);
   let match = Plugin_SubscriptionSchema$ReventlessCore.sourceCFields(PluginBaseFragment$ReventlessCore.pluginAggregateMutationEntries);
   return GraphQL_Stitcher$ReventlessCore.encode({
-    types: parts.types.concat(uiFragmentSubscriptionTypes).concat(pluginStatusSubscriptionTypes).concat(Platform_ComponentDefinitionsApi$ReventlessCore.sdlTypes).concat(Platform_UIFragmentsApi$ReventlessCore.sdlTypes),
+    types: parts.types.concat(uiFragmentSubscriptionTypes).concat(pluginStatusSubscriptionTypes).concat(Platform_ComponentDefinitionsApi$ReventlessCore.sdlTypes).concat(Platform_PluginStructuresApi$ReventlessCore.sdlTypes).concat(Platform_UIFragmentsApi$ReventlessCore.sdlTypes),
     mutations: parts.mutations.concat(uiFragmentMutationFields).concat(pluginStatusMutationFields),
     queries: parts.queries.concat([
       Platform_ComponentDefinitionsApi$ReventlessCore.sdlQueryField,
+      Platform_PluginStructuresApi$ReventlessCore.sdlQueryField,
       Platform_UIFragmentsApi$ReventlessCore.sdlQueryField
     ]),
     subscriptions: [

package/src/admin/Platform_ComponentDefinitionsApi.res

@@ -3,18 +3,28 @@
 // and the AWS adapter (which resolves from the Plugin read model). Keeping both
 // adapters byte-identical guarantees a single client query string works against
 // both.
+//
+// The component-level types below are shared with `Platform_PluginStructuresApi`,
+// which serves the same components unfiltered to developer tooling. They are
+// declared here because this is where their encoders live; the two queries differ
+// in WHICH components they return and what the entry carries around them, never in
+// how one component is shaped.
 
 open Reventless.Plugin
 
+// Component-level SDL. Every field a leaf encoder below emits is declared here:
+// a field the resolver returns but the SDL omits is unreachable (GraphQL rejects
+// selecting it), which is how `chapter` and `externalSystem` stayed invisible to
+// consumers long after they were being encoded.
 let sdlTypes: array<string> = [
   `type Platform_FieldReference {\n  fieldName: String!\n  entity: String!\n  plugin: String\n}`,
   `type Platform_CommandDef {\n  name: String!\n  schema: String!\n  level: String!\n  aggregateIdField: String\n  mutationField: String!\n  references: [Platform_FieldReference!]!\n  allowedStates: [String!]\n  targetState: String\n  apiExposed: Boolean\n}`,
   `type Platform_EventDef {\n  name: String!\n  schema: String!\n  references: [Platform_FieldReference!]!\n}`,
-  `type Platform_WriteSideDef {\n  name: String!\n  commands: [Platform_CommandDef!]!\n  linkedViews: [String!]!\n  consistencyRead: String\n  producedEventTypes: [String!]!\n  consumedEventTypes: [String!]!\n  events: [Platform_EventDef!]!\n}`,
-  `type Platform_ReadSideDef {\n  name: String!\n  queryField: String!\n  schema: String!\n  consumedEventTypes: [String!]!\n  linkedWriteSide: [String!]!\n  labelField: String!\n  searchableFields: [String!]!\n  labelFieldSource: String\n  statusField: String\n}`,
-  `type Platform_AutomationSliceDef {\n  name: String!\n  consumedEventTypes: [String!]!\n  producedCommandTypes: [String!]!\n}`,
-  `type Platform_OutboundTranslationSliceDef {\n  name: String!\n  consumedEventTypes: [String!]!\n  inboundCommandTypes: [String!]!\n}`,
-  `type Platform_InboundTranslationSliceDef {\n  name: String!\n  commandTypes: [String!]!\n}`,
+  `type Platform_WriteSideDef {\n  name: String!\n  commands: [Platform_CommandDef!]!\n  linkedViews: [String!]!\n  consistencyRead: String\n  producedEventTypes: [String!]!\n  consumedEventTypes: [String!]!\n  events: [Platform_EventDef!]!\n  chapter: String\n}`,
+  `type Platform_ReadSideDef {\n  name: String!\n  queryField: String!\n  schema: String!\n  consumedEventTypes: [String!]!\n  linkedWriteSide: [String!]!\n  labelField: String!\n  searchableFields: [String!]!\n  labelFieldSource: String\n  statusField: String\n  visibility: String\n  chapter: String\n}`,
+  `type Platform_AutomationSliceDef {\n  name: String!\n  consumedEventTypes: [String!]!\n  producedCommandTypes: [String!]!\n  targetName: String\n  chapter: String\n}`,
+  `type Platform_OutboundTranslationSliceDef {\n  name: String!\n  consumedEventTypes: [String!]!\n  inboundCommandTypes: [String!]!\n  targetName: String\n  externalSystem: String\n  chapter: String\n}`,
+  `type Platform_InboundTranslationSliceDef {\n  name: String!\n  commandTypes: [String!]!\n  targetName: String\n  externalSystem: String\n  chapter: String\n}`,
   `type Platform_ExtensionDef {\n  name: String!\n  delegateNames: [String!]!\n  eventTypes: [String!]!\n  commandTypes: [String!]!\n}`,
   `type Platform_ComponentDefinitionEntry {\n  pluginId: String!\n  readModels: [Platform_ReadSideDef!]!\n  stateViewSlices: [Platform_ReadSideDef!]!\n  stateChangeSlices: [Platform_WriteSideDef!]!\n  aggregates: [Platform_WriteSideDef!]!\n  automationSlices: [Platform_AutomationSliceDef!]!\n  outboundTranslationSlices: [Platform_OutboundTranslationSliceDef!]!\n  inboundTranslationSlices: [Platform_InboundTranslationSliceDef!]!\n  extensions: [Platform_ExtensionDef!]!\n}`,
 ]
@@ -77,6 +87,11 @@ let encodeQueryableDef = (r: queryableDef): JSON.t =>
       r.labelFieldSource->Option.mapOr(JSON.Encode.null, JSON.Encode.string),
     ),
     ("statusField", r.statusField->Option.mapOr(JSON.Encode.null, JSON.Encode.string)),
+    // Carried rather than only filtered on: a tooling consumer reading the
+    // unfiltered structure needs to know WHICH components are Internal, and a
+    // consumer of the filtered query reads null here because nothing Internal
+    // survives the filter anyway.
+    ("visibility", r.visibility->Option.mapOr(JSON.Encode.null, JSON.Encode.string)),
     ("chapter", r.chapter->Option.mapOr(JSON.Encode.null, JSON.Encode.string)),
   ])->JSON.Encode.object
 
@@ -108,6 +123,10 @@ let encodeAutomationSliceDef = (a: automationSliceDef): JSON.t =>
     ("name", JSON.Encode.string(a.name)),
     ("consumedEventTypes", encodeStrings(a.consumedEventTypes)),
     ("producedCommandTypes", encodeStrings(a.producedCommandTypes)),
+    // Routing target — the plugin this slice's commands are dispatched to. It is
+    // what turns a slice into a cross-plugin edge, so a graph consumer needs it
+    // from the structure rather than from the deploy-time inspector sync.
+    ("targetName", JSON.Encode.string(a.targetName)),
     ("chapter", a.chapter->Option.mapOr(JSON.Encode.null, JSON.Encode.string)),
   ])->JSON.Encode.object
 
@@ -116,6 +135,7 @@ let encodeOutboundTranslationSliceDef = (o: outboundTranslationSliceDef): JSON.t
     ("name", JSON.Encode.string(o.name)),
     ("consumedEventTypes", encodeStrings(o.consumedEventTypes)),
     ("inboundCommandTypes", encodeStrings(o.inboundCommandTypes)),
+    ("targetName", o.targetName->Option.mapOr(JSON.Encode.null, JSON.Encode.string)),
     // Foreign system this slice publishes to — lets a deployed-graph consumer draw
     // the external-system boundary box without workspace access. None → null.
     ("externalSystem", o.externalSystem->Option.mapOr(JSON.Encode.null, JSON.Encode.string)),
@@ -126,6 +146,7 @@ let encodeInboundTranslationSliceDef = (i: inboundTranslationSliceDef): JSON.t =
   Dict.fromArray([
     ("name", JSON.Encode.string(i.name)),
     ("commandTypes", encodeStrings(i.commandTypes)),
+    ("targetName", JSON.Encode.string(i.targetName)),
     // Foreign system this slice receives from — lets a deployed-graph consumer draw
     // the external-system boundary box without workspace access. None → null.
     ("externalSystem", i.externalSystem->Option.mapOr(JSON.Encode.null, JSON.Encode.string)),

package/src/admin/Platform_ComponentDefinitionsApi.res.mjs

@@ -8,11 +8,11 @@ let sdlTypes = [
   `type Platform_FieldReference {\n  fieldName: String!\n  entity: String!\n  plugin: String\n}`,
   `type Platform_CommandDef {\n  name: String!\n  schema: String!\n  level: String!\n  aggregateIdField: String\n  mutationField: String!\n  references: [Platform_FieldReference!]!\n  allowedStates: [String!]\n  targetState: String\n  apiExposed: Boolean\n}`,
   `type Platform_EventDef {\n  name: String!\n  schema: String!\n  references: [Platform_FieldReference!]!\n}`,
-  `type Platform_WriteSideDef {\n  name: String!\n  commands: [Platform_CommandDef!]!\n  linkedViews: [String!]!\n  consistencyRead: String\n  producedEventTypes: [String!]!\n  consumedEventTypes: [String!]!\n  events: [Platform_EventDef!]!\n}`,
-  `type Platform_ReadSideDef {\n  name: String!\n  queryField: String!\n  schema: String!\n  consumedEventTypes: [String!]!\n  linkedWriteSide: [String!]!\n  labelField: String!\n  searchableFields: [String!]!\n  labelFieldSource: String\n  statusField: String\n}`,
-  `type Platform_AutomationSliceDef {\n  name: String!\n  consumedEventTypes: [String!]!\n  producedCommandTypes: [String!]!\n}`,
-  `type Platform_OutboundTranslationSliceDef {\n  name: String!\n  consumedEventTypes: [String!]!\n  inboundCommandTypes: [String!]!\n}`,
-  `type Platform_InboundTranslationSliceDef {\n  name: String!\n  commandTypes: [String!]!\n}`,
+  `type Platform_WriteSideDef {\n  name: String!\n  commands: [Platform_CommandDef!]!\n  linkedViews: [String!]!\n  consistencyRead: String\n  producedEventTypes: [String!]!\n  consumedEventTypes: [String!]!\n  events: [Platform_EventDef!]!\n  chapter: String\n}`,
+  `type Platform_ReadSideDef {\n  name: String!\n  queryField: String!\n  schema: String!\n  consumedEventTypes: [String!]!\n  linkedWriteSide: [String!]!\n  labelField: String!\n  searchableFields: [String!]!\n  labelFieldSource: String\n  statusField: String\n  visibility: String\n  chapter: String\n}`,
+  `type Platform_AutomationSliceDef {\n  name: String!\n  consumedEventTypes: [String!]!\n  producedCommandTypes: [String!]!\n  targetName: String\n  chapter: String\n}`,
+  `type Platform_OutboundTranslationSliceDef {\n  name: String!\n  consumedEventTypes: [String!]!\n  inboundCommandTypes: [String!]!\n  targetName: String\n  externalSystem: String\n  chapter: String\n}`,
+  `type Platform_InboundTranslationSliceDef {\n  name: String!\n  commandTypes: [String!]!\n  targetName: String\n  externalSystem: String\n  chapter: String\n}`,
   `type Platform_ExtensionDef {\n  name: String!\n  delegateNames: [String!]!\n  eventTypes: [String!]!\n  commandTypes: [String!]!\n}`,
   `type Platform_ComponentDefinitionEntry {\n  pluginId: String!\n  readModels: [Platform_ReadSideDef!]!\n  stateViewSlices: [Platform_ReadSideDef!]!\n  stateChangeSlices: [Platform_WriteSideDef!]!\n  aggregates: [Platform_WriteSideDef!]!\n  automationSlices: [Platform_AutomationSliceDef!]!\n  outboundTranslationSlices: [Platform_OutboundTranslationSliceDef!]!\n  inboundTranslationSlices: [Platform_InboundTranslationSliceDef!]!\n  extensions: [Platform_ExtensionDef!]!\n}`
 ];
@@ -124,6 +124,10 @@ function encodeQueryableDef(r) {
       "statusField",
       Stdlib_Option.mapOr(r.statusField, null, prim => prim)
     ],
+    [
+      "visibility",
+      Stdlib_Option.mapOr(r.visibility, null, prim => prim)
+    ],
     [
       "chapter",
       Stdlib_Option.mapOr(r.chapter, null, prim => prim)
@@ -199,6 +203,10 @@ function encodeAutomationSliceDef(a) {
       "producedCommandTypes",
       a.producedCommandTypes.map(prim => prim)
     ],
+    [
+      "targetName",
+      a.targetName
+    ],
     [
       "chapter",
       Stdlib_Option.mapOr(a.chapter, null, prim => prim)
@@ -220,6 +228,10 @@ function encodeOutboundTranslationSliceDef(o) {
       "inboundCommandTypes",
       o.inboundCommandTypes.map(prim => prim)
     ],
+    [
+      "targetName",
+      Stdlib_Option.mapOr(o.targetName, null, prim => prim)
+    ],
     [
       "externalSystem",
       Stdlib_Option.mapOr(o.externalSystem, null, prim => prim)
@@ -241,6 +253,10 @@ function encodeInboundTranslationSliceDef(i) {
       "commandTypes",
       i.commandTypes.map(prim => prim)
     ],
+    [
+      "targetName",
+      i.targetName
+    ],
     [
       "externalSystem",
       Stdlib_Option.mapOr(i.externalSystem, null, prim => prim)

package/src/admin/Platform_PluginStructuresApi.res

@@ -0,0 +1,132 @@
+// SDL types and JSON encoder for the `Platform_PluginStructures` GraphQL query —
+// the COMPLETE plugin structure, for developer tooling.
+//
+// Why this is a separate query rather than more fields on
+// `Platform_ComponentDefinitions`: the two have different contracts, and the
+// difference is not cosmetic.
+//
+//   Platform_ComponentDefinitions  the deployed AutoUI's menu, drill-down pages and
+//                                  queryable defs. Internal ReadModels /
+//                                  StateViewSlices are filtered OUT — showing them
+//                                  would put components in an end user's menu that
+//                                  the author marked as not-for-display.
+//   Platform_PluginStructures      what the plugin actually IS. Nothing is filtered,
+//                                  and the producer-side `extensionPoints` are
+//                                  carried, because a tool drawing the domain graph
+//                                  has to see every component and every cross-plugin
+//                                  bridge or the graph it draws is a lie.
+//
+// Folding both into one field would mean either leaking Internal components into
+// AutoUI or hiding them from tooling; there is no filter setting that is right for
+// both. The component-level types are shared with `Platform_ComponentDefinitionsApi`
+// (one component has one shape), so only the entry type and the two structure-level
+// collections live here.
+//
+// Both adapters resolve this from the same persisted `pluginStructure`, so a single
+// client query string works against a deployed platform and an in-memory one.
+
+open Reventless.Plugin
+
+let sdlTypes: array<string> = [
+  // Producer side of an extension point. `commandTypes` is null for a
+  // notification-only (`command = unit`) extension point — see `extensionPointDef`.
+  `type Platform_ExtensionPointDef {\n  name: String!\n  delegateNames: [String!]!\n  sourceEventTypes: [String!]!\n  commandTypes: [String!]\n}`,
+  `type Platform_RequiredStoreDeclaration {\n  store: String!\n  component: String!\n  field: String!\n  annotation: String\n}`,
+  // `extensionPoints` / `requiredStores` / `requiredStoreDeclarations` are nullable
+  // lists, not `[T!]!`: all three are optional on `pluginStructure` so that plugin
+  // definitions persisted before the field existed still decode. A structure written
+  // by an older deploy sends null, and null is the honest answer — an empty list
+  // would claim the plugin has no extension points when the truth is that the
+  // deployment cannot say.
+  `type Platform_PluginStructureEntry {\n  pluginId: String!\n  readModels: [Platform_ReadSideDef!]!\n  stateViewSlices: [Platform_ReadSideDef!]!\n  stateChangeSlices: [Platform_WriteSideDef!]!\n  aggregates: [Platform_WriteSideDef!]!\n  automationSlices: [Platform_AutomationSliceDef!]!\n  outboundTranslationSlices: [Platform_OutboundTranslationSliceDef!]!\n  inboundTranslationSlices: [Platform_InboundTranslationSliceDef!]!\n  extensions: [Platform_ExtensionDef!]!\n  extensionPoints: [Platform_ExtensionPointDef!]\n  requiredStores: [String!]\n  requiredStoreDeclarations: [Platform_RequiredStoreDeclaration!]\n}`,
+]
+
+let sdlQueryField: string = `  Platform_PluginStructures: [Platform_PluginStructureEntry!]!`
+
+let encodeExtensionPointDef = (e: extensionPointDef): JSON.t =>
+  Dict.fromArray([
+    ("name", JSON.Encode.string(e.name)),
+    ("delegateNames", Platform_ComponentDefinitionsApi.encodeStrings(e.delegateNames)),
+    ("sourceEventTypes", Platform_ComponentDefinitionsApi.encodeStrings(e.sourceEventTypes)),
+    (
+      "commandTypes",
+      e.commandTypes->Option.mapOr(JSON.Encode.null, Platform_ComponentDefinitionsApi.encodeStrings),
+    ),
+  ])->JSON.Encode.object
+
+let encodeRequiredStoreDeclaration = (d: requiredStoreDeclaration): JSON.t =>
+  Dict.fromArray([
+    ("store", JSON.Encode.string(d.store)),
+    ("component", JSON.Encode.string(d.component)),
+    ("field", JSON.Encode.string(d.field)),
+    ("annotation", d.annotation->Option.mapOr(JSON.Encode.null, JSON.Encode.string)),
+  ])->JSON.Encode.object
+
+// Deliberately NOT filtered by `isPublicQueryable`: that filter is the AutoUI
+// contract, and applying it here would silently drop Internal components from the
+// graph a developer tool draws.
+let encodePluginStructureEntry = (~pluginId: string, def: pluginStructure): JSON.t =>
+  Dict.fromArray([
+    ("pluginId", JSON.Encode.string(Plugin.name(pluginId))),
+    (
+      "readModels",
+      def.readModels->Array.map(Platform_ComponentDefinitionsApi.encodeQueryableDef)->JSON.Encode.array,
+    ),
+    (
+      "stateViewSlices",
+      def.stateViewSlices
+      ->Array.map(Platform_ComponentDefinitionsApi.encodeQueryableDef)
+      ->JSON.Encode.array,
+    ),
+    (
+      "stateChangeSlices",
+      def.stateChangeSlices
+      ->Array.map(Platform_ComponentDefinitionsApi.encodeWritableDef)
+      ->JSON.Encode.array,
+    ),
+    (
+      "aggregates",
+      def.aggregates->Array.map(Platform_ComponentDefinitionsApi.encodeWritableDef)->JSON.Encode.array,
+    ),
+    (
+      "automationSlices",
+      def.automationSlices
+      ->Array.map(Platform_ComponentDefinitionsApi.encodeAutomationSliceDef)
+      ->JSON.Encode.array,
+    ),
+    (
+      "outboundTranslationSlices",
+      def.outboundTranslationSlices
+      ->Array.map(Platform_ComponentDefinitionsApi.encodeOutboundTranslationSliceDef)
+      ->JSON.Encode.array,
+    ),
+    (
+      "inboundTranslationSlices",
+      def.inboundTranslationSlices
+      ->Array.map(Platform_ComponentDefinitionsApi.encodeInboundTranslationSliceDef)
+      ->JSON.Encode.array,
+    ),
+    (
+      "extensions",
+      def.extensions->Array.map(Platform_ComponentDefinitionsApi.encodeExtensionDef)->JSON.Encode.array,
+    ),
+    (
+      "extensionPoints",
+      def.extensionPoints->Option.mapOr(JSON.Encode.null, eps =>
+        eps->Array.map(encodeExtensionPointDef)->JSON.Encode.array
+      ),
+    ),
+    (
+      "requiredStores",
+      def.requiredStores->Option.mapOr(
+        JSON.Encode.null,
+        Platform_ComponentDefinitionsApi.encodeStrings,
+      ),
+    ),
+    (
+      "requiredStoreDeclarations",
+      def.requiredStoreDeclarations->Option.mapOr(JSON.Encode.null, ds =>
+        ds->Array.map(encodeRequiredStoreDeclaration)->JSON.Encode.array
+      ),
+    ),
+  ])->JSON.Encode.object

package/src/admin/Platform_PluginStructuresApi.res.mjs

@@ -0,0 +1,117 @@
+// Generated by ReScript, PLEASE EDIT WITH CARE
+
+import * as Stdlib_Option from "@rescript/runtime/lib/es6/Stdlib_Option.js";
+import * as Plugin$ReventlessCore from "../plugin/component/Plugin.res.mjs";
+import * as Platform_ComponentDefinitionsApi$ReventlessCore from "./Platform_ComponentDefinitionsApi.res.mjs";
+
+let sdlTypes = [
+  `type Platform_ExtensionPointDef {\n  name: String!\n  delegateNames: [String!]!\n  sourceEventTypes: [String!]!\n  commandTypes: [String!]\n}`,
+  `type Platform_RequiredStoreDeclaration {\n  store: String!\n  component: String!\n  field: String!\n  annotation: String\n}`,
+  `type Platform_PluginStructureEntry {\n  pluginId: String!\n  readModels: [Platform_ReadSideDef!]!\n  stateViewSlices: [Platform_ReadSideDef!]!\n  stateChangeSlices: [Platform_WriteSideDef!]!\n  aggregates: [Platform_WriteSideDef!]!\n  automationSlices: [Platform_AutomationSliceDef!]!\n  outboundTranslationSlices: [Platform_OutboundTranslationSliceDef!]!\n  inboundTranslationSlices: [Platform_InboundTranslationSliceDef!]!\n  extensions: [Platform_ExtensionDef!]!\n  extensionPoints: [Platform_ExtensionPointDef!]\n  requiredStores: [String!]\n  requiredStoreDeclarations: [Platform_RequiredStoreDeclaration!]\n}`
+];
+
+function encodeExtensionPointDef(e) {
+  return Object.fromEntries([
+    [
+      "name",
+      e.name
+    ],
+    [
+      "delegateNames",
+      Platform_ComponentDefinitionsApi$ReventlessCore.encodeStrings(e.delegateNames)
+    ],
+    [
+      "sourceEventTypes",
+      Platform_ComponentDefinitionsApi$ReventlessCore.encodeStrings(e.sourceEventTypes)
+    ],
+    [
+      "commandTypes",
+      Stdlib_Option.mapOr(e.commandTypes, null, Platform_ComponentDefinitionsApi$ReventlessCore.encodeStrings)
+    ]
+  ]);
+}
+
+function encodeRequiredStoreDeclaration(d) {
+  return Object.fromEntries([
+    [
+      "store",
+      d.store
+    ],
+    [
+      "component",
+      d.component
+    ],
+    [
+      "field",
+      d.field
+    ],
+    [
+      "annotation",
+      Stdlib_Option.mapOr(d.annotation, null, prim => prim)
+    ]
+  ]);
+}
+
+function encodePluginStructureEntry(pluginId, def) {
+  return Object.fromEntries([
+    [
+      "pluginId",
+      Plugin$ReventlessCore.name(pluginId)
+    ],
+    [
+      "readModels",
+      def.readModels.map(Platform_ComponentDefinitionsApi$ReventlessCore.encodeQueryableDef)
+    ],
+    [
+      "stateViewSlices",
+      def.stateViewSlices.map(Platform_ComponentDefinitionsApi$ReventlessCore.encodeQueryableDef)
+    ],
+    [
+      "stateChangeSlices",
+      def.stateChangeSlices.map(Platform_ComponentDefinitionsApi$ReventlessCore.encodeWritableDef)
+    ],
+    [
+      "aggregates",
+      def.aggregates.map(Platform_ComponentDefinitionsApi$ReventlessCore.encodeWritableDef)
+    ],
+    [
+      "automationSlices",
+      def.automationSlices.map(Platform_ComponentDefinitionsApi$ReventlessCore.encodeAutomationSliceDef)
+    ],
+    [
+      "outboundTranslationSlices",
+      def.outboundTranslationSlices.map(Platform_ComponentDefinitionsApi$ReventlessCore.encodeOutboundTranslationSliceDef)
+    ],
+    [
+      "inboundTranslationSlices",
+      def.inboundTranslationSlices.map(Platform_ComponentDefinitionsApi$ReventlessCore.encodeInboundTranslationSliceDef)
+    ],
+    [
+      "extensions",
+      def.extensions.map(Platform_ComponentDefinitionsApi$ReventlessCore.encodeExtensionDef)
+    ],
+    [
+      "extensionPoints",
+      Stdlib_Option.mapOr(def.extensionPoints, null, eps => eps.map(encodeExtensionPointDef))
+    ],
+    [
+      "requiredStores",
+      Stdlib_Option.mapOr(def.requiredStores, null, Platform_ComponentDefinitionsApi$ReventlessCore.encodeStrings)
+    ],
+    [
+      "requiredStoreDeclarations",
+      Stdlib_Option.mapOr(def.requiredStoreDeclarations, null, ds => ds.map(encodeRequiredStoreDeclaration))
+    ]
+  ]);
+}
+
+let sdlQueryField = `  Platform_PluginStructures: [Platform_PluginStructureEntry!]!`;
+
+export {
+  sdlTypes,
+  sdlQueryField,
+  encodeExtensionPointDef,
+  encodeRequiredStoreDeclaration,
+  encodePluginStructureEntry,
+}
+/* No side effect */

package/src/components/AutomationSlice/AutomationSlice_Callback.res

@@ -31,6 +31,36 @@ type todoRow = {
   retryCount: int,
 }
 
+/** The item schema seen through the `JSON.t` the row actually stores.
+
+    `item` holds `Spec.todoItemSchema`-encoded JSON, so the item schema already
+    describes the stored value exactly — only the ReScript types disagree. */
+external itemAsJson: S.t<'item> => S.t<JSON.t> = "%identity"
+
+/**
+The row schema as the API describes it: `item` carried by the slice's own item
+schema instead of as opaque JSON.
+
+`todoRowSchema` types `item` as `JSON.t`, which the schema→GraphQL IR can only
+classify as `Unknown` — and `Unknown` renders as `String!`. The field then
+serves a stored object through a String, which fails at execution ("String
+cannot represent value: { … }") the moment a client selects it. Describing the
+item shape gives the field a real object type instead.
+
+Shape only: never encode or parse a row with this. The runtime field is `JSON.t`
+and the identity cast above would have `S.parseOrThrow` hand back an item where
+the row's own code expects JSON.
+*/
+let todoRowSchemaFor = (itemSchema: S.t<'item>): S.t<todoRow> =>
+  S.schema(s => {
+    item: s.matches(itemSchema->itemAsJson),
+    status: s.matches(todoStatusSchema),
+    createdAt: s.matches(S.string),
+    processedAt: ?s.matches(S.option(S.string)),
+    completedAt: ?s.matches(S.option(S.string)),
+    retryCount: s.matches(S.int),
+  })
+
 /**
 The runtime protocol between a built callback and whoever drives it — the same
 arrangement as `OutboundTranslationSlice_Callback`, and for the same reason. The

package/src/components/AutomationSlice/AutomationSlice_Callback.res.mjs

@@ -30,6 +30,17 @@ let todoRowSchema = S.schema(s => ({
   retryCount: s.m(S.int)
 }));
 
+function todoRowSchemaFor(itemSchema) {
+  return S.schema(s => ({
+    item: s.m(itemSchema),
+    status: s.m(todoStatusSchema),
+    createdAt: s.m(S.string),
+    processedAt: s.m(S.option(S.string)),
+    completedAt: s.m(S.option(S.string)),
+    retryCount: s.m(S.int)
+  }));
+}
+
 function Make(Spec) {
   return Automation => {
     let todoItems = {};
@@ -184,6 +195,7 @@ function Make(Spec) {
 export {
   todoStatusSchema,
   todoRowSchema,
+  todoRowSchemaFor,
   Make,
 }
 /*  Not a pure module */

package/src/components/Dcb/Dcb_Builder.res

@@ -1009,7 +1009,9 @@ module Make = (
             ReventlessInfra.Api.singleFieldName: qn.singleFieldName,
             listFieldName: qn.listFieldName,
             returnTypeName: qn.returnTypeName,
-            stateSchema: AutomationSlice_Callback.todoRowSchema->S.castToUnknown,
+            stateSchema: AutomationSlice_Callback.todoRowSchemaFor(
+              A.Spec.todoItemSchema,
+            )->S.castToUnknown,
             authorization: None,
             connectionSpec: true,
           }
@@ -1023,7 +1025,9 @@ module Make = (
             ReventlessInfra.Api.singleFieldName: qn.singleFieldName,
             listFieldName: qn.listFieldName,
             returnTypeName: qn.returnTypeName,
-            stateSchema: OutboundTranslationSlice_Callback.todoRowSchema->S.castToUnknown,
+            stateSchema: OutboundTranslationSlice_Callback.todoRowSchemaFor(
+              O.Spec.outboundItemSchema,
+            )->S.castToUnknown,
             authorization: None,
             connectionSpec: true,
           }

package/src/components/Dcb/Dcb_Builder.res.mjs

@@ -531,7 +531,7 @@ function Make(DcbEventLogStorage) {
           singleFieldName: qn.singleFieldName,
           listFieldName: qn.listFieldName,
           returnTypeName: qn.returnTypeName,
-          stateSchema: AutomationSlice_Callback$ReventlessCore.todoRowSchema,
+          stateSchema: AutomationSlice_Callback$ReventlessCore.todoRowSchemaFor(A.Spec.todoItemSchema),
           authorization: undefined,
           connectionSpec: true
         };
@@ -542,7 +542,7 @@ function Make(DcbEventLogStorage) {
           singleFieldName: qn.singleFieldName,
           listFieldName: qn.listFieldName,
           returnTypeName: qn.returnTypeName,
-          stateSchema: OutboundTranslationSlice_Callback$ReventlessCore.todoRowSchema,
+          stateSchema: OutboundTranslationSlice_Callback$ReventlessCore.todoRowSchemaFor(O.Spec.outboundItemSchema),
           authorization: undefined,
           connectionSpec: true
         };