Skip to main content
Glama
LamantinAI

kaeru memory

by LamantinAI
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Rust
Hybrid

task

Create an open to-do for an initiative with an optional due date and relation link to track commitments and open work across sessions.

Instructions

Create an open task; optional deadline and relation are captured with it.

Input Schema

NameRequiredDescriptionDefault
dueNo
bodyYes
optionsNo
relatedNo
initiativeYes
request_idNoOptional stable operation key supplied by the host/SDK; see replay contract.

Output Schema

NameRequiredDescriptionDefault
dataYes
stateYes
issuesYes
coverageNo
replayedYes
operationYes
request_idNo
api_versionYes
continuationNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed21 schema fields changedv0.8.0
    • addedInput schema / $defs
      Added value: +{
+  "CaptureOptions": {
+    "additionalProperties": false,
+    "allOf": [
+      {
+        "additionalProperties": false,
+        "properties": {
+          "expected_slot_revision": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "layer": {
+            "$ref": "#/$defs/Layer"
+          },
+          "slot": {
+            "$ref": "#/$defs/Slot"
+          }
+        },
+        "required": [],
+        "type": "object"
+      },
+      {
+        "if": {
+          "required": [
+            "expected_slot_revision"
+          ]
+        },
+        "then": {
+          "required": [
+            "slot"
+          ]
+        }
+      }
+    ],
+    "properties": {
+      "expected_slot_revision": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "layer": {
+        "$ref": "#/$defs/Layer"
+      },
+      "slot": {
+        "$ref": "#/$defs/Slot"
+      }
+    },
+    "required": [],
+    "type": "object"
+  },
+  "EdgeType": {
+    "enum": [
+      "refers_to",
+      "derived_from",
+      "supersedes",
+      "causal",
+      "temporal",
+      "contradicts",
+      "part_of",
+      "blocks",
+      "targets",
+      "verifies",
+      "falsifies",
+      "consolidated_to"
+    ],
+    "type": "string"
+  },
+  "Layer": {
+    "enum": [
+      "core",
+      "hot",
+      "warm",
+      "cold",
+      "frozen"
+    ],
+    "type": "string"
+  },
+  "NodeRef": {
+    "oneOf": [
+      {
+        "description": "Returned UUID or exact name in the call initiative; ambiguity is an error.",
+        "minLength": 1,
+        "type": "string"
+      },
+      {
+        "additionalProperties": false,
+        "properties": {
+          "id": {
+            "description": "Returned canonical ID, including IDs from older vaults.",
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "id"
+        ],
+        "type": "object"
+      },
+      {
+        "additionalProperties": false,
+        "properties": {
+          "initiative": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "name": {
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "name",
+          "initiative"
+        ],
+        "type": "object"
+      }
+    ]
+  },
+  "Relation": {
+    "additionalProperties": false,
+    "properties": {
+      "to": {
+        "$ref": "#/$defs/NodeRef"
+      },
+      "type": {
+        "$ref": "#/$defs/EdgeType"
+      },
+      "weight": {
+        "maximum": 1,
+        "minimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "to",
+      "type",
+      "weight"
+    ],
+    "type": "object"
+  },
+  "Slot": {
+    "maxLength": 64,
+    "minLength": 1,
+    "pattern": "^[a-z][a-z0-9_-]*$",
+    "type": "string"
+  }
+}
    • addedInput schema / additionalProperties
      Added value: +false
    • removedInput schema / properties / body / description
      Removed value: -"Free-form task description."
    • addedInput schema / properties / body / minLength
      Added value: +1
    • removedInput schema / properties / due / default
      Removed value: -null
    • removedInput schema / properties / due / description
      Removed value: -"Optional deadline. Accepts an ISO date (`2026-05-15`), an\nRFC-3339 datetime, or a future duration (`3d`, `2w`). Omit\nfor tasks without a deadline."
    • addedInput schema / properties / due / format
      Added value: +"date"
    • changedInput schema / properties / due / type
      Previous value: -[
-  "string",
-  "null"
-]New value: +"string"
    • removedInput schema / properties / edge_type
      Removed value: -{
-  "default": null,
-  "description": "Edge type for `link_to` — same closed vocabulary as `link`\n(`refers_to` by default, `causal`, `derived_from`, `contradicts`,\n`part_of`, `blocks`, `targets`, `supersedes`, `verifies`,\n`falsifies`, `temporal`, `consolidated_to`).",
-  "type": [
-    "string",
-    "null"
-  ]
-}
    • removedInput schema / properties / initiative / default
      Removed value: -null
    • addedInput schema / properties / initiative / minLength
      Added value: +1
    • changedInput schema / properties / initiative / type
      Previous value: -[
-  "string",
-  "null"
-]New value: +"string"
    • removedInput schema / properties / layer
      Removed value: -{
-  "default": null,
-  "description": "Optional memory layer stamped at creation: `core`, `hot`, `warm`,\n`cold`, or `frozen`. Defaults to `warm`.",
-  "type": [
-    "string",
-    "null"
-  ]
-}
    • removedInput schema / properties / link_to
      Removed value: -{
-  "default": null,
-  "description": "Optional: the node this one connects to, by name or id — the edge is\nmade in THIS call, while both ends are still in mind. Linking as a\nsecond step is the step nobody takes: one real vault reached 23 nodes\nand 0 edges with the nudge asking every time. Needs `weight`.",
-  "type": [
-    "string",
-    "null"
-  ]
-}
    • addedInput schema / properties / options
      Added value: +{
+  "$ref": "#/$defs/CaptureOptions"
+}
    • addedInput schema / properties / related
      Added value: +{
+  "$ref": "#/$defs/Relation"
+}
    • addedInput schema / properties / request_id
      Added value: +{
+  "description": "Optional stable operation key supplied by the host/SDK; see replay contract.",
+  "minLength": 1,
+  "type": "string"
+}
    • removedInput schema / properties / weight
      Removed value: -{
-  "default": null,
-  "description": "How load-bearing the `link_to` edge is, 0..1. REQUIRED with\n`link_to`: it is the only signal knowledge chains route on, and there\nis no default because an unweighted graph makes every chain rank on\nnoise. The capture still lands without it; the edge does not.",
-  "format": "double",
-  "type": [
-    "number",
-    "null"
-  ]
-}
    • changedInput schema / required
      Previous value: -[
-  "body"
-]New value: +[
+  "initiative",
+  "body"
+]
    • removedInput schema / title
      Removed value: -"TaskParams"
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
+  "$defs": {
+    "AmgOmission": {
+      "additionalProperties": false,
+      "properties": {
+        "count": {
+          "format": "uint",
+          "minimum": 0,
+          "type": "integer"
+        },
+        "reason": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "reason",
+        "count"
+      ],
+      "type": "object"
+    },
+    "ArchiveFormat": {
+      "enum": [
+        "markdown",
+        "amg"
+      ],
+      "type": "string"
+    },
+    "Artifact": {
+      "properties": {
+        "bytes": {
+          "format": "uint",
+          "minimum": 0,
+          "type": "integer"
+        },
+        "edges": {
+          "format": "uint",
+          "minimum": 0,
+          "type": "integer"
+        },
+        "format": {
+          "$ref": "#/$defs/ArchiveFormat"
+        },
+        "initiatives": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "nodes": {
+          "format": "uint",
+          "minimum": 0,
+          "type": "integer"
+        },
+        "omissions": {
+          "items": {
+            "$ref": "#/$defs/AmgOmission"
+          },
+          "type": "array"
+        },
+        "path": {
+          "type": "string"
+        },
+        "sha256": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "path",
+        "format",
+        "bytes",
+        "sha256",
+        "initiatives",
+        "omissions",
+        "nodes",
+        "edges"
+      ],
+      "type": "object"
+    },
+    "Change": {
+      "properties": {
+        "after": true,
+        "before": true,
+        "field": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "field",
+        "before",
+        "after"
+      ],
+      "type": "object"
+    },
+    "Continuation": {
+      "properties": {
+        "cursor": {
+          "type": "string"
+        },
+        "next_arguments": true
+      },
+      "required": [
+        "cursor",
+        "next_arguments"
+      ],
+      "type": "object"
+    },
+    "Coverage": {
+      "properties": {
+        "complete": {
+          "type": "boolean"
+        },
+        "initiatives": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "omitted": {
+          "items": {
+            "$ref": "#/$defs/Omission"
+          },
+          "type": "array"
+        },
+        "rules_complete": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "initiatives",
+        "complete",
+        "rules_complete",
+        "omitted"
+      ],
+      "type": "object"
+    },
+    "Entity": {
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "revision": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "revision"
+      ],
+      "type": "object"
+    },
+    "EvidenceResult": {
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "relation": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "relation"
+      ],
+      "type": "object"
+    },
+    "FailedStep": {
+      "properties": {
+        "code": {
+          "type": "string"
+        },
+        "message": {
+          "type": "string"
+        },
+        "step": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "step",
+        "code",
+        "message"
+      ],
+      "type": "object"
+    },
+    "Issue": {
+      "properties": {
+        "code": {
+          "type": "string"
+        },
+        "field": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "message": {
+          "type": "string"
+        },
+        "retryable": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "code",
+        "message",
+        "retryable"
+      ],
+      "type": "object"
+    },
+    "MutationData": {
+      "properties": {
+        "affected": {
+          "items": {
+            "$ref": "#/$defs/Entity"
+          },
+          "type": "array"
+        },
+        "artifacts": {
+          "items": {
+            "$ref": "#/$defs/Artifact"
+          },
+          "type": "array"
+        },
+        "changes": {
+          "items": {
+            "$ref": "#/$defs/Change"
+          },
+          "type": "array"
+        },
+        "created": {
+          "items": {
+            "$ref": "#/$defs/Entity"
+          },
+          "type": "array"
+        },
+        "evidence": {
+          "items": {
+            "$ref": "#/$defs/EvidenceResult"
+          },
+          "type": "array"
+        },
+        "failed_steps": {
+          "items": {
+            "$ref": "#/$defs/FailedStep"
+          },
+          "type": "array"
+        },
+        "primary": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/Entity"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "slots": {
+          "items": {
+            "$ref": "#/$defs/SlotChange"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "created",
+        "affected",
+        "changes",
+        "evidence",
+        "failed_steps",
+        "slots",
+        "artifacts"
+      ],
+      "type": "object"
+    },
+    "Omission": {
+      "properties": {
+        "count": {
+          "format": "uint",
+          "minimum": 0,
+          "type": "integer"
+        },
+        "reason": {
+          "type": "string"
+        },
+        "section": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "section",
+        "count",
+        "reason"
+      ],
+      "type": "object"
+    },
+    "SlotChange": {
+      "properties": {
+        "after": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "before": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "revision": {
+          "type": "string"
+        },
+        "slot": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "slot",
+        "revision"
+      ],
+      "type": "object"
+    },
+    "State": {
+      "enum": [
+        "ok",
+        "applied",
+        "unchanged",
+        "partial",
+        "rejected"
+      ],
+      "type": "string"
+    }
+  },
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "properties": {
+    "api_version": {
+      "const": 1,
+      "format": "uint32",
+      "minimum": 0,
+      "type": "integer"
+    },
+    "continuation": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/Continuation"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "coverage": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/Coverage"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "data": {
+      "$ref": "#/$defs/MutationData"
+    },
+    "issues": {
+      "items": {
+        "$ref": "#/$defs/Issue"
+      },
+      "type": "array"
+    },
+    "operation": {
+      "const": "task",
+      "type": "string"
+    },
+    "replayed": {
+      "type": "boolean"
+    },
+    "request_id": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "state": {
+      "$ref": "#/$defs/State"
+    }
+  },
+  "required": [
+    "api_version",
+    "operation",
+    "state",
+    "replayed",
+    "data",
+    "issues"
+  ],
+  "title": "Response",
+  "type": "object"
+}
  2. First observedv0.7.5

TDQS

C2.7/5.0
Behavior2/5

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

Annotations supply only readOnlyHint=false, so the description carries the burden of behavioral disclosure for a write tool. 'Open task' mildly communicates initial state and 'captured with it' hints at persistence, but nothing explains initiative scoping, the replay/idempotency contract behind request_id, or slot-revision conflict behavior in options.

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?

One short sentence, front-loaded with the core action and scoped additions after the semicolon. Nothing is padded, though the brevity is partly under-specification rather than deliberate economy.

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

Completeness2/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 values need not be explained, but the input side is complex: a oneOf NodeRef, a typed/weighted Relation, and a CaptureOptions object with optimistic concurrency fields. None of this complexity is acknowledged, leaving the agent to reverse-engineer required fields and conflict semantics from the schema.

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

Parameters2/5

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

Schema description coverage is only 17% across 6 parameters, and the description covers just two of them (due as 'deadline', related as 'relation') without format or semantics. It says nothing about the required initiative and body, nor about options or request_id, so it fails to compensate for the coverage gap.

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 clear verb (Create) and resource (task) plus the resulting state ('open'), which is more than the bare tool name gives. It does not differentiate itself from the sibling task_update, so an agent must infer the create-vs-modify split from names alone.

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 explicit when-to-use guidance and never names task_update or any other sibling as the alternative. The only usage signal is the implied create semantics of 'Create an open task'.

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