{"id":46610,"plugin_id":"plugin_asdk_app_6a9d533d1bd08191af522be547ae1e97","kind":"skill","collection_source":"plugin_package","comparison_source":null,"observed_at":"2026-10-24T13:30:30.223Z","digest":"5dd782f7feb20f2c95ec4f9f3f92c273892f12ab486f7740f1c546d4fd26d216","against":null,"payload":{"description":"Realtime context package for one entity — identity, recent high-relevance headlines, 14-day sentiment, and top co-mentions. Operation is retrieve_entity.","included_files":[],"name":"entity-retrieval","skill_md_contents":"---\nname: entity-retrieval\ndescription: Realtime context package for one entity — identity, recent high-relevance headlines, 14-day sentiment, and top co-mentions. Operation is retrieve_entity.\n---\n\n# Entity Retrieval\n\n`retrieve_entity` returns a realtime context package for one Ultralayer entity. Single required param: `entity`. No time window, no `top_k` — the package shape is fixed.\n\n| Operation | Role |\n|-----------|------|\n| `retrieve_entity` | Realtime dossier for one entity |\n\n---\n\n## When to use\n\n**Use `retrieve_entity` when you need to:**\n- Bootstrap a company / person / commodity / country / institution briefing\n- Read 14-day mention sentiment without hand-rolling Wire aggregation\n- Discover who co-moves in the news with the target\n\n**Do not use when you need:**\n- A filtered multi-entity news firehose → Wire\n- Open-web research (article body, quotes, filings, prices) → your native web search tool\n- Point-in-time / as-of packages → not supported (realtime only)\n- Sparse / quiet entities → fails with `insufficient_entity_activity`\n\n---\n\n## Use cases\n\n**Company dossier seed** — One call for recent headlines, 14-day sentiment, and who else is in the story.\n```json\n{ \"entity\": \"Tesla, Inc.\" }\n```\n\n**Person → affiliated universe** — See which companies and projects dominate the news around a person.\n```json\n{ \"entity\": \"Elon Musk\" }\n```\nFollow co-mentions (`Tesla, Inc.`, `SpaceX`, `xAI`) with more `retrieve_entity` or Wire.\n\n**Commodity / macro driver** — Brief a commodity and discover the geopolitics and related markets moving with it.\n```json\n{ \"entity\": \"Brent Crude\" }\n```\nUse co-mentions (Iran, Hormuz, WTI) to choose Wire entity filters and semantic queries.\n\n**Institution** — Quick context pack for a policy body that drives markets.\n```json\n{ \"entity\": \"Federal Reserve\" }\n```\n\n**Country** — High-volume national tape: recent prints, sentiment trend, and co-moving names.\n```json\n{ \"entity\": \"Iran\" }\n```\n\n---\n\n## What you get back\n\n| Section | Notes |\n|---------|-------|\n| `entity` | `entity_id`, `canonical_name`, `entity_type` |\n| `recent_wire_items` | Up to 5 teasers; novelty `new\\|update\\|correction`; entity is `primary` or `significant`; includes `wire_id` for storyline |\n| `sentiment_chart` | Exactly 14 UTC calendar-day bars, oldest → newest. Relevance-weighted mean ∈ [-1, 1], weighted std, `mention_count`. Empty days stay with `weighted_sentiment: null`. Current day is a partial bar. |\n| `co_mentions` | Top peers with `share` (fraction of recent high-relevance wire that also mentions them at primary/significant) |\n\nRequires sufficient recent wire activity; sparse entities return 422 `insufficient_entity_activity`.\n\n---\n\n## How to read each section\n\n**Recent wire items.** Decision-grade headlines. Duplicates stripped. Use `wire_id` → `wire_storyline` for story evolution.\n\n**Sentiment chart.** `end_timestamp` is the exclusive end of the UTC day (bar for 2026-07-23 ends at `2026-07-24T00:00:00Z`). Interpret with `mention_count` and `weighted_std` — one-mention days and high std are noisy. Mega-entities (countries) show flatter averages.\n\n**Co-mentions.** “Who shares the recent high-relevance tape?” Near-duplicate registry rows often both appear (`SpaceX` + `Space Exploration Technologies Corp.`, `United States` + `United States of America`). Collapse when briefing.\n\nWorks well for `COMPANY`, `PERSON`, `COMMODITY`, `COUNTRY`, `GOVERNMENT`. Products (e.g. `\"ChatGPT\"`) often fail the activity gate.\n\n---\n\n## Workflow\n\n| User intent | Approach |\n|-------------|----------|\n| “Brief me on X” | Package → recent wires + sentiment turn + co-mentions |\n| “Who is moving with oil / AI / this CEO?” | Read `co_mentions`; optionally package those peers |\n| “Is tape tone improving?” | Walk `sentiment_chart` with mention_count/std |\n| “Watch every mention going forward” | Use Wire (and alerts) |\n\n1. Call `retrieve_entity`. Brief from: recent wires → sentiment turn → co-mentions.\n2. Hand off: Wire for monitoring/storylines; your native web search tool for open-web research.\n\n---\n\n## Limitations\n\n- Realtime only — no as-of.\n- One entity per call.\n- Activity gate hides quiet names.\n- Public input is name only (passing `entity_id` as a string does not work).\n- Recent strip is fixed at 5 non-duplicate high-relevance items.\n- Co-mentions surface unmerged duplicate identities.\n- Not a substitute for Wire novelty clustering or semantic passage retrieval.\n\n---\n\n## FAQ\n\n**Q: Why do SpaceX and “Space Exploration Technologies Corp.” both show as co-mentions?**  \nA: Incomplete entity merges. Treat as one org in the narrative unless you need registry fidelity.\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}