{"id":20506,"plugin_id":"plugins_6aa4f7db79848191a81e4048990545ef","kind":"skill","collection_source":null,"comparison_source":null,"observed_at":"2026-09-30T23:16:17.525Z","digest":"0854daec0bd1713f6fe3e80c658fd24e589b1332548048f428aa086bc6528458","against":null,"payload":{"description":"Parse Sugra API payloads over HTTPS or MCP, keep source attribution, and tell observation time from request time. Use when reading a response, citing a figure, or shaping a large payload.","included_files":[{"relative_path":"agents/openai.yaml","size_in_bytes":241}],"name":"envelope-and-attribution","skill_md_contents":"---\nname: envelope-and-attribution\ndescription: Parse Sugra API payloads over HTTPS or MCP, keep source attribution, and tell observation time from request time. Use when reading a response, citing a figure, or shaping a large payload.\nlicense: MIT\n---\n\n# Envelope and attribution\n\nThe API is LLM-friendly: one JSON envelope on every direction. Envelope detail also lives on https://docs.sugra.ai.\n\nMost responses:\n\n```json\n{\n  \"data\": {},\n  \"meta\": {\n    \"endpoint\": \"/api/v1/...\",\n    \"data_time\": \"2026-06-12T19:30:00Z\",\n    \"response_time\": \"2026-06-12T19:30:01Z\",\n    \"provider\": \"Sugra API\"\n  }\n}\n```\n\nSome payloads are envelope-less (a flat object with `meta` or `_meta` on the same record). Provenance keys still apply.\n\nHTTP: this JSON body plus `X-RateLimit-*` headers.\n\nMCP: `call_endpoint` / `fetch_data` return the same payload (a top-level array is wrapped as `{data: ...}`). Shaping args `limit`, `fields`, `include_raw` apply to `data`. `meta.shaped` reports `fields_applied`, `fields_unmatched`, `limit_applied`. `limit` bounds only the top-level list.\n\n## Time\n\n`meta.data_time` is the observation or publication clock of the data, not the HTTP response time. A row-level `as_of` is the period the figure is about. Quote both when they differ. Do not describe a delayed series as a live tick.\n\n## Attribution\n\nEvery figure needs a source and an as-of. Read them from `meta` / `_meta`. Live list: https://sugra.ai/sources (MCP resource `sugra://attribution`).\n\n- Sovereign, intergovernmental, and academic sources are named openly (for example FRED, IMF, ECB, NOAA, World Bank, SEC EDGAR).\n- Commercial upstreams appear under Sugra-branded wrappers (Sugra Finance, Sugra News, Sugra Crypto, Sugra Forex, Sugra Weather). Do not substitute a commercial vendor name.\n\nThis is data presentation, not investment, legal, or compliance advice. Screening tools return a signal, not a determination.\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}