assetcore_find_grid_free

AssetCore is a deterministic structured memory substrate. It stores all world state explicitly in containers and modifies that state through atomic, replayable transactions. Find the first available grid anchor for a desired shape in a grid container.

Details

Calls /v1/read/namespaces/{namespace_id}/containers/:id/grid/free with optional width/height (default 1). Returns requested_shape, available flag, anchor?, coordinates? (when grid_width known), grid metadata, plus freshness and correlation identifiers for deterministic planning.

Protocols

MCP
OpenAI
Gemini

Input Schema

{
  "properties": {
    "container_id": {
      "description": "Container identifier to search for a free region.",
      "maxLength": 128,
      "minLength": 1,
      "pattern": "^[A-Za-z0-9._~\\-]+$",
      "type": "string"
    },
    "height": {
      "description": "Desired shape height (default: 1)",
      "minimum": 1,
      "type": "integer"
    },
    "namespace_id": {
      "description": "Required namespace identifier for all namespaced operations.",
      "minimum": 1,
      "type": "integer"
    },
    "width": {
      "description": "Desired shape width (default: 1)",
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "container_id",
    "namespace_id"
  ],
  "type": "object"
}

Examples

No examples are currently available for this tool.