Calera Infinite Context (ICX) — Persistent Memory & Associative Recall

{
  "type": "object",
  "required": [
    "principal_email",
    "accept_a2b_terms"
  ],
  "properties": {
    "agent_name": {
      "type": "string",
      "description": "Identifier for the calling agent (e.g. 'Claude-Code', 'Cursor-Worker', 'DeepResearch-Agent'). Defaults to 'Autonomous-Agent'."
    },
    "principal_email": {
      "type": "string",
      "description": "Human principal or developer email to anchor account and sub-license contract to."
    },
    "accept_a2b_terms": {
      "type": "boolean",
      "description": "Must be true to accept Calera A2B Free Developer Sub-License terms (https://icx.caleralabs.com/legal/a2b-tos.json)."
    }
  }
}

{
  "type": "object",
  "required": [
    "surface",
    "action",
    "payload"
  ],
  "properties": {
    "action": {
      "type": "string",
      "description": "Operation (e.g. 'post_message', 'create_issue', 'update_ticket')."
    },
    "payload": {
      "type": "object",
      "properties": {},
      "description": "JSON action payload with surface parameters."
    },
    "surface": {
      "type": "string",
      "description": "Target tool: 'github', 'gitlab', 'slack', 'jira', 'linear', 'notion', 'postgres', 'icx_memory'."
    }
  }
}

{
  "type": "object",
  "required": [
    "code"
  ],
  "properties": {
    "code": {
      "type": "string",
      "description": "The Python script to execute. Standard libraries and the pre-injected 'icx' client are available. Use print() to emit the final bounded result."
    },
    "space_id": {
      "type": "string",
      "description": "Optional memory space partition to execute within (e.g. 'default', 'sec_filings_2026'). Defaults to 'default'."
    },
    "timeout_ms": {
      "type": "number",
      "description": "Optional execution timeout in milliseconds (default: 3000ms, max: 5000ms)."
    }
  }
}

{
  "type": "object",
  "required": [
    "resource_id"
  ],
  "properties": {
    "type": {
      "type": "string",
      "description": "Optional connector source type: 'gdrive', 'notion', 'github', 'gitlab', or 'linear' (used when connector_id is omitted)."
    },
    "resource_id": {
      "type": "string",
      "description": "The file path (GitHub/GitLab), page UUID (Notion), issue key/ID (Linear), or file ID (Google Drive)."
    },
    "connector_id": {
      "type": "string",
      "description": "Optional specific connector ID. If omitted, the first active matching connector will be used."
    }
  }
}

{
  "type": "object",
  "required": [
    "connector_id"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "description": "Optional maximum number of facts to return (default: 50, max: 200)."
    },
    "connector_id": {
      "type": "string",
      "description": "The connector ID or source ID to inspect."
    }
  }
}

{
  "type": "object",
  "required": [],
  "properties": {
    "space_id": {
      "type": "string",
      "description": "Optional memory space partition to inspect. Defaults to caller default space ('default')."
    }
  }
}

{
  "type": "object",
  "required": [],
  "properties": {}
}

{
  "type": "object",
  "required": [],
  "properties": {
    "max_hops": {
      "type": "number",
      "description": "Maximum traversal depth (default: 5 hops, max: 20)."
    },
    "space_id": {
      "type": "string",
      "description": "Optional memory space partition to walk within (default: 'default')."
    },
    "root_entity": {
      "type": "string",
      "description": "Alias for start_entity."
    },
    "start_entity": {
      "type": "string",
      "description": "The root or starting entity identifier (e.g. 'Project Aurora', 'Contract_Jan10'). Alias: root_entity."
    },
    "target_entity": {
      "type": "string",
      "description": "Optional terminal target entity identifier or relation to reach. If omitted, traverses to the leaf fact."
    },
    "target_relation": {
      "type": "string",
      "description": "Alias for target_entity."
    }
  }
}

{
  "type": "object",
  "required": [
    "source_id"
  ],
  "properties": {
    "space_id": {
      "type": "string",
      "description": "Optional memory space partition. Defaults to 'default'."
    },
    "source_id": {
      "type": "string",
      "description": "The source_id or connector_id whose facts should be instantly purged from tenant memory."
    }
  }
}

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Natural language question, concept, or search prompt to recall relevant facts for."
    },
    "top_k": {
      "type": "number",
      "description": "Maximum number of grounded facts to retrieve (default: 10, min: 1, max: 50)."
    },
    "space_id": {
      "type": "string",
      "description": "Optional memory space partition to restrict recall to (e.g. 'default', 'codebase_docs'). Defaults to caller default space."
    }
  }
}

{
  "type": "object",
  "required": [
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "description": "The raw text, markdown document, code file, or factual statement to memorize (max ~500KB per call)."
    },
    "family": {
      "type": "string",
      "description": "Optional document family grouping for deterministic verbatim register quoting (e.g. 'contract.indemnity', 'auth.tokens'). When set, allows verbatim retrieval via icx_quote_slot."
    },
    "filename": {
      "type": "string",
      "description": "Optional filename or document title provenance tag (e.g. 'architecture.md', 'master_agreement.pdf') to track document origin."
    },
    "space_id": {
      "type": "string",
      "description": "Optional memory space partition (e.g. 'default', 'codebase_docs', 'contracts_v2', 'user_preferences'). Defaults to 'default'."
    }
  }
}

{
  "type": "object",
  "required": [],
  "properties": {
    "space_id": {
      "type": "string",
      "description": "Optional memory space partition whose ephemeral session dialogue history should be reset. Defaults to caller default space."
    }
  }
}

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "description": "Maximum number of node matches to return (default: 20, min: 1, max: 100)."
    },
    "query": {
      "type": "string",
      "description": "Search keywords, entity names, or token substrings to look up across memory nodes."
    },
    "space_id": {
      "type": "string",
      "description": "Optional memory space partition to search within. Defaults to caller default space."
    }
  }
}

{
  "type": "object",
  "required": [
    "operation"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "Variable or lock resource key (required for get, set, swap, delete, lock operations)."
    },
    "value": {
      "type": "string",
      "description": "Value payload to store (for set or swap operations; can be JSON string or text)."
    },
    "agent_id": {
      "type": "string",
      "description": "Agent identifier for provenance tracking and lease ownership (e.g. 'agent_architect')."
    },
    "space_id": {
      "type": "string",
      "description": "Optional memory space partition (default: 'default')."
    },
    "operation": {
      "type": "string",
      "description": "The operation to perform: 'get', 'set', 'swap', 'list', 'delete', 'acquire_lock', 'release_lock'."
    },
    "expected_version": {
      "type": "number",
      "description": "Expected version integer for atomic Compare-And-Swap ('swap' operation)."
    }
  }
}

{
  "type": "object",
  "required": [],
  "properties": {}
}

{
  "type": "object",
  "required": [
    "new_text"
  ],
  "properties": {
    "uri": {
      "type": "string",
      "description": "Document or file URI identifier (e.g. 'src/backend/engine.go', 'docs/rfc_42.md')."
    },
    "new_text": {
      "type": "string",
      "description": "New updated text/code/document state after modifications. Leave empty for document deletions."
    },
    "old_text": {
      "type": "string",
      "description": "Previous text/code/document state before modifications. Leave empty for new document additions."
    },
    "space_id": {
      "type": "string",
      "description": "Optional memory space partition. Defaults to 'default'."
    },
    "source_id": {
      "type": "string",
      "description": "Optional connector or source identifier tracking provenance for instant purge (e.g. 'github_core', 'cli_watch'). Defaults to 'mcp_sync'."
    }
  }
}

{
  "type": "object",
  "required": [
    "connector_id"
  ],
  "properties": {
    "connector_id": {
      "type": "string",
      "description": "The unique identifier of the connector to synchronize."
    }
  }
}

{
  "type": "object",
  "required": [
    "key"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "The variable key to retrieve."
    },
    "space_id": {
      "type": "string",
      "description": "Optional memory space partition (default: 'default')."
    }
  }
}

{
  "type": "object",
  "required": [],
  "properties": {
    "prefix": {
      "type": "string",
      "description": "Optional prefix to filter variable keys by (e.g. 'ast_', 'report_')."
    },
    "space_id": {
      "type": "string",
      "description": "Optional memory space partition (default: 'default')."
    }
  }
}

{
  "type": "object",
  "required": [
    "key",
    "value"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "The unique variable identifier in the swarm space."
    },
    "type": {
      "type": "string",
      "description": "Optional variable type: 'string', 'json', 'ast', 'diff', 'report', 'binary' (default: 'json')."
    },
    "value": {
      "type": "string",
      "description": "The value payload to store (string, JSON, or code snippet)."
    },
    "agent_id": {
      "type": "string",
      "description": "Optional agent identifier (e.g. 'cursor', 'claude_desktop')."
    },
    "space_id": {
      "type": "string",
      "description": "Optional memory space partition (default: 'default')."
    },
    "ttl_seconds": {
      "type": "number",
      "description": "Optional Time-To-Live in seconds (default: 86400 = 24h, 0 = permanent)."
    }
  }
}

{
  "type": "object",
  "required": [
    "code"
  ],
  "properties": {
    "code": {
      "type": "string",
      "description": "The WASM bytecode (base64 or binary string), WAT text, or in-process ICX script to execute."
    },
    "space_id": {
      "type": "string",
      "description": "Optional memory space partition to execute within (default: 'default')."
    },
    "timeout_ms": {
      "type": "number",
      "description": "Optional execution timeout in milliseconds (default: 50ms, max: 500ms)."
    }
  }
}

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "depth": {
      "type": "number",
      "description": "Optional Voronoi hop depth (1-5, default: 2)."
    },
    "query": {
      "type": "string",
      "description": "Query across connected tools and memory."
    },
    "format": {
      "type": "string",
      "description": "Optional output format: 'standard' (default) or 'ribbon' (1D Geodesic Ribbon)."
    },
    "space_id": {
      "type": "string",
      "description": "Optional memory space partition."
    }
  }
}

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "pair": {
      "type": "string",
      "description": "Optional CPA pair: '2tim_numbers', 'gal_exodus', 'rom_leviticus', '1pet_1enoch'."
    },
    "query": {
      "type": "string",
      "description": "Natural language research question or alignment query (e.g. 'Run CPA between Numbers and 2 Timothy', 'Explain Binyan Av in Matthew 2:23', 'Fold Psalm 23')."
    },
    "action": {
      "type": "string",
      "description": "Optional action: 'cpa', 'middot', 'fold', 'witness', 'firewall', 'ask'."
    }
  }
}