commodity.worldmonitor.app

{
  "name": "openCountryBrief",
  "kind": "act",
  "impl": "imperative",
  "description": "Open the intelligence brief panel for a country by ISO 3166-1 alpha-2 code (e.g. \"DE\", \"IR\"). Routes the user to the country deep-dive view; the brief itself is fetched by the same path a click would take. This can consume daily briefing quota. To only pan the map, use focus_country.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "iso2": {
        "type": "string",
        "description": "ISO 3166-1 alpha-2 country code, uppercase.",
        "pattern": "^[A-Z]{2}$"
      }
    },
    "required": [
      "iso2"
    ],
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}

{
  "name": "openSearch",
  "kind": "act",
  "impl": "imperative",
  "description": "Open the global search command palette so the user can find countries, signals, alerts, and other entities tracked by World Monitor.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}

{
  "name": "get_dashboard_context",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read a bounded snapshot of the visible dashboard: active variant, map view, center, zoom, map mode (2d or 3d), time range, enabled layers, and mounted or enabled panel IDs.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}

{
  "name": "list_map_layers",
  "kind": "answer",
  "impl": "imperative",
  "description": "Page the canonical map-layer catalog, including disabled layers. Omit monitor for every registered layer; world lists only that variant. Each result has the stable ID, label, enabled state, monitor availability, renderer compatibility, entitlement, and a reason when the current page cannot enable it with set_map_layers. Does not load map datasets.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "monitor": {
        "type": "string",
        "description": "Omit for every non-sunset registered layer; world lists only that variant.",
        "enum": [
          "world",
          "tech",
          "finance",
          "commodity",
          "energy",
          "happy"
        ]
      },
      "renderer": {
        "type": "string",
        "description": "Optional 2d or 3d renderer compatibility filter.",
        "enum": [
          "2d",
          "3d"
        ]
      },
      "state": {
        "type": "string",
        "description": "Filter to enabled layers, or layers the current page can enable.",
        "enum": [
          "enabled",
          "available"
        ]
      },
      "cursor": {
        "type": "string",
        "description": "Previous page last layer ID; reuse only with the same filters.",
        "minLength": 1,
        "maxLength": 30,
        "pattern": "^[a-z][A-Za-z0-9_-]*$"
      },
      "limit": {
        "type": "integer",
        "description": "Page size from 1 to 8.",
        "minimum": 1,
        "maximum": 8,
        "default": 6
      }
    },
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}

{
  "name": "list_dashboard_panels",
  "kind": "answer",
  "impl": "imperative",
  "description": "Page the canonical dashboard panel catalog for this tab, including disabled and unmounted panels. Optional variant, category, enabled, and available filters. Follow nextCursor until hasMore is false. Does not return panel data or enable panels. Gated panels include a stable unavailableReason.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "variant": {
        "type": "string",
        "description": "Monitor variant to list. Omit to include every canonical panel ID.",
        "enum": [
          "full",
          "tech",
          "finance",
          "happy",
          "commodity",
          "energy"
        ]
      },
      "category": {
        "type": "string",
        "description": "Settings category key, such as core or marketsFinance.",
        "enum": [
          "core",
          "intelligence",
          "correlation",
          "regionalNews",
          "marketsFinance",
          "topical",
          "dataTracking",
          "techAi",
          "startupsVc",
          "securityPolicy",
          "techMarkets",
          "finMarkets",
          "fixedIncomeFx",
          "finCommodities",
          "cryptoDigital",
          "centralBanksEcon",
          "dealsInstitutional",
          "gulfMena",
          "commodityPrices",
          "miningIndustry",
          "commodityEcon",
          "happyNews",
          "happyPlanet",
          "other"
        ]
      },
      "enabled": {
        "type": "boolean",
        "description": "If set, keep panels whose enabled state matches."
      },
      "available": {
        "type": "boolean",
        "description": "If set, keep panels the current session can open."
      },
      "cursor": {
        "type": "string",
        "description": "Catalog cursor from the previous page nextCursor.",
        "minLength": 1,
        "maxLength": 96,
        "pattern": "^[A-Za-z0-9][A-Za-z0-9@_-]*$"
      },
      "limit": {
        "type": "integer",
        "description": "Maximum panels in this page, from 1 to 8.",
        "minimum": 1,
        "maximum": 8,
        "default": 6
      }
    },
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}

{
  "name": "switch_monitor",
  "kind": "act",
  "impl": "imperative",
  "description": "Switch the visible dashboard to World (full), Tech (tech), Finance (finance), Commodity (commodity), Energy (energy), or Good News (happy) through the header variant switcher. Use those stable keys, not display labels. Returns the selected destination and effective dashboard state.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "monitor": {
        "type": "string",
        "description": "Stable monitor key: full, tech, finance, commodity, energy, or happy.",
        "enum": [
          "full",
          "tech",
          "finance",
          "happy",
          "commodity",
          "energy"
        ]
      }
    },
    "required": [
      "monitor"
    ],
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}

{
  "name": "open_settings",
  "kind": "act",
  "impl": "imperative",
  "description": "Open the dashboard settings overlay through the same header gear path a person uses. Opening settings does not change its contents. Returns the selected destination and effective dashboard state.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}

{
  "name": "open_alerts",
  "kind": "act",
  "impl": "imperative",
  "description": "Open the alerts notifications tab through the same settings path the visible UI uses. Opening alerts does not change their contents. Unavailable dashboards return a stable reason without account details.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}

{
  "name": "open_dashboard_panel",
  "kind": "act",
  "impl": "imperative",
  "description": "Open and scroll to an already-live, currently enabled dashboard panel through the same entitlement-aware control path used by World Monitor. For the commodities panel, tab can also select commodities, physical, fx, or xau through the same tab path used by a person. Disabled panels return panel_disabled. Use set_panel_enabled to change whether a catalog panel is enabled; this tool does not enable panels itself.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "panelId": {
        "type": "string",
        "description": "Dashboard panel ID, such as \"markets\" or \"strategic-risk\".",
        "minLength": 1,
        "maxLength": 96,
        "pattern": "^[A-Za-z0-9][A-Za-z0-9@_-]*$"
      },
      "tab": {
        "type": "string",
        "enum": [
          "commodities",
          "physical",
          "fx",
          "xau"
        ],
        "description": "Optional commodities-panel subtab. Other panels reject this field."
      }
    },
    "required": [
      "panelId"
    ],
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}

{
  "name": "set_panel_enabled",
  "kind": "act",
  "impl": "imperative",
  "description": "Enable or disable a dashboard panel by its stable ID through the same settings path a person uses. Returns the requested state, effective state, and whether anything changed. Enabling unknown, incompatible, unentitled, or free-tier-capped panels is denied; disabling a live catalog panel still succeeds. Requires target-side cancellation because it persists dashboard settings.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "panelId": {
        "type": "string",
        "description": "Dashboard panel ID, such as \"markets\" or \"giving\".",
        "minLength": 1,
        "maxLength": 96,
        "pattern": "^[a-zA-Z0-9][a-zA-Z0-9@_-]*$"
      },
      "enabled": {
        "type": "boolean",
        "description": "True to enable the panel, false to disable it."
      }
    },
    "required": [
      "panelId",
      "enabled"
    ],
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}

{
  "name": "get_panel_layout",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read the effective dashboard panel layout: stable panel IDs, named regions (sidebar or bottom), order index, collapsed state, and fullscreen state. When panelsTruncated is true, pass nextCursor to continue. Use before collapse, move, or fullscreen tools.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "cursor": {
        "type": "string",
        "description": "Optional panel ID cursor from a previous truncated get_panel_layout page.",
        "minLength": 1,
        "maxLength": 96,
        "pattern": "^[A-Za-z0-9][A-Za-z0-9@_-]*$"
      }
    },
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}

{
  "name": "set_panel_collapsed",
  "kind": "act",
  "impl": "imperative",
  "description": "Collapse or expand a mounted panel by stable ID through the same control and persistence path as the visible collapse button. Idempotent when the state already matches. Requires target-side cancellation because collapsed state persists.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "panelId": {
        "type": "string",
        "description": "Dashboard panel ID from get_panel_layout.",
        "minLength": 1,
        "maxLength": 96,
        "pattern": "^[A-Za-z0-9][A-Za-z0-9@_-]*$"
      },
      "collapsed": {
        "type": "boolean",
        "description": "True to collapse the panel, false to expand it."
      }
    },
    "required": [
      "panelId",
      "collapsed"
    ],
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}

{
  "name": "move_panel",
  "kind": "act",
  "impl": "imperative",
  "description": "Move a mounted panel to a named layout region (sidebar or bottom) at a 0-based index through the same persistence path as keyboard reorder. Do not use pointer coordinates. Requires target-side cancellation because order persists.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "panelId": {
        "type": "string",
        "description": "Dashboard panel ID from get_panel_layout.",
        "minLength": 1,
        "maxLength": 96,
        "pattern": "^[A-Za-z0-9][A-Za-z0-9@_-]*$"
      },
      "region": {
        "type": "string",
        "description": "Target layout region.",
        "enum": [
          "sidebar",
          "bottom"
        ]
      },
      "index": {
        "type": "integer",
        "description": "0-based destination index in the target region after the move.",
        "minimum": 0,
        "maximum": 200
      }
    },
    "required": [
      "panelId",
      "region",
      "index"
    ],
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}

{
  "name": "set_panel_fullscreen",
  "kind": "act",
  "impl": "imperative",
  "description": "Enter or exit panel fullscreen by stable ID through the same visible fullscreen control as Live News and Live Webcams. Idempotent when the state already matches. Session view-state only; it does not persist across reload.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "panelId": {
        "type": "string",
        "description": "Dashboard panel ID from get_panel_layout.",
        "minLength": 1,
        "maxLength": 96,
        "pattern": "^[A-Za-z0-9][A-Za-z0-9@_-]*$"
      },
      "fullscreen": {
        "type": "boolean",
        "description": "True to enter fullscreen, false to exit."
      }
    },
    "required": [
      "panelId",
      "fullscreen"
    ],
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}

{
  "name": "set_map_view",
  "kind": "act",
  "impl": "imperative",
  "description": "Move the visible map to a named world region or a bounded latitude/longitude pair, with an optional zoom level.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "view": {
        "type": "string",
        "description": "Named map region.",
        "enum": [
          "global",
          "america",
          "mena",
          "eu",
          "asia",
          "latam",
          "africa",
          "oceania"
        ]
      },
      "lat": {
        "type": "number",
        "description": "Web Mercator latitude; provide with lon.",
        "minimum": -85.051129,
        "maximum": 85.051129
      },
      "lon": {
        "type": "number",
        "description": "Longitude from -180 to 180; provide with lat.",
        "minimum": -180,
        "maximum": 180
      },
      "zoom": {
        "type": "number",
        "description": "Optional map zoom from 1 to 10.",
        "minimum": 1,
        "maximum": 10
      }
    },
    "oneOf": [
      {
        "properties": {
          "view": {}
        },
        "required": [
          "view"
        ],
        "not": {
          "anyOf": [
            {
              "properties": {
                "lat": {}
              },
              "required": [
                "lat"
              ]
            },
            {
              "properties": {
                "lon": {}
              },
              "required": [
                "lon"
              ]
            }
          ]
        }
      },
      {
        "properties": {
          "lat": {},
          "lon": {}
        },
        "required": [
          "lat",
          "lon"
        ],
        "not": {
          "properties": {
            "view": {}
          },
          "required": [
            "view"
          ]
        }
      }
    ],
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}

{
  "name": "set_map_layers",
  "kind": "act",
  "impl": "imperative",
  "description": "Enable or disable explicit visible map layers through World Monitor’s variant, renderer, and entitlement-aware control path.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "layers": {
        "type": "object",
        "description": "Map layer IDs mapped to true (enable) or false (disable).",
        "minProperties": 1,
        "maxProperties": 10,
        "propertyNames": {
          "type": "string",
          "minLength": 1,
          "maxLength": 30,
          "pattern": "^[a-z][A-Za-z0-9_-]*$"
        },
        "additionalProperties": {
          "type": "boolean"
        }
      }
    },
    "required": [
      "layers"
    ],
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}

{
  "name": "set_time_range",
  "kind": "act",
  "impl": "imperative",
  "description": "Set the visible map time range through the same 1h, 6h, 24h, 48h, 7d, or all control used by the dashboard. Returns the requested and effective range.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "timeRange": {
        "type": "string",
        "description": "Dashboard time-range control value.",
        "enum": [
          "1h",
          "6h",
          "24h",
          "48h",
          "7d",
          "all"
        ]
      }
    },
    "required": [
      "timeRange"
    ],
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}

{
  "name": "focus_country",
  "kind": "act",
  "impl": "imperative",
  "description": "Focus the visible map on a country bounding box by ISO 3166-1 alpha-2 code without opening a country brief or consuming briefing quota.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "iso2": {
        "type": "string",
        "description": "ISO 3166-1 alpha-2 country code, uppercase.",
        "pattern": "^[A-Z]{2}$"
      }
    },
    "required": [
      "iso2"
    ],
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}

{
  "name": "set_map_mode",
  "kind": "act",
  "impl": "imperative",
  "description": "Switch the visible map between 2d (flat) and 3d (globe) through the same dashboard control, including renderer layer compatibility.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "mode": {
        "type": "string",
        "description": "Visible map mode: 2d or 3d.",
        "enum": [
          "2d",
          "3d"
        ]
      }
    },
    "required": [
      "mode"
    ],
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}

{
  "name": "search_dashboard",
  "kind": "answer",
  "impl": "imperative",
  "description": "Search the current World Monitor country, signal, map, panel, finance, and action indexes without opening the command palette or changing the dashboard. executable is true only when live dashboard state and this host’s cancellation support both allow the bound effect.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Search text. It is never included in analytics.",
        "minLength": 1,
        "maxLength": 160
      },
      "scope": {
        "type": "string",
        "description": "Optional dashboard surface to search.",
        "enum": [
          "all",
          "signals",
          "map",
          "panels",
          "actions"
        ],
        "default": "all"
      },
      "limit": {
        "type": "integer",
        "description": "Maximum number of concise results to return.",
        "minimum": 1,
        "maximum": 10,
        "default": 8
      }
    },
    "required": [
      "query"
    ],
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}

{
  "name": "open_search_result",
  "kind": "act",
  "impl": "imperative",
  "description": "Open one result previously issued by search_dashboard after rechecking that it is still live, allowed, compatible, and entitled. Cancellation uses the bound effect class, which callers cannot supply or downgrade. View-state results run without a target-side AbortSignal; persistent, quota-consuming, and external-navigation results require one and may return target_cancellation_unsupported.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "resultKey": {
        "type": "string",
        "description": "Opaque key returned by search_dashboard on this page.",
        "pattern": "^sr_[a-f0-9]{32}$"
      }
    },
    "required": [
      "resultKey"
    ],
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}

{
  "name": "list_dashboard_tabs",
  "kind": "answer",
  "impl": "imperative",
  "description": "List dashboard tabs as named persistent panel workspaces. Returns each tab id, name, active flag, plus whether another tab can be created and why add is locked. Use tab ids, not display names, for select, rename, and delete. When tabsTruncated is true, tabCount is the total persisted workspace count and this page omitted later tabs; pass nextCursor to list the rest. Call list_dashboard_tabs again after mutations.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "cursor": {
        "type": "string",
        "minLength": 1,
        "maxLength": 64,
        "pattern": "^tab-[a-z0-9]+-[a-z0-9]+$",
        "description": "Inclusive start tab id from a previous nextCursor. Omit to start at the first workspace."
      }
    },
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}

{
  "name": "select_dashboard_tab",
  "kind": "act",
  "impl": "imperative",
  "description": "Activate a dashboard tab by stable tab id from list_dashboard_tabs. Selecting the already-active tab is a successful no-op. Unavailable without target-side cancellation because tab changes persist to worldmonitor-tabs-v1 and the live panel workspace (same class as openCountryBrief/set_map_layers).",
  "inputSchema": {
    "type": "object",
    "properties": {
      "tabId": {
        "type": "string",
        "minLength": 1,
        "maxLength": 64,
        "pattern": "^tab-[a-z0-9]+-[a-z0-9]+$",
        "description": "Stable dashboard tab id from list_dashboard_tabs."
      }
    },
    "required": [
      "tabId"
    ],
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}

{
  "name": "create_dashboard_tab",
  "kind": "act",
  "impl": "imperative",
  "description": "Create a dashboard tab as a named persistent panel workspace, then activate it. Omit name to use the dashboard default. Creating a tab whose trimmed name already exists returns that tab without duplicating it. Honors the same tab cap and entitlement lock as the dashboard tab bar. Unavailable without target-side cancellation because tab changes persist to worldmonitor-tabs-v1 and the live panel workspace (same class as openCountryBrief/set_map_layers).",
  "inputSchema": {
    "type": "object",
    "properties": {
      "name": {
        "type": "string",
        "minLength": 1,
        "maxLength": 40,
        "description": "Optional display name. Omit to use the dashboard default."
      }
    },
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}

{
  "name": "rename_dashboard_tab",
  "kind": "act",
  "impl": "imperative",
  "description": "Rename a dashboard tab by stable tab id. Names are trimmed and capped at 40 characters, matching the dashboard tab bar. Renaming to the current name is a successful no-op. Unavailable without target-side cancellation because tab changes persist to worldmonitor-tabs-v1 and the live panel workspace (same class as openCountryBrief/set_map_layers).",
  "inputSchema": {
    "type": "object",
    "properties": {
      "tabId": {
        "type": "string",
        "minLength": 1,
        "maxLength": 64,
        "pattern": "^tab-[a-z0-9]+-[a-z0-9]+$",
        "description": "Stable dashboard tab id from list_dashboard_tabs."
      },
      "name": {
        "type": "string",
        "minLength": 1,
        "maxLength": 40,
        "description": "New display name for the tab."
      }
    },
    "required": [
      "tabId",
      "name"
    ],
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}

{
  "name": "delete_dashboard_tab",
  "kind": "transact",
  "impl": "imperative",
  "description": "Delete a dashboard tab by stable tab id. Requires confirm=true. Refuses to delete the last remaining tab. Unavailable without target-side cancellation because tab changes persist to worldmonitor-tabs-v1 and the live panel workspace (same class as openCountryBrief/set_map_layers).",
  "inputSchema": {
    "type": "object",
    "properties": {
      "tabId": {
        "type": "string",
        "minLength": 1,
        "maxLength": 64,
        "pattern": "^tab-[a-z0-9]+-[a-z0-9]+$",
        "description": "Stable dashboard tab id from list_dashboard_tabs."
      },
      "confirm": {
        "type": "boolean",
        "description": "Must be true. Delete is a destructive persistent mutation."
      }
    },
    "required": [
      "tabId",
      "confirm"
    ],
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}

{
  "name": "list_mission_presets",
  "kind": "answer",
  "impl": "imperative",
  "description": "List every bundled mission preset for the current monitor. Each item uses a stable preset ID and panel/layer counts without premium payloads. Available rows include intended view and time range. Includes active, monitorCompatible, entitled, and available flags with a stable unavailableReason when gated.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "available": {
        "type": "boolean",
        "description": "If set, keep only presets the current session can apply."
      }
    },
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}

{
  "name": "apply_mission_preset",
  "kind": "act",
  "impl": "imperative",
  "description": "Apply a bundled mission preset by stable ID through the same mission-control path a person uses. Reports entitlement and monitor compatibility before writing. Requires target-side cancellation because it persists panels, layers, map view, and time range. On failure, restores the prior dashboard state.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "presetId": {
        "type": "string",
        "description": "Bundled mission preset ID from list_mission_presets.",
        "minLength": 1,
        "maxLength": 48,
        "pattern": "^[a-z][a-z0-9-]*$"
      }
    },
    "required": [
      "presetId"
    ],
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}

{
  "name": "open_mission_picker",
  "kind": "act",
  "impl": "imperative",
  "description": "Open the mission preset picker through the same mission-control path a person uses. Opening the picker does not apply a preset. Returns the destination and effective dashboard state.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}

{
  "name": "list_followed_countries",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read the current followed-country list through the same anonymous or signed-in state used by the dashboard. Returns only ISO 3166-1 alpha-2 codes, access state, and the free-tier limit.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}

{
  "name": "set_country_followed",
  "kind": "act",
  "impl": "imperative",
  "description": "Follow or unfollow one country through the dashboard service that owns ISO validation, access state, the free-tier cap, sign-in handoff, and storage. Idempotent for the requested state. Requires target-side cancellation because it persists state or writes to the signed-in account.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "iso2": {
        "type": "string",
        "pattern": "^[A-Z]{2}$",
        "description": "ISO 3166-1 alpha-2 country code, uppercase."
      },
      "followed": {
        "type": "boolean",
        "description": "True to follow the country; false to unfollow it."
      }
    },
    "required": [
      "iso2",
      "followed"
    ],
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}

{
  "name": "get_access_context",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read whether this tab is signed out, still loading account state, or signed in. Returns product tier, capability flags, panel and dashboard-tab limits, and whether the host can cancel tools. Contains no names, emails, account IDs, tokens, or session details.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}

{
  "name": "open_sign_in",
  "kind": "act",
  "impl": "imperative",
  "description": "Open the existing Clerk sign-in dialog on this page. Does not accept credentials, one-time codes, or provider choices. Returns a stable reason when Clerk is unavailable or the dialog is already open.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/dashboard?zoom=1.00&view=global&timeRange=7d&layers=pipelines%2Cais%2CtradeRoutes%2Cclimate%2Cweather%2Coutages%2Cnatural%2Cfires%2Cwaterways%2Ceconomic%2Cminerals%2Csanctions%2CcommodityHubs%2CminingSites%2CprocessingPlants%2CcommodityPorts"
}