kaeru memory

Overview Schema Source Related Servers Discussions Admin

export

Download selected initiatives as a Markdown ZIP or portable AMG file into the host artifact root. Choose one, several, or all initiatives to save project knowledge for sharing or transfer.

Instructions

Export current knowledge as a downloadable Markdown ZIP (format markdown) or portable AMG file (format amg). Select exactly one initiative, several initiatives or all. No import; no history backup. Destination stays inside the host artifact root.

Input Schema

Name	Required	Description
`all`	No
`format`	Yes
`initiative`	No
`request_id`	No	Optional stable operation key supplied by the host/SDK; see replay contract.
`destination`	Yes	New .zip or .amg filename inside the host artifact root; the extension is added if absent.
`initiatives`	No

Output Schema

Name	Required	Description	Default
`data`	Yes
`state`	Yes
`issues`	Yes
`coverage`	No
`replayed`	Yes
`operation`	Yes
`request_id`	No
`api_version`	Yes
`continuation`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed14 schema fields changedv0.8.0Oct 21, 2026

addedInput schema / additionalProperties
```
Added value: +false
```

addedInput schema / oneOf

Added value: +[
+  {
+    "allOf": [
+      {
+        "additionalProperties": false,
+        "properties": {
+          "all": {
+            "const": true,
+            "type": "boolean"
+          },
+          "destination": {
+            "description": "New .zip or .amg filename inside the host artifact root; the extension is added if absent.",
+            "minLength": 1,
+            "type": "string"
+          },
+          "format": {
+            "enum": [
+              "markdown",
+              "amg"
+            ],
+            "type": "string"
+          },
+          "initiative": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "initiatives": {
+            "items": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "minItems": 1,
+            "type": "array",
+            "uniqueItems": true
+          },
+          "request_id": {
+            "description": "Optional stable operation key supplied by the host/SDK; see replay contract.",
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "format",
+          "destination",
+          "initiative"
+        ],
+        "type": "object"
+      },
+      {
+        "not": {
+          "anyOf": [
+            {
+              "required": [
+                "initiatives"
+              ]
+            },
+            {
+              "required": [
+                "all"
+              ]
+            }
+          ]
+        },
+        "required": [
+          "initiative"
+        ]
+      }
+    ]
+  },
+  {
+    "allOf": [
+      {
+        "additionalProperties": false,
+        "properties": {
+          "all": {
+            "const": true,
+            "type": "boolean"
+          },
+          "destination": {
+            "description": "New .zip or .amg filename inside the host artifact root; the extension is added if absent.",
+            "minLength": 1,
+            "type": "string"
+          },
+          "format": {
+            "enum": [
+              "markdown",
+              "amg"
+            ],
+            "type": "string"
+          },
+          "initiative": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "initiatives": {
+            "items": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "minItems": 1,
+            "type": "array",
+            "uniqueItems": true
+          },
+          "request_id": {
+            "description": "Optional stable operation key supplied by the host/SDK; see replay contract.",
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "format",
+          "destination",
+          "initiatives"
+        ],
+        "type": "object"
+      },
+      {
+        "not": {
+          "anyOf": [
+            {
+              "required": [
+                "initiative"
+              ]
+            },
+            {
+              "required": [
+                "all"
+              ]
+            }
+          ]
+        },
+        "required": [
+          "initiatives"
+        ]
+      }
+    ]
+  },
+  {
+    "allOf": [
+      {
+        "additionalProperties": false,
+        "properties": {
+          "all": {
+            "const": true,
+            "type": "boolean"
+          },
+          "destination": {
+            "description": "New .zip or .amg filename inside the host artifact root; the extension is added if absent.",
+            "minLength": 1,
+            "type": "string"
+          },
+          "format": {
+            "enum": [
+              "markdown",
+              "amg"
+            ],
+            "type": "string"
+          },
+          "initiative": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "initiatives": {
+            "items": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "minItems": 1,
+            "type": "array",
+            "uniqueItems": true
+          },
+          "request_id": {
+            "description": "Optional stable operation key supplied by the host/SDK; see replay contract.",
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "format",
+          "destination",
+          "all"
+        ],
+        "type": "object"
+      },
+      {
+        "not": {
+          "anyOf": [
+            {
+              "required": [
+                "initiative"
+              ]
+            },
+            {
+              "required": [
+                "initiatives"
+              ]
+            }
+          ]
+        },
+        "required": [
+          "all"
+        ]
+      }
+    ]
+  }
+]

addedInput schema / properties / all

Added value: +{
+  "const": true,
+  "type": "boolean"
+}

addedInput schema / properties / destination

Added value: +{
+  "description": "New .zip or .amg filename inside the host artifact root; the extension is added if absent.",
+  "minLength": 1,
+  "type": "string"
+}

addedInput schema / properties / format

Added value: +{
+  "enum": [
+    "markdown",
+    "amg"
+  ],
+  "type": "string"
+}

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"

addedInput schema / properties / initiatives

Added value: +{
+  "items": {
+    "minLength": 1,
+    "type": "string"
+  },
+  "minItems": 1,
+  "type": "array",
+  "uniqueItems": true
+}

removedInput schema / properties / output_dir

Removed value: -{
-  "description": "Output directory.",
-  "type": "string"
-}

addedInput schema / properties / request_id

Added value: +{
+  "description": "Optional stable operation key supplied by the host/SDK; see replay contract.",
+  "minLength": 1,
+  "type": "string"
+}

changedInput schema / required

Previous value: -[
-  "output_dir"
-]New value: +[
+  "format",
+  "destination"
+]

removedInput schema / title
```
Removed value: -"ExportParams"
```

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": "export",
+      "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"
+}

First observedv0.7.5Oct 5, 2026

TDQS

A4.1/5.0

Behavior4/5

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

Annotations only declare readOnlyHint=false; the description adds real meaning by confirming it writes a downloadable artifact and that the destination stays inside the host artifact root. 'No history backup' also bounds the side effect. It omits what happens if the destination file already exists and whether auth/permissions are required.

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

Conciseness5/5

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

Four short sentences, front-loaded with the primary action and output formats, then selection rules and constraints. No filler or restatement of the tool name.

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

Completeness4/5

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

Output schema exists, so return values need not be described. For a 6-parameter, non-trivial oneOf tool the description covers formats, selection semantics, and destination scoping well. Overwrite/collision behavior and permission requirements are the remaining gaps.

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

Parameters4/5

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

With 33% schema coverage and a complex three-branch oneOf, the description does valuable work: it spells out the initiative/initiatives/all mutual exclusivity and maps the format enum values to concrete outputs. The destination's location constraint is also restated in prose. request_id remains unexplained, but the schema documents it.

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 ('Export') and resource ('current knowledge') with the two output formats named inline. An agent can tell this is a file-export operation. It does not explicitly differentiate from siblings like share/pull/cloud_recall, which also move knowledge out of the system, keeping it at 4 rather than 5.

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

Usage Guidelines4/5

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

'Select exactly one initiative, several initiatives or all' gives the selection rules, and 'No import; no history backup' carves out what this tool is not for. It stops short of naming a concrete alternative (e.g. history or share) for the cases it excludes.

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

Deploy Server