idle_until_session_done
[MAINTENANCE] Read-only: Poll every 30 seconds until another session is closed or archived. Use this when you need to wait before editing a locked file. 6f9503a9 — BOUNDED: the wait times out after timeout_seconds (default 1800s / 30 min) and returns {done:false, timed_out:true, status} so a stuc...
This record as markdown: /tools/io-github-ajc3xc-meridian/idle-until-session-done.md
What idle_until_session_done does on Meridian
AI agents call idle_until_session_done to retrieve information from Meridian without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.
| Parameter | Type | Required | Description |
|---|---|---|---|
timeout_seconds | number | — | Max seconds to wait before returning done=false, timed_out=true (default 1800). A stuck/never-closing session can't hang the caller past this. |
watching_session_id | string | Yes |
Parameters from the server's own tool schema.
Why idle_until_session_done is rated Low
The tool retrieves polling information about session status with no side effects. It is purely observational and explicitly advertised as read-only. The bounded timeout ensures it cannot hang indefinitely. This is a low-severity monitoring/synchronization utility.
From the tool's definition Explicitly marked '[MAINTENANCE] Read-only' and 'Poll every 30 seconds until another session is closed or archived'. The tool queries state (session status) and returns information without modifying, creating, deleting, or executing external operations.
Attacks that exploit this kind of access
The rule that runs idle_until_session_done safely
PolicyLayer is an MCP gateway: it sits between your AI agents and Meridian, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For idle_until_session_done, this is the rule to start with:
idle_until_session_done is read-only, so it stays allowed. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect Meridian, apply this rule, and every idle_until_session_done call is checked against it from then on.
Questions about idle_until_session_done
[MAINTENANCE] Read-only: Poll every 30 seconds until another session is closed or archived. Use this when you need to wait before editing a locked file. 6f9503a9 — BOUNDED: the wait times out after timeout_seconds (default 1800s / 30 min) and returns {done:false, timed_out:true, status} so a stuck subagent in a parallel fan-out fails that one item fast instead of hanging the whole batch. Pass timeout_seconds=0 or a large value to tune; there is no unbounded wait. It is categorised as a Read tool in the Meridian MCP Server, which means it retrieves data without modifying state.
idle_until_session_done accepts 2 parameters: timeout_seconds, watching_session_id. Required: watching_session_id. The full parameter table on this page comes from the server's own tool schema.
Register the Meridian MCP server in PolicyLayer and add a rule for idle_until_session_done: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Meridian. Nothing to install.
idle_until_session_done is a Read tool with low risk. Read-only tools are generally safe to allow by default.
Yes. Add a rate_limit block to the idle_until_session_done rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for idle_until_session_done. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
idle_until_session_done is provided by the Meridian MCP server (@meridianmcp/mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on Meridian, and thousands of servers like it.
This server
Across the catalogue