assetcore_list_instances

AssetCore is a deterministic structured memory substrate. It stores all world state explicitly in containers and modifies that state through atomic, replayable transactions. List instances with class/variant/owner filters and placement metadata.

Details

Calls /v1/read/namespaces/{namespace_id}/instances with optional class, variant_key, owner, cursor (last seen instance id), and limit (default 20, max 200). Values above max are clamped to the maximum. Returns limit/next_cursor/has_more plus instances[] {inst_id, class_id, variant_key?, location type=grid|slot|continuous_1d|continuous_2d} with freshness and correlation identifiers.

Protocols

MCP
OpenAI
Gemini

Input Schema

{
  "properties": {
    "class": {
      "description": "Optional class filter.",
      "maxLength": 128,
      "minLength": 1,
      "pattern": "^[A-Za-z0-9._~\\-]+$",
      "type": "string"
    },
    "cursor": {
      "description": "Cursor anchored to the last seen instance identifier.",
      "maxLength": 128,
      "minLength": 1,
      "pattern": "^[A-Za-z0-9._~\\-]+$",
      "type": "string"
    },
    "limit": {
      "default": 20,
      "description": "Maximum number of instances to return (default: 20, max: 200)",
      "maximum": 200,
      "minimum": 1,
      "type": "integer"
    },
    "namespace_id": {
      "description": "Required namespace identifier for all namespaced operations.",
      "minimum": 1,
      "type": "integer"
    },
    "owner": {
      "description": "Optional owner filter (container owner).",
      "maxLength": 128,
      "minLength": 1,
      "pattern": "^[A-Za-z0-9._~\\-]+$",
      "type": "string"
    },
    "variant_key": {
      "description": "Optional variant key filter",
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "namespace_id"
  ],
  "type": "object"
}

Examples

No examples are currently available for this tool.