assetcore_get_container_grid

AssetCore is a deterministic structured memory substrate. It stores all world state explicitly in containers and modifies that state through atomic, replayable transactions. Retrieve grid placements and occupancy for a container, optionally filtered by region.

Details

Calls /v1/read/namespaces/{namespace_id}/containers/:id/grid/cells with optional region filters (x,y,width,height). Response includes placements[] {anchor, occupant stack_id|inst_id, shape {width,height}, rotation}, grid metadata {grid_width, grid_height, capacity, occupied_cells, utilization}, optional region echo, freshness, and correlation identifiers.

Protocols

MCP
OpenAI
Gemini

Input Schema

{
  "properties": {
    "container_id": {
      "description": "Container identifier to inspect grid cells for.",
      "maxLength": 128,
      "minLength": 1,
      "pattern": "^[A-Za-z0-9._~\\-]+$",
      "type": "string"
    },
    "height": {
      "description": "Optional region height (requires x,y,width when supplied)",
      "minimum": 1,
      "type": "integer"
    },
    "namespace_id": {
      "description": "Required namespace identifier for all namespaced operations.",
      "minimum": 1,
      "type": "integer"
    },
    "width": {
      "description": "Optional region width (requires x,y,height when supplied)",
      "minimum": 1,
      "type": "integer"
    },
    "x": {
      "description": "Optional 0-based column for region filter",
      "minimum": 0,
      "type": "integer"
    },
    "y": {
      "description": "Optional 0-based row for region filter",
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "container_id",
    "namespace_id"
  ],
  "type": "object"
}

Examples

No examples are currently available for this tool.