insights.summarize
V1.1 · post-MVPNarrative summarization on demand. (Preview — V1.1+.)
Description
Per ADR-0021 §read-API Family D. Stub-ships at MVP.
Input schema
| Field | Type | Required | Description |
|---|---|---|---|
counterparty_id | string | no | Optional counterparty scope. |
time_window | { since: string; until: string } | no | Optional time window. |
topic | string | no | Optional topic. |
Output shape
typescript
{ ok: false; error: "feature_not_available"; details: { adr: "ADR-0021"; section: "Family D — Patterns / Insights"; shipping: "V1.1+" } }Example call
JSON-RPC tools/call request body (omit the JSON-RPC envelope when using an SDK; the SDK adds it for you):
jsontools/call params
{ "name": "insights.summarize", "arguments": { "counterparty_id": "entity_01HXSARAH" } }Example response
Tool results are always wrapped as content[0].text with a stringified JSON body. The shape below is what you get back from JSON.parse(result.content[0].text):
jsonparsed result body
{ "ok": false, "error": "feature_not_available", "details": { "adr": "ADR-0021", "section": "Family D — Patterns / Insights", "shipping": "V1.1+" } }Errors this tool can return
| Code | Meaning |
|---|---|
unauthorized | Missing or invalid bearer token. |
feature_not_available | The tool is registered but the underlying capability is not wired in this build. |
See the full error catalog for resolution steps on each code, plus the standard transport-layer responses (401, 429).