Skip to main content
Glama
Sign In
TimWongUp

AgentNave

by TimWongUp
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Read a saved conversation

read_conversation
Read-onlyIdempotent

Read saved final messages/tasks, including native session_ids and forwardable message_ids. Meeting id equals group_id; pending_answer marks answers awaiting review. Private: never forward the whole result to seats.

Instructions

Read saved final messages/tasks, including native session_ids and forwardable message_ids. Meeting id equals group_id; pending_answer marks answers awaiting review. Private: never forward the whole result to seats.

Input Schema

NameRequiredDescriptionDefault
limitNoMost recent messages/tasks to return; omit for all remaining.
since_roundNoMeetings: include messages from this round onward; 0 includes initial host remarks.
conversation_idYes
include_privateNoMeetings: also each seat's private instructions and the answers kept private.

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changedv0.65.0
    • changedInput schema / properties / limit / description
      Previous value: -"At most this many of the most recent messages or tasks; omitted counts the rest."New value: +"Most recent messages/tasks to return; omit for all remaining."
    • changedInput schema / properties / since_round / description
      Previous value: -"Meetings: only messages from this round on; 0 includes host remarks posted before the first round."New value: +"Meetings: include messages from this round onward; 0 includes initial host remarks."
  2. Changed2 schema fields changedv0.53.1
    • changedInput schema / properties / include_private / description
      Previous value: -"Shows: also each seat's private instructions and the answers kept private."New value: +"Meetings: also each seat's private instructions and the answers kept private."
    • changedInput schema / properties / since_round / description
      Previous value: -"Shows: only messages from this round on; 0 includes host remarks posted before the first round."New value: +"Meetings: only messages from this round on; 0 includes host remarks posted before the first round."
  3. Changed1 schema field changedv0.49.0
    • addedInput schema / additionalProperties
      Added value: +false
  4. Changed1 schema field changedv0.41.0
    • addedInput schema / properties / limit
      Added value: +{
+  "anyOf": [
+    {
+      "maximum": 500,
+      "minimum": 1,
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "At most this many of the most recent messages or tasks; omitted counts the rest.",
+  "title": "Limit"
+}
  5. Changed7 schema fields changedv0.35.0
    • addedInput schema / properties / include_private
      Added value: +{
+  "default": false,
+  "description": "Shows: also each seat's private instructions and the answers kept private.",
+  "title": "Include Private",
+  "type": "boolean"
+}
    • addedInput schema / properties / since_round
      Added value: +{
+  "default": 0,
+  "description": "Shows: only messages from this round on; 0 includes host remarks posted before the first round.",
+  "minimum": 0,
+  "title": "Since Round",
+  "type": "integer"
+}
    • removedOutput schema / $defs
      Removed value: -{
-  "Conversation": {
-    "properties": {
-      "created": {
-        "title": "Created",
-        "type": "string"
-      },
-      "cwd": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "title": "Cwd"
-      },
-      "entries": {
-        "items": {
-          "$ref": "#/$defs/EntryRecord"
-        },
-        "title": "Entries",
-        "type": "array"
-      },
-      "host": {
-        "anyOf": [
-          {
-            "$ref": "#/$defs/HostName"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null
-      },
-      "host_source": {
-        "$ref": "#/$defs/HostSource",
-        "default": "unknown"
-      },
-      "id": {
-        "title": "Id",
-        "type": "string"
-      },
-      "isolated": {
-        "default": false,
-        "title": "Isolated",
-        "type": "boolean"
-      },
-      "kind": {
-        "enum": [
-          "show",
-          "task"
-        ],
-        "title": "Kind",
-        "type": "string"
-      },
-      "manager_session": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "title": "Manager Session"
-      },
-      "review": {
-        "default": false,
-        "title": "Review",
-        "type": "boolean"
-      },
-      "rounds": {
-        "items": {
-          "$ref": "#/$defs/RoundRecord"
-        },
-        "title": "Rounds",
-        "type": "array"
-      },
-      "seats": {
-        "items": {
-          "$ref": "#/$defs/SeatRecord"
-        },
-        "title": "Seats",
-        "type": "array"
-      },
-      "sessions": {
-        "additionalProperties": {
-          "$ref": "#/$defs/SessionRecord"
-        },
-        "title": "Sessions",
-        "type": "object"
-      },
-      "tasks": {
-        "items": {
-          "$ref": "#/$defs/TaskRecord"
-        },
-        "title": "Tasks",
-        "type": "array"
-      },
-      "title": {
-        "title": "Title",
-        "type": "string"
-      },
-      "version": {
-        "const": 2,
-        "default": 2,
-        "title": "Version",
-        "type": "integer"
-      }
-    },
-    "required": [
-      "id",
-      "title",
-      "kind"
-    ],
-    "title": "Conversation",
-    "type": "object"
-  },
-  "EntryRecord": {
-    "properties": {
-      "forward_id": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "title": "Forward Id"
-      },
-      "forward_source": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "title": "Forward Source"
-      },
-      "kind": {
-        "enum": [
-          "task",
-          "host",
-          "answer",
-          "absent",
-          "forward"
-        ],
-        "title": "Kind",
-        "type": "string"
-      },
-      "manager_model": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "title": "Manager Model"
-      },
-      "manager_reported_model": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "title": "Manager Reported Model"
-      },
-      "reported_model": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "title": "Reported Model"
-      },
-      "round": {
-        "title": "Round",
-        "type": "integer"
-      },
-      "seat": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "title": "Seat"
-      },
-      "text": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "title": "Text"
-      },
-      "time": {
-        "title": "Time",
-        "type": "string"
-      }
-    },
-    "required": [
-      "round",
-      "kind",
-      "time"
-    ],
-    "title": "EntryRecord",
-    "type": "object"
-  },
-  "HostName": {
-    "enum": [
-      "codex",
-      "claude",
-      "codebuddy",
-      "workbuddy",
-      "grok",
-      "antigravity",
-      "pi",
-      "gemini",
-      "opencode",
-      "hermes"
-    ],
-    "type": "string"
-  },
-  "HostSource": {
-    "enum": [
-      "env",
-      "parent",
-      "unknown"
-    ],
-    "type": "string"
-  },
-  "ProviderOption": {
-    "anyOf": [
-      {
-        "type": "string"
-      },
-      {
-        "type": "integer"
-      },
-      {
-        "type": "number"
-      },
-      {
-        "type": "boolean"
-      }
-    ]
-  },
-  "Review": {
-    "enum": [
-      "pending",
-      "publish",
-      "discard"
-    ],
-    "type": "string"
-  },
-  "RoundOrder": {
-    "enum": [
-      "parallel",
-      "serial"
-    ],
-    "type": "string"
-  },
-  "RoundRecord": {
-    "properties": {
-      "error": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "title": "Error"
-      },
-      "id": {
-        "title": "Id",
-        "type": "string"
-      },
-      "number": {
-        "title": "Number",
-        "type": "integer"
-      },
-      "order": {
-        "$ref": "#/$defs/RoundOrder"
-      },
-      "seats": {
-        "items": {
-          "$ref": "#/$defs/SeatRunRecord"
-        },
-        "title": "Seats",
-        "type": "array"
-      },
-      "status": {
-        "default": "running",
-        "enum": [
-          "running",
-          "finished",
-          "failed",
-          "cancelled",
-          "interrupted"
-        ],
-        "title": "Status",
-        "type": "string"
-      }
-    },
-    "required": [
-      "id",
-      "number",
-      "order",
-      "seats"
-    ],
-    "title": "RoundRecord",
-    "type": "object"
-  },
-  "SeatRecord": {
-    "properties": {
-      "access": {
-        "anyOf": [
-          {
-            "enum": [
-              "read",
-              "write"
-            ],
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "title": "Access"
-      },
-      "cwd": {
-        "title": "Cwd",
-        "type": "string"
-      },
-      "id": {
-        "title": "Id",
-        "type": "string"
-      },
-      "provider": {
-        "title": "Provider",
-        "type": "string"
-      },
-      "provider_options": {
-        "additionalProperties": {
-          "$ref": "#/$defs/ProviderOption"
-        },
-        "title": "Provider Options",
-        "type": "object"
-      },
-      "role": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "title": "Role"
-      }
-    },
-    "required": [
-      "id",
-      "provider",
-      "cwd"
-    ],
-    "title": "SeatRecord",
-    "type": "object"
-  },
-  "SeatRunRecord": {
-    "properties": {
-      "committed": {
-        "default": false,
-        "title": "Committed",
-        "type": "boolean"
-      },
-      "error": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "title": "Error"
-      },
-      "instruction": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "title": "Instruction"
-      },
-      "output": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "title": "Output"
-      },
-      "reported_model": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "title": "Reported Model"
-      },
-      "review": {
-        "anyOf": [
-          {
-            "$ref": "#/$defs/Review"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null
-      },
-      "seat_id": {
-        "title": "Seat Id",
-        "type": "string"
-      },
-      "status": {
-        "default": "pending",
-        "enum": [
-          "pending",
-          "running",
-          "succeeded",
-          "failed",
-          "blocked",
-          "cancelled",
-          "not_started",
-          "interrupted"
-        ],
-        "title": "Status",
-        "type": "string"
-      }
-    },
-    "required": [
-      "seat_id"
-    ],
-    "title": "SeatRunRecord",
-    "type": "object"
-  },
-  "SessionRecord": {
-    "properties": {
-      "cursor": {
-        "default": 0,
-        "title": "Cursor",
-        "type": "integer"
-      },
-      "session_id": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "title": "Session Id"
-      }
-    },
-    "title": "SessionRecord",
-    "type": "object"
-  },
-  "TaskRecord": {
-    "properties": {
-      "access": {
-        "anyOf": [
-          {
-            "enum": [
-              "read",
-              "write"
-            ],
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "title": "Access"
-      },
-      "cwd": {
-        "title": "Cwd",
-        "type": "string"
-      },
-      "elapsed_ms": {
-        "default": 0,
-        "title": "Elapsed Ms",
-        "type": "integer"
-      },
-      "error": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "title": "Error"
-      },
-      "forward": {
-        "items": {
-          "type": "string"
-        },
-        "title": "Forward",
-        "type": "array"
-      },
-      "id": {
-        "title": "Id",
-        "type": "string"
-      },
-      "manager_model": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "title": "Manager Model"
-      },
-      "manager_reported_model": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "title": "Manager Reported Model"
-      },
-      "model": {
-        "title": "Model",
-        "type": "string"
-      },
-      "output": {
-        "default": "",
-        "title": "Output",
-        "type": "string"
-      },
-      "prompt": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "title": "Prompt"
-      },
-      "provider": {
-        "title": "Provider",
-        "type": "string"
-      },
-      "reported_model": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "title": "Reported Model"
-      },
-      "role": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "title": "Role"
-      },
-      "session_id": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "title": "Session Id"
-      },
-      "status": {
-        "default": "running",
-        "title": "Status",
-        "type": "string"
-      },
-      "time": {
-        "title": "Time",
-        "type": "string"
-      }
-    },
-    "required": [
-      "id",
-      "provider",
-      "model",
-      "cwd",
-      "time"
-    ],
-    "title": "TaskRecord",
-    "type": "object"
-  }
-}
    • addedOutput schema / additionalProperties
      Added value: +true
    • removedOutput schema / properties
      Removed value: -{
-  "conversation": {
-    "$ref": "#/$defs/Conversation"
-  },
-  "director_url": {
-    "title": "Director Url",
-    "type": "string"
-  },
-  "public_url": {
-    "title": "Public Url",
-    "type": "string"
-  },
-  "writable": {
-    "title": "Writable",
-    "type": "boolean"
-  }
-}
    • removedOutput schema / required
      Removed value: -[
-  "conversation",
-  "writable"
-]
    • changedOutput schema / title
      Previous value: -"ConversationView"New value: +"read_conversationDictOutput"
  6. Changed13 schema fields changedv0.31.0
    • addedOutput schema / $defs / EntryRecord / properties / forward_id
      Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Forward Id"
+}
    • addedOutput schema / $defs / EntryRecord / properties / forward_source
      Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Forward Source"
+}
    • changedOutput schema / $defs / EntryRecord / properties / kind / enum
      Previous value: -[
-  "task",
-  "host",
-  "answer",
-  "absent"
-]New value: +[
+  "task",
+  "host",
+  "answer",
+  "absent",
+  "forward"
+]
    • addedOutput schema / $defs / EntryRecord / properties / manager_reported_model
      Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Manager Reported Model"
+}
    • addedOutput schema / $defs / EntryRecord / properties / reported_model
      Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Reported Model"
+}
    • addedOutput schema / $defs / SeatRecord / properties / access
      Added value: +{
+  "anyOf": [
+    {
+      "enum": [
+        "read",
+        "write"
+      ],
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Access"
+}
    • addedOutput schema / $defs / SeatRecord / properties / role
      Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Role"
+}
    • addedOutput schema / $defs / SeatRunRecord / properties / reported_model
      Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Reported Model"
+}
    • addedOutput schema / $defs / TaskRecord / properties / access
      Added value: +{
+  "anyOf": [
+    {
+      "enum": [
+        "read",
+        "write"
+      ],
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Access"
+}
    • addedOutput schema / $defs / TaskRecord / properties / forward
      Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "title": "Forward",
+  "type": "array"
+}
    • addedOutput schema / $defs / TaskRecord / properties / manager_reported_model
      Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Manager Reported Model"
+}
    • addedOutput schema / $defs / TaskRecord / properties / reported_model
      Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Reported Model"
+}
    • addedOutput schema / $defs / TaskRecord / properties / role
      Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Role"
+}
  7. Addedv0.23.0

TDQS

B3.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint, idempotentHint and destructiveHint=false, so the safety profile is covered. The description adds genuinely new behavioral context beyond them: the result is private and must not be forwarded wholesale to seats, and it explains that pending_answer marks answers awaiting review. This is exactly the kind of extra operational caveat annotations cannot express.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three short, front-loaded lines: purpose first, then identifiers, then the privacy caveat. Efficient overall, though 'Private: never forward the whole result to seats' is telegraphic and assumes the reader knows what 'seats' are.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return-value detail is rightly omitted, and annotations cover safety. However, the description introduces domain terms ('seats', 'meetings', 'group_id', 'pending_answer') without defining them, and never explains what happens when conversation_id does not refer to a meeting, leaving an agent to infer the mode.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 75%, with limit, since_round and include_private already well documented in the schema, so the baseline of 3 applies. The description does add clarifying semantics for conversation_id ('Meeting id equals group_id'), which is the one undocumented parameter, but it says nothing about the effect of limit or since_round beyond what the schema states.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource: 'Read saved final messages/tasks', and adds what the payload contains (native session_ids, forwardable message_ids). It is clearly distinguishable from the write/orchestration siblings (start_agent, run_round, decide_answers), though it never names an alternative explicitly.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives no guidance on when to call this versus siblings like `list` or `wait`. The only directive is a downstream handling rule ('never forward the whole result to seats'), which constrains use of the output but does not help select the tool.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools