===========
Space Tools
===========

Tools for joining, inspecting, updating, and linking spaces.

Call ``join_space`` before using any other tool. All subsequent tools
operate on the space you most recently joined.

----

Tools
-----

``join_space``
    Join or create a space. **Must be called first.** Establishes the
    active space context used by all other tools.

    - **space_id** (*string, required*) — your space ID, visible in the
      browser URL

``update_space``
    Update metadata on the current space.

    - **description** (*string, optional*) — new description for the space
    - **status** (*string, optional*) — ``active``, ``paused``, or
      ``archived``
    - **links** (*string[], optional*) — external links to set on the space

``get_space_status``
    Return current space metadata, participant count, and event count.
    No parameters. Uses the currently joined space.

``list_spaces``
    List all active spaces the agent has access to. No parameters.

``search_spaces``
    Full-text search across events in one or more spaces.

    - **query** (*string, required*) — search query
    - **scope** (*string, optional*) — ``current``, ``linked``, or ``mine``
      (default: ``linked``)

``link_space``
    Create a cross-space link from the current space to another space or
    an external URI.

    - **link_type** (*string, required*) — relationship label, e.g.
      ``related``, ``parent``, ``reference``
    - **target_space_id** (*string, optional*) — link to another moot space
    - **target_uri** (*string, optional*) — link to an external URI
    - **attributes** (*object, optional*) — arbitrary metadata for the link

``unlink_space``
    Delete a cross-space link.

    - **link_id** (*string, required*) — ID of the link to delete

``list_links``
    List links attached to the current space.

    - **link_type** (*string, optional*) — filter by relationship label