News List

News List Canvas

Use news-list with scenario search when the user asks to search, browse, compare, highlight, or explain recent financial news. The FTShare endpoint only covers the current year and latest 15 days; do not imply a broader archive.

canvas_spawn({
  kind: 'news-list',
  scenario: 'search',
  config: JSON.stringify({
    query: '人工智能',
    limit: 20,
  }),
});

Optional startTime and endTime accept ISO 8601 values. Keep limit between 1 and 50. The renderer retrieves news itself, so never invent or inline article rows.

AI Highlights

After the initial search, read compact result metadata with canvas_state using state key news. Choose articles by their returned newsId, then update the same Canvas ID with the complete search config and a highlights array:

canvas_update({
  id,
  config: JSON.stringify({
    query: '人工智能',
    limit: 20,
    highlights: [
      {
        newsId: '606732245083885569',
        reason: 'Directly addresses AI accountability',
      },
    ],
  }),
});

Always pass newsId as a string because FTShare IDs exceed JavaScript's safe integer range. Keep reasons short and grounded in the returned title, source, time, summary, and relevance score. When only highlights change, the renderer updates them without fetching the same search again.

Interaction

• The top search field is clickable and supports direct user searches inside the renderer.
• News results are bordered cards; the list supports mouse-wheel and keyboard scrolling.
• Clicking a card selects it. Clicking Explain selected or pressing Enter queues an explanation request in the owning AI session. Clicking the underlined URL opens the original article.
• a attaches selected news as context, c clears selection, and o opens the current URL.

When canvas_wait is available, wait with this Canvas ID for context or explanation actions. Otherwise rely on the host's normal Canvas event delivery.