assetcore_list_containers

AssetCore is a deterministic structured memory substrate. It stores all world state explicitly in containers and modifies that state through atomic, replayable transactions. Enumerate containers with owner/kind filters and pagination to plan read queries.

Details

Calls /v1/read/namespaces/{namespace_id}/containers with optional owner (u32), kind (balance|grid|slots|continuous_line_1d|continuous_grid_2d), cursor (last seen container id), and limit (default 20, max 200). Values above max are clamped to the maximum. Returns limit/next_cursor/has_more plus containers[] entries (container_id, kind Balance{quantization_inv}|Grid{capacity,grid_width?}|Slots{count}|ContinuousLine1d{min_x,max_x,quantization_inv,bucket_cell_size?}|ContinuousGrid2d{min_x,min_y,max_x,max_y,quantization_inv,bucket_cell_size?}, owner?, display_name?) alongside freshness and correlation identifiers. Use next_cursor as the cursor parameter to request the next page.

Protocols

MCP
OpenAI
Gemini

Input Schema

{
  "properties": {
    "cursor": {
      "description": "Cursor anchored to the last seen container identifier.",
      "maxLength": 128,
      "minLength": 1,
      "pattern": "^[A-Za-z0-9._~\\-]+$",
      "type": "string"
    },
    "kind": {
      "description": "Filter by container kind (balance|grid|slots|continuous_line_1d|continuous_grid_2d)",
      "enum": [
        "balance",
        "grid",
        "slots",
        "continuous_line_1d",
        "continuous_grid_2d"
      ],
      "type": "string"
    },
    "limit": {
      "default": 20,
      "description": "Maximum number of containers 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": "Filter containers by owner identifier.",
      "maxLength": 128,
      "minLength": 1,
      "pattern": "^[A-Za-z0-9._~\\-]+$",
      "type": "string"
    }
  },
  "required": [
    "namespace_id"
  ],
  "type": "object"
}

Examples

No examples are currently available for this tool.