Pull, count, or orient over source-cited Manifests. For recurring watches prefer beacon_id with an explicit lookback, and dedupe by manifest_id. delivery_delta=true can use a stream/channel-only Beacon as scope when enabled. stream_ids, home_domains, and source_channel_ids are INTERSECTED; DERIVE source_channel_ids from details/search when unsure. 17-digit Synorb ID values: pass them as JSON strings, never a number. USE THIS WHEN: the user needs evidence/content with date/entity/topic/source filters. DO NOT USE THIS WHEN: the user only asks inventory, usage, or source availability. OUTPUT: write a briefing (reasoning-v1) from claims and supporting_quotes, not from headlines; keep each first-party link inline and end with a source index. briefing.scaffold lists the ranked items, Claims with exact figures, groups and a recipe for the opening. The server makes no model call when you read.
View input schema
{
"type": "object",
"properties": {
"query": {
"default": "",
"description": "Optional intent for broad planning.",
"title": "Query",
"type": "string"
},
"stream_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Single Stream ID.",
"title": "Stream Id"
},
"stream_ids": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Stream IDs to query.",
"title": "Stream Ids"
},
"home_domains": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Domains, or ['all'] with filters.",
"title": "Home Domains"
},
"cross_domains": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Up to 3 secondary domains.",
"title": "Cross Domains"
},
"cross_domain_logic": {
"default": "or",
"description": "'or' for any, 'and' for all.",
"title": "Cross Domain Logic",
"type": "string"
},
"published_date_from": {
"default": "",
"description": "Start date, YYYY-MM-DD or relative.",
"title": "Published Date From",
"type": "string"
},
"published_date_to": {
"default": "",
"description": "End date, YYYY-MM-DD or relative.",
"title": "Published Date To",
"type": "string"
},
"days": {
"default": 0,
"description": "Relative lookback days.",
"title": "Days",
"type": "integer"
},
"tag_ids": {
"default": "",
"description": "Tag IDs; comma string/list, combined by tag_logic.",
"title": "Tag Ids",
"type": "string"
},
"tag_names": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Human-readable topic/entity filters.",
"title": "Tag Names"
},
"tag_type": {
"default": "",
"description": "Tag type, e.g. organization/topic.",
"title": "Tag Type",
"type": "string"
},
"subtype": {
"default": "",
"description": "Optional subtype within tag_type.",
"title": "Subtype",
"type": "string"
},
"tag_logic": {
"default": "or",
"description": "'and' co-mentions, 'or' any tag.",
"title": "Tag Logic",
"type": "string"
},
"media_format": {
"default": "",
"description": "Content surface, e.g. text/audio/data.",
"title": "Media Format",
"type": "string"
},
"source_class": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Authorship/source class filter.",
"title": "Source Class"
},
"evidence_type": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Evidence/source type filter.",
"title": "Evidence Type"
},
"ticker": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Exact public-company ticker(s).",
"title": "Ticker"
},
"isin": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Exact equity ISIN(s).",
"title": "Isin"
},
"sec_form_type": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Exact SEC form type.",
"title": "Sec Form Type"
},
"sec_form_variant": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Exact SEC form variant(s), e.g. '8-K/A'.",
"title": "Sec Form Variant"
},
"sec_cik": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Exact SEC CIK(s); normalized to ten digits.",
"title": "Sec Cik"
},
"sec_ticker": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Exact ticker(s) stored on SEC filings. Distinct from the broader company ticker scope.",
"title": "Sec Ticker"
},
"sec_item_code": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Exact SEC 8-K item code(s), e.g. '5.02'.",
"title": "Sec Item Code"
},
"sec_item_subsection": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Exact SEC 8-K item subsection(s), e.g. '5.02(e)'.",
"title": "Sec Item Subsection"
},
"sec_exhibit_type": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Exact SEC exhibit type(s), e.g. 'EX-10.1'.",
"title": "Sec Exhibit Type"
},
"source_channel_ids": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Exact source-channel IDs.",
"title": "Source Channel Ids"
},
"source_channel_names": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Exact source-channel names/slugs.",
"title": "Source Channel Names"
},
"significance": {
"default": "",
"description": "Optional significance filter.",
"title": "Significance",
"type": "string"
},
"page": {
"default": 0,
"description": "Zero-based page index.",
"title": "Page",
"type": "integer"
},
"page_size": {
"default": 10,
"description": "Manifests per page.",
"title": "Page Size",
"type": "integer"
},
"target_count": {
"default": 10,
"description": "Desired on-topic Manifests.",
"title": "Target Count",
"type": "integer"
},
"snapshot_token": {
"default": "",
"description": "Opaque subject-bound continuation token returned by a prior exact synorb-manifests page.",
"title": "Snapshot Token",
"type": "string"
},
"scan_cursor": {
"default": "",
"description": "Opaque source-mix continuation from pagination.next_scan_cursor. Not snapshot_token; totals and empty-population claims stay unknown.",
"title": "Scan Cursor",
"type": "string"
},
"compact": {
"default": false,
"description": "Scan tier: find items, then read in full.",
"title": "Compact",
"type": "boolean"
},
"markdown_version": {
"default": "1",
"description": "'2' adds Brief body_markdown_v2 (TL;DR, Key Facts, Why It Matters, Timeline, Unresolved).",
"title": "Markdown Version",
"type": "string"
},
"auto_plan": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "Allow server-side broad-query slicing.",
"title": "Auto Plan"
},
"exclude_tag_names": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Drop matching tag names.",
"title": "Exclude Tag Names"
},
"exclude_tag_ids": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Drop matching tag IDs.",
"title": "Exclude Tag Ids"
},
"exclude_query_terms": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Best-effort: drops manifests whose headline/summary/source labels contain any term.",
"title": "Exclude Query Terms"
},
"exclude_source_channel_ids": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Drop matching source-channel IDs.",
"title": "Exclude Source Channel Ids"
},
"exclude_home_domains": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Drop matching home domains.",
"title": "Exclude Home Domains"
},
"session_id": {
"default": "",
"description": "Stable client session UUID.",
"title": "Session Id",
"type": "string"
},
"beacon_id": {
"default": "",
"description": "Public Beacon ID (synorb_bcn_...).",
"title": "Beacon Id",
"type": "string"
},
"lookback_hours": {
"default": 0,
"description": "Relative date window in hours; works for one-off or Beacon execution.",
"title": "Lookback Hours",
"type": "integer"
},
"broaden_sources": {
"default": false,
"description": "With beacon_id: let request scope REPLACE the Beacon's saved scope. Default false fails closed.",
"title": "Broaden Sources",
"type": "boolean"
},
"mode": {
"default": "default",
"description": "default, count, orient, or plan.",
"title": "Mode",
"type": "string"
},
"verbosity": {
"default": "standard",
"description": "minimal, standard, or verbose.",
"title": "Verbosity",
"type": "string"
},
"plan_token": {
"default": "",
"description": "Signed token from mode='plan'; binds default execution to its query and catalog generation.",
"title": "Plan Token",
"type": "string"
},
"accept_partial_plan": {
"default": false,
"description": "Accept a partial mode='plan' result for default execution; never inferred.",
"title": "Accept Partial Plan",
"type": "boolean"
},
"relative_to": {
"default": "",
"description": "Anchor relative windows to the availability ceiling or wall_clock; default is the entitlement ceiling.",
"title": "Relative To",
"type": "string"
},
"checkpoint": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Opaque signed checkpoint from a prior delta call: the checkpoint object, or its next_page_cursor/commit_cursor string. Send back whichever it gave you.",
"title": "Checkpoint"
},
"delivery_delta": {
"default": false,
"description": "Incremental sync over the routed-at delivery stream, paged by checkpoint. Narrower than an ordinary call: a Manifest enters it only once routed, so an authoritative zero means nothing was routed in the window, not that nothing matched. Not a substitute for an ordinary count. A stream/channel-only Beacon may scope it (beacon_id, no lookback_hours); refusals name unsupported_fields.",
"title": "Delivery Delta",
"type": "boolean"
},
"allocation_policy": {
"default": "",
"description": "'global' (legacy) or 'balanced' (needs a strict family plan).",
"title": "Allocation Policy",
"type": "string"
},
"required_families": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Deprecated; use required_surfaces. If both are given they must agree after alias translation (business_podcasts -> podcasts).",
"title": "Required Families"
},
"required_surfaces": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Ordered surface set required by a strict balanced plan. Surfaces not plan-resolvable fail closed with surface_not_yet_queryable.",
"title": "Required Surfaces"
},
"response_profile": {
"default": "full",
"description": "'full' (default) or 'slim'. Slim is a scan tier: it drops source metadata and citation authority and adds a finding_aid. Never changes which Manifests are returned or billed.",
"title": "Response Profile",
"type": "string"
},
"include_diagnostics": {
"default": false,
"description": "False (default) omits the large operator/proof blocks regardless of response_profile. True includes them, e.g. to debug a coverage/absence decision. Never changes which manifests are returned or billed.",
"title": "Include Diagnostics",
"type": "boolean"
},
"api_key": {
"default": "",
"description": "Synorb key; only if the Authorization header is not set. Tool arguments may be logged.",
"title": "Api Key",
"type": "string"
},
"profile": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "Reader profile: role, goals, watchlist, exclusions.",
"title": "Profile"
}
},
"required": [],
"title": "synorb_manifestsArguments"
}