Topolo Docs Topolo Platform
Open workspace

Get widget summary

Get the TopoloOne widget summary for this service.

Outcome

Get the TopoloOne widget summary for this service.

Before you start

  • Verify identity and pin the intended organization and environment before discovering the action.
  • This Worker context route uses verified identity without resolving a Nurture product workspace. Bootstrap organization can be null; it does not discover a granted workspace.

Discover the target

topolo whoami --json
topolo actions get app_topolo_nurture.widget.get --detail --json

Request

GET /api/widget

Save action input as payload.json. The reviewed plan separates path identifiers, query fields and HTTP body. No Nurture workspace selection is required for this context route.

Inspect and test this action in the signed action console. A test response still requires the verification below.

Input fields

Use an empty JSON object; verified credential and resource context are separate.

Exact input schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Effects

  • Reads the widget summary without changing state.

Interpret the response

The returned identifier path is $.widgets[].id for widget. Empty lists do not discover a target.

Validate the response against the Topolo widget output schema.

Exact success schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean",
      "const": true
    },
    "contractVersion": {
      "type": "string",
      "const": "3.0.0"
    },
    "appId": {
      "type": "string",
      "minLength": 1
    },
    "serviceName": {
      "type": "string",
      "minLength": 1
    },
    "generatedAt": {
      "type": "string",
      "minLength": 1
    },
    "widgets": {
      "type": "array",
      "minItems": 1,
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1
          },
          "version": {
            "type": "string",
            "minLength": 1
          },
          "appId": {
            "type": "string",
            "minLength": 1
          },
          "serviceName": {
            "type": "string",
            "minLength": 1
          },
          "lastUpdated": {
            "type": "string",
            "minLength": 1
          },
          "type": {
            "enum": [
              "stats",
              "chart",
              "activity",
              "notifications",
              "actions"
            ]
          },
          "presentation": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "minLength": 1
              },
              "description": {
                "type": "string",
                "minLength": 1
              },
              "contexts": {
                "type": "array",
                "minItems": 1,
                "items": {
                  "enum": [
                    "personal",
                    "organization",
                    "workspace",
                    "resource"
                  ]
                }
              },
              "supportedSizes": {
                "type": "array",
                "minItems": 1,
                "items": {
                  "enum": [
                    "compact",
                    "medium",
                    "wide",
                    "full"
                  ]
                }
              },
              "defaultSize": {
                "enum": [
                  "compact",
                  "medium",
                  "wide",
                  "full"
                ]
              }
            },
            "required": [
              "title",
              "contexts",
              "supportedSizes",
              "defaultSize"
            ],
            "additionalProperties": false
          },
          "resource": {
            "type": "object",
            "properties": {
              "resourceType": {
                "type": "string",
                "minLength": 1
              },
              "resourceId": {
                "type": "string",
                "minLength": 1
              },
              "requiredPermissions": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1
                }
              }
            },
            "required": [
              "resourceType",
              "requiredPermissions"
            ],
            "additionalProperties": false
          },
          "state": {
            "type": "object",
            "properties": {
              "status": {
                "enum": [
                  "ready",
                  "empty",
                  "unavailable",
                  "stale",
                  "error"
                ]
              },
              "observedAt": {
                "type": "string",
                "minLength": 1
              },
              "lastSuccessfulAt": {
                "type": "string",
                "minLength": 1
              },
              "code": {
                "type": "string",
                "minLength": 1
              },
              "message": {
                "type": "string",
                "minLength": 1
              }
            },
            "required": [
              "status",
              "observedAt"
            ],
            "additionalProperties": false
          },
          "refresh": {
            "type": "object",
            "properties": {
              "intervalSeconds": {
                "type": "number"
              },
              "timeoutSeconds": {
                "type": "number"
              },
              "maxAgeSeconds": {
                "type": "number"
              },
              "staleWhileRevalidateSeconds": {
                "type": "number"
              }
            },
            "required": [
              "intervalSeconds",
              "timeoutSeconds",
              "maxAgeSeconds",
              "staleWhileRevalidateSeconds"
            ],
            "additionalProperties": false
          },
          "configuration": {
            "type": "object",
            "properties": {
              "allowMultipleInstances": {
                "type": "boolean"
              },
              "fields": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "key": {
                      "type": "string",
                      "minLength": 1
                    },
                    "label": {
                      "type": "string",
                      "minLength": 1
                    },
                    "type": {
                      "enum": [
                        "string",
                        "number",
                        "boolean",
                        "select",
                        "multi-select",
                        "date-range"
                      ]
                    },
                    "required": {
                      "type": "boolean"
                    },
                    "options": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "value": {
                            "type": "string",
                            "minLength": 1
                          },
                          "label": {
                            "type": "string",
                            "minLength": 1
                          }
                        },
                        "required": [
                          "value",
                          "label"
                        ],
                        "additionalProperties": false
                      }
                    }
                  },
                  "required": [
                    "key",
                    "label",
                    "type",
                    "required"
                  ],
                  "additionalProperties": false
                }
              },
              "defaults": {
                "type": "object"
              }
            },
            "required": [
              "allowMultipleInstances",
              "fields",
              "defaults"
            ],
            "additionalProperties": false
          },
          "drilldowns": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "minLength": 1
                },
                "label": {
                  "type": "string",
                  "minLength": 1
                },
                "href": {
                  "type": "string",
                  "minLength": 1
                }
              },
              "required": [
                "id",
                "label",
                "href"
              ],
              "additionalProperties": false
            }
          },
          "controls": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "minLength": 1
                },
                "label": {
                  "type": "string",
                  "minLength": 1
                },
                "actionId": {
                  "type": "string",
                  "minLength": 1
                },
                "resourceType": {
                  "type": "string",
                  "minLength": 1
                },
                "resourceId": {
                  "type": "string",
                  "minLength": 1
                },
                "input": {
                  "type": "object"
                },
                "requiresConfirmation": {
                  "type": "boolean"
                },
                "destructive": {
                  "type": "boolean"
                },
                "effects": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "minLength": 1
                  }
                },
                "verification": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "minLength": 1
                  }
                },
                "recovery": {
                  "type": "object",
                  "properties": {
                    "mode": {
                      "enum": [
                        "not_applicable",
                        "retry",
                        "compensating_action"
                      ]
                    },
                    "actionId": {
                      "type": "string",
                      "minLength": 1
                    },
                    "instructions": {
                      "type": "string",
                      "minLength": 1
                    }
                  },
                  "required": [
                    "mode",
                    "instructions"
                  ],
                  "additionalProperties": false
                }
              },
              "required": [
                "id",
                "label",
                "actionId",
                "resourceType",
                "input",
                "requiresConfirmation",
                "destructive",
                "effects",
                "verification",
                "recovery"
              ],
              "additionalProperties": false
            }
          },
          "localization": {
            "type": "object",
            "properties": {
              "locale": {
                "type": "string",
                "minLength": 1
              },
              "titleKey": {
                "type": "string",
                "minLength": 1
              },
              "descriptionKey": {
                "type": "string",
                "minLength": 1
              },
              "title": {
                "type": "string",
                "minLength": 1
              },
              "description": {
                "type": "string",
                "minLength": 1
              }
            },
            "required": [
              "locale",
              "titleKey"
            ],
            "additionalProperties": false
          },
          "accessibility": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "minLength": 1
              },
              "description": {
                "type": "string",
                "minLength": 1
              }
            },
            "required": [
              "label"
            ],
            "additionalProperties": false
          },
          "contribution": {
            "type": "object",
            "properties": {
              "summary": {
                "type": "string",
                "minLength": 1
              },
              "identity": {
                "type": "object",
                "properties": {
                  "iconSource": {
                    "const": "catalog"
                  }
                },
                "required": [
                  "iconSource"
                ],
                "additionalProperties": false
              },
              "workspaceSelector": {
                "type": "object",
                "properties": {
                  "mode": {
                    "enum": [
                      "none",
                      "optional",
                      "required"
                    ]
                  },
                  "resourceType": {
                    "type": "string",
                    "minLength": 1
                  },
                  "label": {
                    "type": "string",
                    "minLength": 1
                  },
                  "supportsMultiple": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "mode",
                  "resourceType",
                  "label",
                  "supportsMultiple"
                ],
                "additionalProperties": false
              },
              "metricDefinitions": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "key": {
                      "type": "string",
                      "minLength": 1
                    },
                    "label": {
                      "type": "string",
                      "minLength": 1
                    },
                    "description": {
                      "type": "string",
                      "minLength": 1
                    },
                    "unit": {
                      "type": "string",
                      "minLength": 1
                    },
                    "semantic": {
                      "enum": [
                        "gauge",
                        "counter",
                        "rate",
                        "duration",
                        "currency",
                        "percentage"
                      ]
                    },
                    "aggregation": {
                      "enum": [
                        "last",
                        "sum",
                        "average",
                        "minimum",
                        "maximum",
                        "count",
                        "distinct_count"
                      ]
                    }
                  },
                  "required": [
                    "key",
                    "label",
                    "description",
                    "unit",
                    "semantic",
                    "aggregation"
                  ],
                  "additionalProperties": false
                }
              },
              "seriesDefinitions": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "key": {
                      "type": "string",
                      "minLength": 1
                    },
                    "label": {
                      "type": "string",
                      "minLength": 1
                    },
                    "metricKey": {
                      "type": "string",
                      "minLength": 1
                    },
                    "unit": {
                      "type": "string",
                      "minLength": 1
                    }
                  },
                  "required": [
                    "key",
                    "label",
                    "metricKey",
                    "unit"
                  ],
                  "additionalProperties": false
                }
              },
              "dimensions": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "key": {
                      "type": "string",
                      "minLength": 1
                    },
                    "label": {
                      "type": "string",
                      "minLength": 1
                    },
                    "description": {
                      "type": "string",
                      "minLength": 1
                    },
                    "valueType": {
                      "enum": [
                        "string",
                        "number",
                        "boolean",
                        "date",
                        "datetime"
                      ]
                    }
                  },
                  "required": [
                    "key",
                    "label",
                    "description",
                    "valueType"
                  ],
                  "additionalProperties": false
                }
              },
              "lifecycleStages": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "key": {
                      "type": "string",
                      "minLength": 1
                    },
                    "label": {
                      "type": "string",
                      "minLength": 1
                    },
                    "order": {
                      "type": "number"
                    },
                    "terminal": {
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "key",
                    "label",
                    "order",
                    "terminal"
                  ],
                  "additionalProperties": false
                }
              },
              "events": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "key": {
                      "type": "string",
                      "minLength": 1
                    },
                    "label": {
                      "type": "string",
                      "minLength": 1
                    },
                    "description": {
                      "type": "string",
                      "minLength": 1
                    }
                  },
                  "required": [
                    "key",
                    "label",
                    "description"
                  ],
                  "additionalProperties": false
                }
              },
              "datasets": {
                "type": "array",
                "minItems": 1,
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "minLength": 1
                    },
                    "label": {
                      "type": "string",
                      "minLength": 1
                    },
                    "description": {
                      "type": "string",
                      "minLength": 1
                    },
                    "grain": {
                      "type": "string",
                      "minLength": 1
                    },
                    "metricKeys": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1
                      }
                    },
                    "seriesKeys": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1
                      }
                    },
                    "dimensionKeys": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1
                      }
                    },
                    "eventKeys": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1
                      }
                    },
                    "actionIds": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1
                      }
                    }
                  },
                  "required": [
                    "id",
                    "label",
                    "description",
                    "grain",
                    "metricKeys",
                    "seriesKeys",
                    "dimensionKeys",
                    "eventKeys",
                    "actionIds"
                  ],
                  "additionalProperties": false
                }
              },
              "compatibleVisualizations": {
                "type": "array",
                "minItems": 1,
                "items": {
                  "enum": [
                    "number",
                    "line",
                    "area",
                    "bar",
                    "donut",
                    "table",
                    "funnel",
                    "timeline",
                    "actions"
                  ]
                }
              },
              "defaultVisualization": {
                "enum": [
                  "number",
                  "line",
                  "area",
                  "bar",
                  "donut",
                  "table",
                  "funnel",
                  "timeline",
                  "actions"
                ]
              }
            },
            "required": [
              "summary",
              "identity",
              "workspaceSelector",
              "metricDefinitions",
              "seriesDefinitions",
              "dimensions",
              "lifecycleStages",
              "events",
              "datasets",
              "compatibleVisualizations",
              "defaultVisualization"
            ],
            "additionalProperties": false
          },
          "metrics": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "key": {
                  "type": "string",
                  "minLength": 1
                },
                "label": {
                  "type": "string",
                  "minLength": 1
                },
                "value": {
                  "type": "number"
                },
                "unit": {
                  "type": "string",
                  "minLength": 1
                },
                "semantic": {
                  "enum": [
                    "gauge",
                    "counter",
                    "rate",
                    "duration",
                    "currency",
                    "percentage"
                  ]
                },
                "aggregation": {
                  "enum": [
                    "last",
                    "sum",
                    "average",
                    "minimum",
                    "maximum",
                    "count",
                    "distinct_count"
                  ]
                },
                "period": {
                  "type": "object",
                  "properties": {
                    "start": {
                      "type": "string",
                      "minLength": 1
                    },
                    "end": {
                      "type": "string",
                      "minLength": 1
                    },
                    "timezone": {
                      "type": "string",
                      "minLength": 1
                    }
                  },
                  "required": [
                    "start",
                    "end",
                    "timezone"
                  ],
                  "additionalProperties": false
                },
                "dimensions": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "key": {
                        "type": "string",
                        "minLength": 1
                      },
                      "label": {
                        "type": "string",
                        "minLength": 1
                      },
                      "value": {
                        "type": "string",
                        "minLength": 1
                      }
                    },
                    "required": [
                      "key",
                      "label",
                      "value"
                    ],
                    "additionalProperties": false
                  }
                },
                "series": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "minLength": 1
                    },
                    "label": {
                      "type": "string",
                      "minLength": 1
                    },
                    "unit": {
                      "type": "string",
                      "minLength": 1
                    },
                    "points": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "timestamp": {
                            "type": "string",
                            "minLength": 1
                          },
                          "value": {
                            "type": "number"
                          },
                          "dimensions": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "key": {
                                  "type": "string",
                                  "minLength": 1
                                },
                                "label": {
                                  "type": "string",
                                  "minLength": 1
                                },
                                "value": {
                                  "type": "string",
                                  "minLength": 1
                                }
                              },
                              "required": [
                                "key",
                                "label",
                                "value"
                              ],
                              "additionalProperties": false
                            }
                          }
                        },
                        "required": [
                          "timestamp",
                          "value",
                          "dimensions"
                        ],
                        "additionalProperties": false
                      }
                    }
                  },
                  "required": [
                    "id",
                    "label",
                    "unit",
                    "points"
                  ],
                  "additionalProperties": false
                }
              },
              "required": [
                "key",
                "label",
                "value",
                "unit",
                "semantic",
                "aggregation",
                "period",
                "dimensions"
              ],
              "additionalProperties": false
            }
          },
          "chartType": {
            "enum": [
              "line",
              "bar",
              "area",
              "pie",
              "donut"
            ]
          },
          "series": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "minLength": 1
                },
                "label": {
                  "type": "string",
                  "minLength": 1
                },
                "unit": {
                  "type": "string",
                  "minLength": 1
                },
                "points": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "timestamp": {
                        "type": "string",
                        "minLength": 1
                      },
                      "value": {
                        "type": "number"
                      },
                      "dimensions": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "minLength": 1
                            },
                            "label": {
                              "type": "string",
                              "minLength": 1
                            },
                            "value": {
                              "type": "string",
                              "minLength": 1
                            }
                          },
                          "required": [
                            "key",
                            "label",
                            "value"
                          ],
                          "additionalProperties": false
                        }
                      }
                    },
                    "required": [
                      "timestamp",
                      "value",
                      "dimensions"
                    ],
                    "additionalProperties": false
                  }
                }
              },
              "required": [
                "id",
                "label",
                "unit",
                "points"
              ],
              "additionalProperties": false
            }
          },
          "activities": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "notifications": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "unreadCount": {
            "type": "number"
          },
          "actions": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "minLength": 1
                },
                "label": {
                  "type": "string",
                  "minLength": 1
                },
                "actionId": {
                  "type": "string",
                  "minLength": 1
                },
                "resourceType": {
                  "type": "string",
                  "minLength": 1
                },
                "resourceId": {
                  "type": "string",
                  "minLength": 1
                },
                "input": {
                  "type": "object"
                },
                "requiresConfirmation": {
                  "type": "boolean"
                },
                "destructive": {
                  "type": "boolean"
                },
                "effects": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "minLength": 1
                  }
                },
                "verification": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "minLength": 1
                  }
                },
                "recovery": {
                  "type": "object",
                  "properties": {
                    "mode": {
                      "enum": [
                        "not_applicable",
                        "retry",
                        "compensating_action"
                      ]
                    },
                    "actionId": {
                      "type": "string",
                      "minLength": 1
                    },
                    "instructions": {
                      "type": "string",
                      "minLength": 1
                    }
                  },
                  "required": [
                    "mode",
                    "instructions"
                  ],
                  "additionalProperties": false
                }
              },
              "required": [
                "id",
                "label",
                "actionId",
                "resourceType",
                "input",
                "requiresConfirmation",
                "destructive",
                "effects",
                "verification",
                "recovery"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "id",
          "version",
          "appId",
          "serviceName",
          "lastUpdated",
          "type",
          "presentation",
          "resource",
          "state",
          "refresh",
          "configuration",
          "drilldowns",
          "controls",
          "localization",
          "accessibility",
          "contribution"
        ],
        "allOf": [
          {
            "if": {
              "properties": {
                "type": {
                  "const": "stats"
                }
              }
            },
            "then": {
              "required": [
                "metrics"
              ]
            }
          },
          {
            "if": {
              "properties": {
                "type": {
                  "const": "chart"
                }
              }
            },
            "then": {
              "required": [
                "chartType",
                "series"
              ]
            }
          },
          {
            "if": {
              "properties": {
                "type": {
                  "const": "activity"
                }
              }
            },
            "then": {
              "required": [
                "activities"
              ]
            }
          },
          {
            "if": {
              "properties": {
                "type": {
                  "const": "notifications"
                }
              }
            },
            "then": {
              "required": [
                "notifications",
                "unreadCount"
              ]
            }
          },
          {
            "if": {
              "properties": {
                "type": {
                  "const": "actions"
                }
              }
            },
            "then": {
              "required": [
                "actions"
              ]
            }
          }
        ],
        "additionalProperties": false
      }
    },
    "workspace": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "number"
                }
              ]
            },
            "name": {
              "type": "string",
              "minLength": 1
            }
          },
          "required": [
            "id",
            "name"
          ],
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ]
    },
    "workspaces": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "number"
              }
            ]
          },
          "name": {
            "type": "string",
            "minLength": 1
          },
          "isDefault": {
            "type": "boolean"
          }
        },
        "required": [
          "id",
          "name"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "success",
    "contractVersion",
    "appId",
    "serviceName",
    "generatedAt",
    "widgets"
  ],
  "additionalProperties": false
}

Worked examples

Actual dispatcher and migration-created SQLite or Worker handlers; identity/workspace and external service dependencies are simulated. Fixture identifiers and timestamps are synthetic. These responses establish no live authorization, paid generation, credential provisioning or message delivery. Replace synthetic identifiers using credential-scoped discovery. A local success is not evidence of a deployed effect, configured provider or delivered message.

Successful request

Actual Nurture Worker handler and widget builder; runtime identity, credential verification and failure injection are simulated. No live authorization is established.

Input · payload.json:

{}

CLI:

topolo actions validate app_topolo_nurture.widget.get --data @payload.json --json
topolo actions plan app_topolo_nurture.widget.get --data @payload.json --json
topolo actions call app_topolo_nurture.widget.get --data @payload.json --json

MCP tool and arguments:

{
  "tool": "topolo_read_action",
  "arguments": {
    "actionId": "app_topolo_nurture.widget.get",
    "input": {}
  }
}

Captured local response · HTTP 200:

{
  "success": true,
  "contractVersion": "3.0.0",
  "appId": "app_topolo_nurture",
  "serviceName": "Nurture",
  "generatedAt": "2026-10-04T00:32:39.094Z",
  "widgets": [
    {
      "id": "app.overview",
      "version": "3.0.0",
      "type": "stats",
      "presentation": {
        "title": "Nurture",
        "contexts": [
          "organization"
        ],
        "supportedSizes": [
          "compact",
          "medium"
        ],
        "defaultSize": "medium"
      },
      "resource": {
        "resourceType": "organization",
        "requiredPermissions": [
          "workspace:read"
        ]
      },
      "state": {
        "status": "empty",
        "observedAt": "2026-10-04T00:32:39.094Z",
        "message": "No product metrics have been configured."
      },
      "refresh": {
        "intervalSeconds": 60,
        "timeoutSeconds": 10,
        "maxAgeSeconds": 120,
        "staleWhileRevalidateSeconds": 120
      },
      "configuration": {
        "allowMultipleInstances": false,
        "fields": [],
        "defaults": {}
      },
      "drilldowns": [
        {
          "id": "open-app",
          "label": "Open app",
          "href": "/"
        }
      ],
      "controls": [],
      "metrics": [],
      "localization": {
        "locale": "en",
        "titleKey": "app.widget.title"
      },
      "accessibility": {
        "label": "Nurture"
      },
      "contribution": {
        "summary": "Open the application to begin.",
        "identity": {
          "iconSource": "catalog"
        },
        "workspaceSelector": {
          "mode": "none",
          "resourceType": "organization",
          "label": "Organization",
          "supportsMultiple": false
        },
        "metricDefinitions": [
          {
            "key": "items",
            "label": "Items",
            "description": "Product records once configured by the application.",
            "unit": "count",
            "semantic": "gauge",
            "aggregation": "last"
          }
        ],
        "seriesDefinitions": [],
        "dimensions": [],
        "lifecycleStages": [],
        "events": [],
        "datasets": [
          {
            "id": "overview",
            "label": "Overview",
            "description": "Product overview awaiting application data.",
            "grain": "organization",
            "metricKeys": [
              "items"
            ],
            "seriesKeys": [],
            "dimensionKeys": [],
            "eventKeys": [],
            "actionIds": []
          }
        ],
        "compatibleVisualizations": [
          "number"
        ],
        "defaultVisualization": "number"
      },
      "appId": "app_topolo_nurture",
      "serviceName": "Nurture",
      "lastUpdated": "2026-10-04T00:32:39.094Z"
    }
  ]
}

HTTP 200. Validate the response against the Topolo widget output schema.

Another supported request

Actual Nurture Worker handler and widget builder; runtime identity, credential verification and failure injection are simulated. No live authorization is established.

Input · payload.json:

{}

CLI:

topolo actions validate app_topolo_nurture.widget.get --data @payload.json --json
topolo actions plan app_topolo_nurture.widget.get --data @payload.json --json
topolo actions call app_topolo_nurture.widget.get --data @payload.json --json

MCP tool and arguments:

{
  "tool": "topolo_read_action",
  "arguments": {
    "actionId": "app_topolo_nurture.widget.get",
    "input": {}
  }
}

Captured local response · HTTP 200:

{
  "success": true,
  "contractVersion": "3.0.0",
  "appId": "app_topolo_nurture",
  "serviceName": "Nurture",
  "generatedAt": "2026-10-04T00:32:39.092Z",
  "widgets": [
    {
      "id": "app.overview",
      "version": "3.0.0",
      "type": "stats",
      "presentation": {
        "title": "Nurture",
        "contexts": [
          "organization"
        ],
        "supportedSizes": [
          "compact",
          "medium"
        ],
        "defaultSize": "medium"
      },
      "resource": {
        "resourceType": "organization",
        "requiredPermissions": [
          "workspace:read"
        ]
      },
      "state": {
        "status": "empty",
        "observedAt": "2026-10-04T00:32:39.092Z",
        "message": "No product metrics have been configured."
      },
      "refresh": {
        "intervalSeconds": 60,
        "timeoutSeconds": 10,
        "maxAgeSeconds": 120,
        "staleWhileRevalidateSeconds": 120
      },
      "configuration": {
        "allowMultipleInstances": false,
        "fields": [],
        "defaults": {}
      },
      "drilldowns": [
        {
          "id": "open-app",
          "label": "Open app",
          "href": "/"
        }
      ],
      "controls": [],
      "metrics": [],
      "localization": {
        "locale": "en",
        "titleKey": "app.widget.title"
      },
      "accessibility": {
        "label": "Nurture"
      },
      "contribution": {
        "summary": "Open the application to begin.",
        "identity": {
          "iconSource": "catalog"
        },
        "workspaceSelector": {
          "mode": "none",
          "resourceType": "organization",
          "label": "Organization",
          "supportsMultiple": false
        },
        "metricDefinitions": [
          {
            "key": "items",
            "label": "Items",
            "description": "Product records once configured by the application.",
            "unit": "count",
            "semantic": "gauge",
            "aggregation": "last"
          }
        ],
        "seriesDefinitions": [],
        "dimensions": [],
        "lifecycleStages": [],
        "events": [],
        "datasets": [
          {
            "id": "overview",
            "label": "Overview",
            "description": "Product overview awaiting application data.",
            "grain": "organization",
            "metricKeys": [
              "items"
            ],
            "seriesKeys": [],
            "dimensionKeys": [],
            "eventKeys": [],
            "actionIds": []
          }
        ],
        "compatibleVisualizations": [
          "number"
        ],
        "defaultVisualization": "number"
      },
      "appId": "app_topolo_nurture",
      "serviceName": "Nurture",
      "lastUpdated": "2026-10-04T00:32:39.092Z"
    }
  ]
}

HTTP 200. Validate the response against the Topolo widget output schema.

Refused request · unauthorized

Actual Nurture Worker handler and widget builder; runtime identity, credential verification and failure injection are simulated. No live authorization is established.

Input · payload.json:

{}

CLI:

topolo actions validate app_topolo_nurture.widget.get --data @payload.json --json
topolo actions plan app_topolo_nurture.widget.get --data @payload.json --json

Captured local response · HTTP 401:

{
  "error": "unauthorized"
}

HTTP 401. Preserve the refusal details and do not claim success.

Verify the result

  • Validate the response against the Topolo widget output schema.

Errors and recovery

  • csrf_origin_rejected (HTTP 403): Use the trusted first-party origin for cookie-authenticated requests. Preserve the exact Auth error for other credential failures.

Auth or gateway failures may precede this handler. Preserve the exact response shape, error string/code, request id and credential context; no synthetic fixture establishes live credential access.

Recovery boundary

This action does not change service state.

Evidence

Actual dispatcher and migration-created SQLite or Worker handlers; identity/workspace and external service dependencies are simulated. Fixture identifiers and timestamps are synthetic. These responses establish no live authorization, paid generation, credential provisioning or message delivery. Test scenario and capture digests are retained with each fixture.